SetWindowOrgEx 関数 (wingdi.h)

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

SetWindowOrgEx 関数は、ビューポートの原点 (0,0) にマップされるウィンドウポイントを指定します。

構文

BOOL SetWindowOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

パラメーター

[in] hdc

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

[in] x

新しいウィンドウの原点の x 座標 (論理単位)。

[in] y

新しいウィンドウの原点の y 座標 (論理単位)。

[out] lppt

ウィンドウの以前の原点を論理単位で受け取る POINT 構造体へのポインター。 lpPoint が NULL の場合、このパラメーターは使用されません。

戻り値

関数が成功すると、戻り値は 0 以外になります。

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

注釈

これは、論理座標空間 ( ウィンドウとも呼ばれます) からデバイス座標空間 ( ビューポート) へのマッピングを定義するのに役立ちます。 SetWindowOrgEx は、デバイスポイント (0,0) にマップされる論理ポイントを指定します。これは、論理ポイント (0,0) が左上隅を参照しなくなったように軸をシフトする効果があります。


//map the logical point (xWinOrg, yWinOrg) to the device point (0,0) 
SetWindowOrgEx (hdc, xWinOrg, yWinOrg, NULL)

これは、SetViewportOrgEx 関数に関連しています。一般に、1 つの関数またはもう 1 つの関数を使用しますが、両方は使用しません。 SetWindowOrgEx と SetViewportOrgEx の使用に関係なく、デバイスポイント (0,0) は常に左上隅です。

要件

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