SetViewportOrgEx 関数 (wingdi.h)

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

構文

BOOL SetViewportOrgEx(
  [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 を返します。

解説

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

//map the logical point (0,0) to the device point (xViewOrg, yViewOrg) 
SetViewportOrgEx ( hdc, xViewOrg, yViewOrg, NULL)

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

例

例については、「 更新リージョンでの再描画」を参照してください。

要件

関連項目

座標空間と変換関数

座標スペースと変換の概要

GetViewportOrgEx

ポイント

SetWindowOrgEx