Función SetWindowOrgEx (wingdi.h)

Artículo
03/04/2024

La función SetWindowOrgEx especifica qué punto de ventana se asigna al origen de la ventanilla (0,0).

Sintaxis

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

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] x

Coordenada x, en unidades lógicas, del nuevo origen de la ventana.

[in] y

Coordenada y, en unidades lógicas, del nuevo origen de la ventana.

[out] lppt

Puntero a una estructura POINT que recibe el origen anterior de la ventana, en unidades lógicas. Si lpPoint es NULL, este parámetro no se usa.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Esto ayuda a definir la asignación del espacio de coordenadas lógico (también conocido como ventana) al espacio de coordenadas del dispositivo (la ventanilla). SetWindowOrgEx especifica qué punto lógico se asigna al punto de dispositivo (0,0). Tiene el efecto de desplazar los ejes para que el punto lógico (0,0) ya no haga referencia a la esquina superior izquierda.


//map the logical point (xWinOrg, yWinOrg) to the device point (0,0) 
SetWindowOrgEx (hdc, xWinOrg, yWinOrg, NULL)

Esto está relacionado con la función SetViewportOrgEx . Por lo general, usará una función u otra, pero no ambas. Independientemente del uso de SetWindowOrgEx y SetViewportOrgEx, el punto de dispositivo (0,0) siempre es la esquina superior izquierda.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll