Compartilhar via


Função SetWindowExtEx (wingdi.h)

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

Confira também

Coordenar funções de espaço e transformação

Visão geral de espaços de coordenadas e transformações

GetWindowExtExtEx

SIZE

SetViewportExtExtEx