Función SetViewportExtEx (wingdi.h)

Artículo
03/08/2023

La función SetViewportExtEx establece las extensiones horizontales y verticales de la ventanilla de un contexto de dispositivo mediante los valores especificados.

Sintaxis

BOOL SetViewportExtEx(
  [in]  HDC    hdc,
  [in]  int    x,
  [in]  int    y,
  [out] LPSIZE lpsz
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] x

Extensión horizontal, en unidades de dispositivo, de la ventanilla.

[in] y

Extensión vertical, en unidades de dispositivo, de la ventanilla.

[out] lpsz

Puntero a una estructura SIZE que recibe las extensiones de ventanilla anteriores, en unidades de dispositivo. Si lpSize 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

La ventanilla hace referencia al sistema de coordenadas del dispositivo del espacio del dispositivo. La extensión es el valor máximo de un eje. Esta función establece los valores máximos de los ejes horizontales y verticales de la ventanilla en coordenadas del dispositivo (o píxeles). Al asignar entre el espacio de página y el espacio del dispositivo, SetWindowExtEx y SetViewportEx determinan el factor de escala entre la ventana y la ventanilla. Para obtener más información, vea Transformación de espacios de coordenadas.

Cuando se establecen los siguientes modos de asignación, se omiten las llamadas a las funciones SetWindowExtEx y SetViewportEx .

MM_HIENGLISH
MM_HIMETRIC
MM_LOENGLISH
MM_LOMETRIC
MM_TEXT
MM_TWIPS

Cuando se establece MM_ISOTROPIC modo, una aplicación debe llamar a la función SetWindowExtEx antes de llamar a SetViewportExtEx. Tenga en cuenta que, para el modo de MM_ISOTROPIC, es posible que ciertas partes de una pantalla que no sea dequare no estén disponibles para mostrarse porque las unidades lógicas de ambos ejes representan distancias físicas iguales.

Ejemplos

Para obtener un ejemplo, consulte Invalidación del área de cliente.

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