CDC::GetPath

Artículo
02/19/2013

Recupera las coordenadas que definen los extremos de líneas y los puntos de control de curvas encontrados en la ruta que selecciona en el contexto del dispositivo.

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

Parámetros

lpPoints
Señala a una matriz de estructuras de datos de PUNTO u objetos de CPoint donde se colocan los extremos de la línea y los puntos de control de la curva.
lpTypes
Señala a una matriz de bytes donde se colocan los tipos vértices.Los valores son uno de los siguientes:
- PT_MOVETO especifica que el punto correspondiente en lpPoints inicia una figura disjunta.
- PT_LINETO especifica que el punto anterior y el punto correspondiente en lpPoints son los extremos de una línea.
- PT_BEZIERTO especifica que el punto correspondiente en lpPoints es un punto de control o un extremo para una curva de Bzier.
  
  Los tipos dePT_BEZIERTO siempre aparecen en conjuntos de tres.El punto de la ruta inmediatamente antes de que define el punto inicial de la curva de Bzier.Los dos primeros puntos de PT_BEZIERTO son los puntos de control, y el tercer punto de PT_BEZIERTO es el punto final (si está codificado de forma rígida).
  
  Un tipo de PT_LINETO o de PT_BEZIERTO puede combinarse con el indicador (mediante el operador bit a bit OR) para indicar que el punto correspondiente es el último punto en una figura y que la figura debe ser cerrado:
- PT_CLOSEFIGURE especifica que se cierra la ilustración automáticamente después de dibujar la línea o la curva correspondiente.En la ilustración se cierra debe dibujar una línea del extremo de la línea o la curva al punto correspondiente a PT_MOVETOpasado.
nCount
Especifica el número total de estructuras de datos de PUNTO que se pueden colocar en la matriz de lpPoints .Este valor debe ser el mismo que el número de bytes que se pueden colocar en la matriz de lpTypes .

Valor devuelto

Si el parámetro de nCount es distinto de cero, el número de puntos enumerados.Si nCount es 0, el número total de puntos en la ruta (y GetPath no escribe nada en los búferes).Si nCount es distinto de cero y es menor que el número de puntos de la ruta, el valor devuelto es -1.

Comentarios

El contexto de dispositivo debe contener un trazado cerrado.Los puntos de la ruta se devuelven en coordenadas lógicas.Los puntos se almacenan en la ruta de acceso en coordenadas de dispositivo, de modo que los cambios de GetPath que señala desde el dispositivo coordinan en coordenadas lógicas mediante lo contrario de transformación actual.La función miembro de FlattenPath se puede llamar antes de GetPath, convertir todas las curvas en la ruta de acceso en los segmentos de línea.