Função SetWindowExtEx (wingdi.h)

Artigo
03/04/2024

A função SetWindowExtExtEx define as extensões horizontais e verticais da janela para um contexto de dispositivo usando os valores especificados.

Sintaxe

BOOL SetWindowExtEx(
  [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 da janela em unidades lógicas.

[in] y

A extensão vertical da janela em unidades lógicas.

[out] lpsz

Um ponteiro para uma estrutura SIZE que recebe as extensões de janela anteriores, em unidades lógicas. 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

A janela refere-se ao sistema de coordenadas lógicas do espaço de página. A extensão é o valor máximo de um eixo. Essa função define os valores máximos para os eixos horizontal e vertical da janela (em coordenadas lógicas). Ao mapear entre o espaço de página e o espaço do dispositivo, SetViewportExtEx e SetWindowExtEx 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 seguintes modos de mapeamento são definidos, as chamadas para as funções SetWindowExtExtEx e SetViewportExtEx 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 SetWindowExtExtEx antes de chamar SetViewportExtExtEx. 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

Requisito	Valor
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