Funzione SetWindowOrgEx (wingdi.h)

Articolo
03/04/2024

La funzione SetWindowOrgEx specifica il punto di finestra mappato all'origine del riquadro di visualizzazione (0,0).

Sintassi

BOOL SetWindowOrgEx(
  [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à logiche, della nuova origine della finestra.

[in] y

Coordinata y, in unità logiche, della nuova origine finestra.

[out] lppt

Puntatore a una struttura POINT che riceve l'origine precedente della finestra, in unità logiche. 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

Ciò consente di definire il mapping dallo spazio delle coordinate logiche (noto anche come finestra) allo spazio delle coordinate del dispositivo (il viewport). SetWindowOrgEx specifica il punto logico mappato al punto del dispositivo (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 (xWinOrg, yWinOrg) to the device point (0,0) 
SetWindowOrgEx (hdc, xWinOrg, yWinOrg, NULL)

Ciò è correlato alla funzione SetViewportOrgEx . 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.

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