SetTextAlign 関数 (wingdi.h)
SetTextAlign 関数は、指定したデバイス コンテキストのテキスト配置フラグを設定します。
構文
UINT SetTextAlign(
[in] HDC hdc,
[in] UINT align
);
パラメーター
[in] hdc
デバイス コンテキストへのハンドル。
[in] align
次の一覧の値のマスクを使用したテキストの配置。 水平方向と垂直方向の配置に影響を与えるフラグは 1 つだけ選択できます。 さらに、現在の位置を変更する 2 つのフラグのうちの 1 つだけを選択できます。
現在のフォントに漢字と同様に、既定の縦線がある場合は、TA_BASELINEとTA_CENTERの代わりに次の値を使用する必要があります。
| 値 | 説明 |
|---|---|
|
参照ポイントは、テキストの基準行に配置されます。 |
|
基準点は、外接する四角形の中心に垂直方向に配置されます。 |
既定値は、TA_LEFT、TA_TOP、TA_NOUPDATECPです。
戻り値
関数が成功した場合、戻り値は前のテキスト配置設定です。
関数が失敗した場合、戻り値はGDI_ERROR。
解説
TextOut 関数と ExtTextOut 関数は、テキスト配置フラグを使用して、テキストの文字列をディスプレイまたはその他のデバイスに配置します。 フラグは、参照ポイントとテキストをバインドする四角形の間のリレーションシップを指定します。 参照ポイントは、現在の位置またはテキスト出力関数に渡されるポイントです。
テキストを囲む四角形は、テキスト文字列内の文字セルによって形成されます。
左揃えのテキストを取得する最善の方法は、次のいずれかを使用することです
SetTextAlign (hdc, GetTextAlign(hdc) & (~TA_CENTER))
or
SetTextAlign (hdc,TA_LEFT | <other flags>)
この目的で SetTextAlign (hdc、TA_LEFT) を使用することもできますが、垂直方向または右から左への設定は失われます。
メモ選択したテキストが正しくレンダリングされないため、ScriptStringOut を使用している場合は、SetTextAlign を TA_UPDATECPと共に使用しないでください。 このフラグを使用する必要がある場合は、問題を回避するために、必要に応じて設定を解除してリセットできます。
例
例については、「 テキストの配置の設定」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |