SetGraphicsMode 関数 (wingdi.h)

[アーティクル]
03/04/2024

SetGraphicsMode 関数は、指定したデバイスコンテキストのグラフィックスモードを設定します。

構文

int SetGraphicsMode(
  [in] HDC hdc,
  [in] int iMode
);

パラメーター

[in] hdc

デバイスコンテキストへのハンドル。

[in] iMode

グラフィックスモード。このパラメーターには、次の値のいずれかを指定できます。

値	意味
GM_COMPATIBLE	16 ビット Windows と互換性のあるグラフィックスモードを設定します。これは既定のモードです。この値を指定した場合、アプリケーションは、ウィンドウとビューポートのエクステントと原点を設定する関数を呼び出すことによってのみ、ワールドからデバイスへの変換を変更できますが、 SetWorldTransform または ModifyWorldTransform を使用することはできません。これらの関数の呼び出しは失敗します。ウィンドウとビューポートのエクステントと原点を設定する関数の例として、SetViewportExtEx と SetWindowExtEx があります。
GM_ADVANCED	ワールド変換を可能にする高度なグラフィックスモードを設定します。アプリケーションが指定したデバイスコンテキストのワールド変換を設定または変更する場合は、この値を指定する必要があります。このモードでは、テキスト出力を含むすべてのグラフィックスが、デバイスコンテキストで指定されたワールドからデバイスへの変換に完全に準拠します。

値

意味

GM_COMPATIBLE

16 ビット Windows と互換性のあるグラフィックスモードを設定します。これは既定のモードです。この値を指定した場合、アプリケーションは、ウィンドウとビューポートのエクステントと原点を設定する関数を呼び出すことによってのみ、ワールドからデバイスへの変換を変更できますが、 SetWorldTransform または ModifyWorldTransform を使用することはできません。これらの関数の呼び出しは失敗します。ウィンドウとビューポートのエクステントと原点を設定する関数の例として、SetViewportExtEx と SetWindowExtEx があります。

GM_ADVANCED

ワールド変換を可能にする高度なグラフィックスモードを設定します。アプリケーションが指定したデバイスコンテキストのワールド変換を設定または変更する場合は、この値を指定する必要があります。このモードでは、テキスト出力を含むすべてのグラフィックスが、デバイスコンテキストで指定されたワールドからデバイスへの変換に完全に準拠します。

戻り値

関数が成功した場合、戻り値は古いグラフィックスモードです。

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

注釈

グラフィックスの出力は、グラフィックスモードによって異なる 3 つの領域があります。

テキスト出力: GM_COMPATIBLE モードでは、TrueType (またはベクターフォント) のテキスト出力は、DC のワールドツーデバイス変換に関するラスターフォントテキスト出力とほぼ同じように動作します。 TrueType テキストは、残りのグラフィックスが x 軸または y 軸で反転される場合でも、常に左から右、右に書き込まれます。 TrueType (またはベクターフォント) テキストの高さのみが拡大縮小されます。 GM_COMPATIBLE モードで水平でないテキストを書き込む唯一の方法は、このデバイスコンテキストで選択されている論理フォントの 0 以外のエスケープメントと向きを指定することです。
GM_ADVANCED モードでは、TrueType (またはベクターフォント) のテキスト出力は、デバイスコンテキストでのワールドツーデバイス変換に完全に準拠します。ラスターフォントの変換機能は非常に限られています (一部の整数要素によるストレッチ)。グラフィックスデバイスインターフェイス (GDI) は、非Trivial 変換用のラスターフォントで可能な限り最高の出力を生成しようとします。
四角形の除外: 既定のGM_COMPATIBLE グラフィックスモードが設定されている場合、四角形を描画するときに、システムによって下端と右端が除外されます。
アプリケーションで右下の四角形を描画する場合は、GM_ADVANCED グラフィックスモードが必要です。
円弧描画: 既定のGM_COMPATIBLE グラフィックスモードが設定されている場合、GDI はデバイス空間で現在の円弧の方向を使用して円弧を描画します。この規則では、円弧は x 軸または y 軸に沿った反転を必要とするページ間変換を考慮しません。
GM_ADVANCED グラフィックスモードが設定されている場合、GDI は常に、論理空間の反時計回りの方向に円弧を描画します。これは、GM_ADVANCED グラフィックスモードでは、円弧コントロールポイントと円弧自体の両方が、デバイスコンテキストのワールドツーデバイス変換を完全に尊重するステートメントと同じです。

例

例については、「座標空間と変換の使用」を参照してください。

要件

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