Função SetViewportOrgEx (wingdi.h)

Artigo
03/08/2023

A função SetViewportOrgEx especifica qual ponto de dispositivo é mapeado para a origem da janela (0,0).

Sintaxe

BOOL SetViewportOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] x

A coordenada x, em unidades de dispositivo, da nova origem do visor.

[in] y

A coordenada y, em unidades de dispositivo, da nova origem do visor.

[out] lppt

Um ponteiro para uma estrutura POINT que recebe a origem do visor anterior, em coordenadas do dispositivo. Se lpPoint 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

Essa função (juntamente com SetViewportExtExtEx e SetWindowExtEx) ajuda a definir o mapeamento do espaço de coordenadas lógicas (também conhecido como janela) para o espaço de coordenadas do dispositivo (o visor). SetViewportOrgEx especifica qual ponto de dispositivo é mapeado para o ponto lógico (0,0). Ele tem o efeito de deslocar os eixos para que o ponto lógico (0,0) não se refira mais ao canto superior esquerdo.


//map the logical point (0,0) to the device point (xViewOrg, yViewOrg) 
SetViewportOrgEx ( hdc, xViewOrg, yViewOrg, NULL)

Isso está relacionado à função SetWindowOrgEx . Em geral, você usará uma função ou outra, mas não ambas. Independentemente do uso de SetWindowOrgEx e SetViewportOrgEx, o ponto do dispositivo (0,0) é sempre o canto superior esquerdo.

Exemplos

Para obter um exemplo, consulte Redesenhar na Região de Atualização.

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