Função SetViewportExtEx (wingdi.h)

Artigo
03/08/2023

A função SetViewportExtExtEx define as extensões horizontais e verticais do visor para um contexto de dispositivo usando os valores especificados.

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] x

A extensão horizontal, em unidades de dispositivo, do visor.

[in] y

A extensão vertical, em unidades de dispositivo, do visor.

[out] lpsz

Um ponteiro para uma estrutura SIZE que recebe as extensões anteriores do visor, em unidades de dispositivo. Se lpSize for NULL, esse parâmetro não será usado.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

O visor refere-se ao sistema de coordenadas do dispositivo do espaço do dispositivo. A extensão é o valor máximo de um eixo. Essa função define os valores máximos para os eixos horizontal e vertical do visor em coordenadas do dispositivo (ou pixels). Ao mapear entre o espaço de página e o espaço do dispositivo, SetWindowExtEx e SetViewportExtEx determinam o fator de dimensionamento entre a janela e o visor. Para obter mais informações, consulte Transformação de espaços de coordenadas.

Quando os modos de mapeamento a seguir são definidos, as chamadas para as funções SetWindowExtEx eSetViewportExtEx são ignoradas.

MM_HIENGLISH
MM_HIMETRIC
MM_LOENGLISH
MM_LOMETRIC
MM_TEXT
MM_TWIPS

Quando MM_ISOTROPIC modo é definido, um aplicativo deve chamar a função SetWindowExtEx antes de chamar SetViewportExtEx. Observe que, para o modo MM_ISOTROPIC determinadas partes de uma tela não secundária podem não estar disponíveis para exibição porque as unidades lógicas em ambos os eixos representam distâncias físicas iguais.

Exemplos

Para obter um exemplo, consulte Invalidando a área do cliente.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll