Funzione SetViewportExtEx (wingdi.h)

Articolo
08/27/2023

La funzione SetViewportExtEx imposta gli extent orizzontali e verticali del riquadro di visualizzazione per un contesto di dispositivo usando i valori specificati.

Sintassi

BOOL SetViewportExtEx(
  [in]  HDC    hdc,
  [in]  int    x,
  [in]  int    y,
  [out] LPSIZE lpsz
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] x

Estensione orizzontale, in unità di dispositivo, del riquadro di visualizzazione.

[in] y

Estensione verticale, in unità di dispositivo, del riquadro di visualizzazione.

[out] lpsz

Puntatore a una struttura SIZE che riceve gli extent del riquadro di visualizzazione precedenti, in unità dispositivo. Se lpSize è NULL, questo parametro non viene utilizzato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Il riquadro di visualizzazione fa riferimento al sistema di coordinate del dispositivo dello spazio del dispositivo. L'extent è il valore massimo di un asse. Questa funzione imposta i valori massimi per gli assi orizzontali e verticali del riquadro di visualizzazione nelle coordinate del dispositivo (o pixel). Quando si esegue il mapping tra lo spazio di pagina e lo spazio del dispositivo, SetWindowExtEx e SetViewportExtEx determinano il fattore di ridimensionamento tra la finestra e il viewport. Per altre informazioni, vedere Trasformazione degli spazi di coordinate.

Quando vengono impostate le modalità di mapping seguenti, le chiamate alle funzioni SetWindowExtEx e SetViewportExtEx vengono ignorate.

MM_HIENGLISH
MM_HIMETRIC
MM_LOENGLISH
MM_LOMETRIC
MM_TEXT
MM_TWIPS

Quando MM_ISOTROPIC modalità è impostata, un'applicazione deve chiamare la funzione SetWindowExtEx prima di chiamare SetViewportExtEx. Si noti che per la modalità MM_ISOTROPIC alcune parti di uno schermo non quadrato potrebbero non essere disponibili per la visualizzazione perché le unità logiche su entrambi gli assi rappresentano distanze fisiche uguali.

Esempio

Per un esempio, vedere Invalidamento dell'area client.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll