GetTextAlign 関数 (wingdi.h)
GetTextAlign 関数は、指定されたデバイス コンテキストのテキスト配置設定を取得します。
構文
UINT GetTextAlign(
[in] HDC hdc
);
パラメーター
[in] hdc
デバイス コンテキストへのハンドル。
戻り値
関数が成功した場合、戻り値はテキスト配置フラグの状態になります。 戻り値の詳細については、「解説」セクションを参照してください。 戻り値は、次の値の組み合わせです。
値 | 意味 |
---|---|
TA_BASELINE | 参照ポイントは、テキストの基準線上にあります。 |
TA_BOTTOM | 参照ポイントは、外接する四角形の下端にあります。 |
TA_TOP | 参照ポイントは、外接する四角形の上端にあります。 |
TA_CENTER | 基準点は、外接する四角形の中心に水平方向に配置されます。 |
TA_LEFT | 参照ポイントは、外接する四角形の左端にあります。 |
TA_RIGHT | 参照ポイントは、外接する四角形の右端にあります。 |
TA_RTLREADING | Windows の中東言語エディション: テキストは、既定の左から右の順序ではなく、右から左の読み取り順序でレイアウトされます。 これは、デバイス コンテキストで選択されたフォントがヘブライ語またはアラビア語である場合にのみ適用されます。 |
TA_NOUPDATECP | 現在の位置は、各テキスト出力呼び出しの後に更新されません。 |
TA_UPDATECP | 現在の位置は、各テキスト出力呼び出しの後に更新されます。 |
現在のフォントに (漢字と同様に) 垂直の既定の基本行がある場合は、TA_BASELINEとTA_CENTERの代わりに次の値が使用されます。
値 | 意味 |
---|---|
VTA_BASELINE | 参照ポイントは、テキストの基準線上にあります。 |
VTA_CENTER | 基準点は、外接する四角形の中心に垂直に配置されます。 |
関数が失敗した場合、戻り値はGDI_ERROR。
注釈
外接する四角形は、文字列内のすべての文字セルを囲む四角形です。 そのディメンションは、 GetTextExtentPoint32 関数を呼び出すことによって取得できます。
text-alignment フラグは、TextOut 関数と ExtTextOut 関数が、TextOut または ExtTextOut に提供される文字列の参照ポイントに関連して文字列を配置する方法を決定します。
テキストアラインメントフラグは必ずしも単一ビットフラグではなく、0 に等しい場合があります。 フラグは、次の一覧に示すように、関連するフラグのグループで調べる必要があります。
- TA_LEFT、TA_RIGHT、およびTA_CENTER
- TA_BOTTOM、TA_TOP、TA_BASELINE
- TA_NOUPDATECPとTA_UPDATECP
- TA_LEFT、TA_RIGHT、VTA_BASELINE
- TA_BOTTOM、TA_TOP、およびVTA_CENTER
- TA_NOUPDATECPとTA_UPDATECP
この関数の戻り値に特定のフラグが設定されていることを確認するには、
- ビットごとの OR 演算子をフラグとそれに関連するフラグに適用します。
- 結果と戻り値にビットごとの AND 演算子を適用します。
- この結果と フラグの等価性をテストします。
例
例については、「 テキストの配置の設定」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | wingdi.h (Windows.h を含む) |
Library | Gdi32.lib |
[DLL] | Gdi32.dll |