Funzione SetViewportOrgEx (wingdi.h)

Articolo
08/27/2023

La funzione SetViewportOrgEx specifica il punto di dispositivo mappato all'origine della finestra (0,0).

Sintassi

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

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] x

Coordinata x, in unità di dispositivo, della nuova origine del riquadro di visualizzazione.

[in] y

Coordinata y, in unità di dispositivo, della nuova origine del riquadro di visualizzazione.

[out] lppt

Puntatore a una struttura POINT che riceve l'origine del riquadro di visualizzazione precedente, nelle coordinate del dispositivo. Se lpPoint è 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

Questa funzione (insieme a SetViewportExtEx e SetWindowExtEx) consente di definire il mapping dallo spazio delle coordinate logiche (noto anche come finestra) allo spazio delle coordinate del dispositivo (il viewport). SetViewportOrgEx specifica il punto del dispositivo mappato al punto logico (0,0). Ha l'effetto di spostare gli assi in modo che il punto logico (0,0) non faccia più riferimento all'angolo superiore sinistro.


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

Questo è correlato alla funzione SetWindowOrgEx . In genere, si userà una funzione o l'altra, ma non entrambe. Indipendentemente dall'uso di SetWindowOrgEx e SetViewportOrgEx, il punto del dispositivo (0,0) è sempre l'angolo superiore sinistro.

Esempio

Per un esempio, vedere Ridisegno nell'area di aggiornamento.

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