<Return[S]><Top>

SetLayout

Declare Function Api_SetLayout& Lib "gdi32" Alias "SetLayout" (ByVal hDC&, ByVal dwLayout&)

Declare Function SetLayout Lib "gdi32" (ByVal hdc As Long, ByVal dwLayout As Long) As Long

デバイスコンテキスト(DC)のレイアウトを変更する。

パラメータ
hdc
    デバイスコンテキストのハンドルを指定する。
dwLayout
    デバイスコンテキストのレイアウトフラグを指定する。次の値を組み合わせて使う。

    値                                                                         

意味                                                                                             

    LAYOUT_BITMAPORIENTATIONPRESERVED

BitBlt 関数と StretchBlt 関数でミラーイメージを作成しないようにする。

    LAYOUT_RTL

既定の水平方向レイアウトを「右から左」に設定する。


戻り値
    関数が成功すると、デバイスコンテキストの変更前のレイアウトが返る。
    関数が失敗すると、GDI_ERROR が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。

解説
    レイアウトは、テキストとグラフィックの配置方法を指定する。

    既定値は、「左から右」である。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