SetLayout 関数 (wingdi.h)

  • [アーティクル]

SetLayout 関数は、デバイス コンテキスト (DC) のレイアウトを変更します。

構文

DWORD SetLayout(
  [in] HDC   hdc,
  [in] DWORD l
);

パラメーター

[in] hdc

DC へのハンドル。

[in] l

DC レイアウト。 このパラメーターには、次の 1 つ以上の値を指定できます。

値 意味
LAYOUT_BITMAPORIENTATIONPRESERVED
 BitBlt および StretchBlt 操作中にリフレクションを無効にします。
LAYOUT_RTL
 既定の水平レイアウトを右から左に設定します。

戻り値

関数が成功すると、DC の前のレイアウトが返されます。

関数が失敗した場合は、GDI_ERRORを返します。

注釈

レイアウトは、ウィンドウまたはデバイス コンテキストでテキストとグラフィックスを表示する順序を指定します。 既定値は左から右です。 SetLayout 関数は、これを右から左に変更します。これは、アラビア語とヘブライ語のカルチャの標準です。

LAYOUT_RTL フラグを選択すると、通常は右または左を指定するフラグが反転します。 混乱を避けるために、次の表のような標準フラグの代替単語を定義することを検討してください。

標準フラグ 推奨される代替名
WS_EX_RIGHT WS_EX_TRAILING
WS_EX_RTLREADING WS_EX_REVERSEREADING
WS_EX_LEFTSCROLLBAR WS_EX_LEADSCROLLBAR
ES_LEFT ES_LEAD
ES_RIGHT ES_TRAIL
EC_LEFTMARGIN EC_LEADMARGIN
EC_RIGHTMARGIN EC_TRAILMARGIN
 

SetLayout では、DIB のビットに直接描画を変更することはできません。

詳細については、「ウィンドウ の機能」の「ウィンドウ レイアウトとミラーリング」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wingdi.h (Windows.h を含む)
Library Gdi32.lib
[DLL] Gdi32.dll

こちらもご覧ください

デバイス コンテキスト関数

デバイス コンテキストの概要

GetLayout