CDC::GetPath

Artigo
08/25/2010

Recupera as coordenadas definindo os pontos de extremidade de linhas e os pontos de controle de curvas encontrados no caminho selecionado para o contexto de dispositivo.

int GetPath(
   LPPOINT lpPoints,
   LPBYTE lpTypes,
   int nCount 
) const;

Parâmetros

lpPoints
Aponta para uma matriz de PONTO estruturas de dados de ou CPoint onde a curva e pontos de extremidade da linha de pontos de controle de objetos são colocados.
lpTypes
Aponta para uma matriz de bytes em que os tipos de vértice são colocados.Os valores são uma das seguintes opções:
- PT_MOVETO Especifica que o correspondente point-in lpPoints Inicia uma figura de disjunção.
- PT_LINETO Especifica que o ponto anterior e o correspondente apontem lpPoints são os pontos de extremidade de uma linha.
- PT_BEZIERTO Especifica que o correspondente point-in lpPoints é um ponto de controle ou o ponto de uma curva Bzier final.
  
  PT_BEZIERTO tipos sempre ocorrem em conjuntos de três.O ponto no caminho imediatamente anterior-define o ponto de partida para a curva Bzier.As duas primeiras PT_BEZIERTO pontos são pontos de controle e o terceiro PT_BEZIERTO ponto é o ponto participante (se embutido em código).
  
  A PT_LINETO or PT_BEZIERTO tipo pode ser combinado com o seguinte sinalizar (usando o operador bit a bit OR) para indicar que o ponto correspondente é o último ponto de uma figura e que a figura deve ser fechada:
- PT_CLOSEFIGURE Especifica que a figura é fechada automaticamente após a linha correspondente ou curva é desenhada.A figura é fechada pelo desenho de uma linha do ponto de extremidade linha ou curva até o ponto correspondente ao último PT_MOVETO.
nCount
Especifica o número total de PONTO estruturas de dados que podem ser colocadas no lpPoints matriz. Esse valor deve ser o mesmo sistema autônomo o número de bytes que podem ser colocados no lpTypes matriz.

Valor de retorno

Se o nCount o parâmetro é diferente de zero, o número de pontos enumerados. If nCount é 0, o número total de pontos no caminho (e GetPath grava nada os buffers). If nCount é diferente de zero e é menor do que o número de pontos no caminho, o valor retornado é -1.

Comentários

O contexto de dispositivo deve conter um caminho fechado.Os pontos do caminho são retornados em coordenadas lógicas.Pontos são armazenados no caminho nas coordenadas do dispositivo, então, GetPath Altera os pontos de coordenadas de dispositivo para coordenadas lógicas usando o inverso da transformação corrente. The FlattenPath função de membro pode ser chamada antes de GetPath, para converter todas as curvas no caminho em segmentos de linha.