Función SetViewportOrgEx (wingdi.h)

Artículo
08/07/2024

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

Sintaxis

BOOL SetViewportOrgEx(
  [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 de dispositivo, del nuevo origen de la ventanilla.

[in] y

Coordenada y, en unidades de dispositivo, del nuevo origen de ventanilla.

[out] lppt

Puntero a una estructura POINT que recibe el origen de la ventanilla anterior, en coordenadas del dispositivo. 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

Esta función (junto con SetViewportExtEx y SetWindowExtEx) ayuda a definir la asignación desde el espacio de coordenadas lógico (también conocido como ventana) al espacio de coordenadas del dispositivo (la ventanilla). SetViewportOrgEx especifica qué punto de dispositivo se asigna al punto lógico (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 (0,0) to the device point (xViewOrg, yViewOrg) 
SetViewportOrgEx ( hdc, xViewOrg, yViewOrg, NULL)

Esto está relacionado con la función SetWindowOrgEx . 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.

Ejemplos

Para obtener un ejemplo, vea Volver a dibujar en la región de actualización.

Requisitos


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