<Return[S]><Top>

ScaleViewportExtEx

Declare Function Api_ScaleViewportExtEx& Lib "gdi32" Alias "ScaleViewportExtEx" (ByVal hDC&, ByVal nXnum&, ByVal nXdenom&, ByVal nYnum&, ByVal nYdenom&, lpSize As SIZE)

Declare Function ScaleViewportExtEx Lib "gdi32" Alias "ScaleViewportExtEx" (ByVal hdc As Long, ByVal nXnum As Long, ByVal nXdenom As Long, ByVal nYnum As Long, ByVal nYdenom As Long, lpSize As SIZE) As Long

指定された乗数と除数を使って、デバイスコンテキストのビューポート範囲を変更する。

パラメータ
hdc
    デバイスコンテキストのハンドルを指定する。
Xnum
    現在の水平方向の範囲にかける値(乗数)を指定する。
Xdenom
    現在の水平方向の範囲を割る値(除数)を指定する。
Ynum
    現在の垂直方向の範囲にかける値(乗数)を指定する。
Ydenom
    現在の垂直方向の範囲を割る値(除数)を指定する。
lpSize
    1 個の SIZE 構造体へのポインタを指定する。関数から制御が返ると、この構造体に、以前のビューポート範囲がデバイス単位で格納され

    ます。NULL を指定すると、以前のビューポート範囲は返されない。
 

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。
    Windows NT/2000:拡張エラー情報を取得するには、 関数を使う。

解説
    次の式に基づいて、ビューポート範囲が変更される。VE は、ビューポート範囲(Viewport Extent)の略称である。
    xNewVE = (xOldVE * Xnum) / Xdenom
    yNewVE = (yOldVE * Ynum) / Ydenom