第５章 テキストの表示

void ShowMyText(HWND hWnd)
{
    HDC hdc;
    PAINTSTRUCT paint;
    char *str = "猫でもわかるプログラミング"; 

    hdc = BeginPaint(hWnd, &paint);
    TextOut(hdc, 10, 10, (LPCSTR)str, strlen(str));
    EndPaint(hWnd, &paint);
    return;
}

まず、文字とかイメージを描くときはその旨宣言？しなくてはいけません。 これが、BeginPaint関数です。この時戻り値として デバイスコンテキストハンドル が得られます。以後、文字を書いたり絵を描いたりするときはこのハンドルが 必要になります。また、この関数の２番目の引数のPAINTSTRUCT構造体について 少し説明します。これは、次のように定義されています。

typedef struct tagPAINTSTRUCT { // ps  
    HDC  hdc; 
    BOOL fErase; 
    RECT rcPaint; 
    BOOL fRestore; 
    BOOL fIncUpdate; 
    BYTE rgbReserved[32]; 
} PAINTSTRUCT;

BeginPaint関数を実行したならば必ずEndPaint関数を実行して下さい。 BeginPaint関数を書いたならばすぐ次の行にEndPaint関数を書いておいて 必要なものはこの２つの関数の間に挿入していくようにすれば 忘れることがありません。

テキストの表示はTextOut関数を使います。 最初の引数はデバイスコンテキストハンドル、次の２つが 書き始めるx,y座標、４番目が文字列のアドレス、５番目が文字数です。

最後にEndPaintを実行します。

ところで、TextOut関数では改行文字などは表現できません。 どうなるかやってみましょう。

void ShowMyText(HWND hWnd)
{
    HDC hdc;
    PAINTSTRUCT paint;
    LPCSTR str = "猫でもわかるプログラミング\n粂井康孝"; 

    hdc = BeginPaint(hWnd, &paint);
    TextOut(hdc, 10, 10, str, lstrlen(str));
    EndPaint(hWnd, &paint);
    return;
}

改行は表現されず黒い四角形が 現れました。

もうちょっと便利な関数にDrawText関数があります。 これは、改行も表現してくれます。 VC++4.2のヘルプでこの関数の引数などを見てみましょう。

int DrawText(
    HDC hDC,    // handle to device context 
    LPCTSTR lpString,    // pointer to string to draw 
    int nCount,    // string length, in characters 
    LPRECT lpRect,    // pointer to structure with formatting dimensions  
    UINT uFormat     // text-drawing flags 
   );

さて、次はRECT構造体ですが、これは非常に簡単です。

typedef struct _RECT {    // rc  
    LONG left; 
    LONG top; 
    LONG right; 
    LONG bottom; 
} RECT;

ついでにもう少しよく使う関数について説明します。 sprintfはMS-DOSのプログラムの時よく使いました。 WINDOWSのプログラムではこれに変わってwsprintfがよく使われます。 引数のデータ型が少し違うので注意して下さい。 入門書によってはsprintfの方は問題が起きることがあるので なるべく使わないようにと書いてあるものもあります。 でも、使っても差し支えありません。 （どうも言っていることが矛盾しているな）

int wsprintf(
    LPTSTR lpOut,    // pointer to buffer for output 
    LPCTSTR lpFmt,     // pointer to format-control string 
    ...    // optional arguments
   );

それと、表示するテキストの色を変えるのは SetTextColor関数で簡単に行うことができます。

COLORREF SetTextColor(
    HDC hdc,    // handle of device context  
    COLORREF crColor     // text color 
   );

void ShowMyText(HWND hWnd)
{
    HDC hdc;
    char *str_org = "left=%d top=%d right=%d bottom=%d";
    char strx[256];
    PAINTSTRUCT paint;
    RECT rt;
    LPCSTR str = "猫でもわかるプログラミング\n粂井康孝 制作\n"
        "わかりやすくてためになる！";
    
    GetClientRect(hWnd, &rt);
    wsprintf((LPSTR)strx, (LPCSTR)str_org, rt.left, rt.top, rt.right, rt.bottom); 
    rt.top += 40;
    rt.bottom -= 40;
    rt.right -= 40;
    rt.left += 40;
    hdc = BeginPaint(hWnd, &paint);
    SetTextColor(hdc, RGB(255, 0, 0));
    TextOut(hdc, 10, 10, (LPSTR)strx, strlen(strx));
    SetTextColor(hdc, RGB(0, 0, 255));
    DrawText(hdc, str, -1, &rt, DT_WORDBREAK);
    EndPaint(hWnd, &paint);
    return;
}

それでは、このプログラムを実行してみましょう。

改行文字もきちんと表現されています。 ウィンドウの大きさをいろいろに変えると 赤字で表示されている数値も変化します。 青字の周りは４０ドット以上あいています。

ウィンドウ幅を狭くするとTextOutで書いた 赤字の表示は切れてしまいますが、 DrawTextで書いた青字の表示はうまいこと折り返して います。青字の周りは４０ドットあいています。

テキストの表示に関する細かい指定は まだまだたくさんあります。必要が生じたら その都度説明します。