CDC::SetLayout

[アーティクル]
08/09/2011

デバイスコンテキストのテキストとグラフィックスを右から左へのレイアウトに変更します。このレイアウトは、アラビア語やヘブライ語文化圏での標準レイアウトです。

DWORD SetLayout(
   DWORD dwLayout 
);

パラメーター

dwLayout
デバイスコンテキストレイアウトとビットマップ制御フラグ。次の値を組み合わせて使用できます。

値	説明
LAYOUT_BITMAPORIENTATIONPRESERVED	CDC::BitBlt の呼び出しと CDC::StretchBlt の呼び出しによる移動を無効にします。
LAYOUT_RTL	水平レイアウトの既定値を右から左に設定します。
LAYOUT_LTR	レイアウトの既定値を左から右に設定します。

戻り値

処理が正常に終了した場合は、デバイスコンテキストの直前のレイアウトを返します。

失敗した場合は GDI_ERROR を返します。拡張エラー情報を取得するには、GetLastError を呼び出します。

解説

通常、ウィンドウに対して SetLayout は呼び出しません。代わりに、WS_EX_RTLREADING などの拡張ウィンドウスタイルを設定し、ウィンドウで右から左へのレイアウトを制御します。ただし、プリンターやメタファイルなどのデバイスコンテキストは、このレイアウトを継承しません。デバイスコンテキストに右から左へのレイアウトを設定する唯一の方法が SetLayout を呼び出すことです。

SetLayout (LAYOUT_RTL) は呼び出されると、自動的にマップモードを MM_ISOTROPIC に変更します。その結果、後に続く GetMapMode の呼び出しでは、MM_TEXT ではなく MM_ISOTROPIC が返されます。

多くのビットマップを使っている場合などでは、左から右へのレイアウトを保存する必要があるときもあります。左から右へのレイアウトを保存する必要があるときは、まず BitBlt または StretchBlt を呼び出してイメージを描画し、次にビットマップ制御フラグの dwLayout を LAYOUT_BITMAPORIENTATIONPRESERVED に設定します。

LAYOUT_RTL フラグを指定してレイアウトを変更すると、フラグで通常指定されているレイアウトの左右が反転します。誤りを防ぐために、標準のフラグに代替フラグ名を定義することもできます。推奨する代替フラグ名の一覧については、Windows SDK の「SetLayout」を参照してください。