CDC::GetPath

Artigo
02/25/2013

Recupera coordenadas definindo pontos de extremidade de linhas e os pontos de controle de curvas encontrados no caminho que é selecionado no contexto de dispositivo.

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

Parâmetros

lpPoints
Aponta para um vetor de estruturas de dados de PONTO ou de objetos de CPoint onde a linha pontos de extremidade e os pontos de controle da curva são colocados.
lpTypes
Aponta para uma matriz de bytes em que os tipos de vértice são colocados.Os valores são um de estes procedimentos:
- PT_MOVETO especifica que o ponto correspondente em lpPoints inicia uma figura de divisão.
- PT_LINETO especifica que o ponto anterior e o ponto correspondente em lpPoints são os pontos de início de uma linha.
- PT_BEZIERTO especifica que o ponto correspondente em lpPoints é um ponto ou um ponto final de controle de uma curva de Bzier.
  
  Os tipos dePT_BEZIERTO sempre ocorrem em conjuntos de três.O ponto no caminho imediatamente antes de eles define o ponto de partida para a curva de Bzier.Os primeiros dois pontos de PT_BEZIERTO são os pontos de controle, e o segundo ponto de PT_BEZIERTO é o ponto de extremidade (se embutido).
  
  Um tipo de PT_LINETO ou de PT_BEZIERTO pode ser combinado com o seguinte sinalizador (usando o operador bit a bit OR) para indicar que o ponto correspondente é o ponto em que o último em uma figura e que a figura deve ser fechada:
- PT_CLOSEFIGURE especifica que a figura é fechada automaticamente após a linha ou a curva correspondente são desenhadas.A figura é fechada desenhar uma linha do ponto final da linha ou da curva a medida que corresponde a PT_MOVETOo último.
nCount
Especifica o número total de estruturas de dados de PONTO que podem ser colocadas na matriz de lpPoints .Esse valor deve ser o mesmo que o número de bytes que pode ser colocado na matriz de lpTypes .

Valor de retorno

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

Comentários

O contexto de dispositivo deve conter um caminho fechado.Os pontos de caminho são retornados em coordenadas lógicas.Os pontos são armazenados no caminho em coordenadas de dispositivo, portanto alterações em GetPath dos pontos das coordenadas de dispositivo para coordenadas lógicas usando o inverso de transformação atual.A função de membro de FlattenPath pode ser chamado antes de GetPath, para converter todas as curvas no caminho na linha segmentos.