Função SetWindowOrgEx (wingdi.h)

Artigo
03/04/2024

A função SetWindowOrgEx especifica qual ponto de janela é mapeado para a origem do visor (0,0).

Sintaxe

BOOL SetWindowOrgEx(
  [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 lógicas, da nova origem da janela.

[in] y

A coordenada y, em unidades lógicas, da nova origem da janela.

[out] lppt

Um ponteiro para uma estrutura POINT que recebe a origem anterior da janela, em unidades lógicas. 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

Isso 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). SetWindowOrgEx especifica qual ponto lógico é mapeado para o ponto do dispositivo (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 (xWinOrg, yWinOrg) to the device point (0,0) 
SetWindowOrgEx (hdc, xWinOrg, yWinOrg, NULL)

Isso está relacionado à função SetViewportOrgEx . 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.

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