Funzione SetWindowExtEx (wingdi.h)

Articolo
08/27/2023

La funzione SetWindowExtEx imposta gli extent orizzontali e verticali della finestra per un contesto di dispositivo usando i valori specificati.

Sintassi

BOOL SetWindowExtEx(
  [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 della finestra in unità logiche.

[in] y

Estensione verticale della finestra in unità logiche.

[out] lpsz

Puntatore a una struttura SIZE che riceve gli extent della finestra precedenti, in unità logiche. 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

La finestra fa riferimento al sistema di coordinate logico dello spazio di pagina. L'extent è il valore massimo di un asse. Questa funzione imposta i valori massimi per gli assi orizzontali e verticali della finestra (in coordinate logiche). Quando si esegue il mapping tra lo spazio di pagina e lo spazio del dispositivo, SetViewportExtEx e SetWindowExtEx 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 è impostata MM_ISOTROPIC modalità, 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

Requisito	Valore
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