Compartir a través de


Función SetViewportExtEx (wingdi.h)

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

Consulte también

Funciones de espacio y transformación de coordenadas

Información general sobre espacios y transformaciones de coordenadas

GetViewportExtEx

SIZE

SetWindowExtEx