Función SetWindowExtEx (wingdi.h)

Artículo
03/08/2023

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

Sintaxis

BOOL SetWindowExtEx(
  [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 de la ventana en unidades lógicas.

[in] y

Extensión vertical de la ventana en unidades lógicas.

[out] lpsz

Puntero a una estructura SIZE que recibe las extensiones de ventana anteriores, en unidades lógicas. 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 ventana hace referencia al sistema de coordenadas lógico del espacio de página. 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 ventana (en coordenadas lógicas). Al asignar entre el espacio de página y el espacio del dispositivo, SetViewportEx ySetWindowExtEx 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 algunas 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

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