Função DPtoLP (wingdi.h)

Artigo
03/04/2024

A função DPtoLP converte as coordenadas do dispositivo em coordenadas lógicas. A conversão depende do modo de mapeamento do contexto do dispositivo, das configurações das origens e extensões da janela e do visor e da transformação do mundo.

Sintaxe

BOOL DPtoLP(
  [in]      HDC     hdc,
  [in, out] LPPOINT lppt,
  [in]      int     c
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in, out] lppt

Um ponteiro para uma matriz de estruturas POINT . As coordenadas x e y contidas em cada estrutura POINT serão transformadas.

[in] c

O número de pontos na matriz.

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 função DPtoLP falhará se as coordenadas do dispositivo excederem 27 bits ou se as coordenadas lógicas convertidas excederem 32 bits. No caso de tal estouro, os resultados de todos os pontos são indefinidos.

Exemplos

Para obter um exemplo, consulte Usando espaços de coordenadas e transformações.

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