Función GetPath (wingdi.h)

Artículo
03/08/2023

La función GetPath recupera las coordenadas que definen los puntos de conexión de las líneas y los puntos de control de las curvas que se encuentran en la ruta de acceso seleccionada en el contexto de dispositivo especificado.

Sintaxis

int GetPath(
  [in]  HDC     hdc,
  [out] LPPOINT apt,
  [out] LPBYTE  aj,
  [in]  int     cpt
);

Parámetros

[in] hdc

Identificador de un contexto de dispositivo que contiene una ruta de acceso cerrada.

[out] apt

Puntero a una matriz de estructuras POINT que recibe los puntos de conexión de línea y los puntos de control de curva, en coordenadas lógicas.

[out] aj

Puntero a una matriz de bytes que recibe los tipos de vértices. Este parámetro puede ser uno de los valores siguientes.

Tipo	Descripción
PT_MOVETO	Especifica que el punto correspondiente en el parámetro lpPoints inicia una figura desenlazado.
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 punto final para una curva Bézier. PT_BEZIERTO valores siempre se producen en conjuntos de tres. El punto de la ruta inmediatamente anterior a ellos define el punto inicial de la curva Bézier. Los dos primeros puntos PT_BEZIERTO son los puntos de control y el tercer punto PT_BEZIERTO es el punto final (si está codificado de forma rígida).

Un valor PT_LINETO o PT_BEZIERTO se puede combinar con el siguiente valor (mediante el operador bit a bit OR) para indicar que el punto correspondiente es el último punto de una figura y se debe cerrar la ilustración.

Marca	Descripción
PT_CLOSEFIGURE	: especifica que la figura se cierra automáticamente después de dibujar la línea o curva correspondientes. La figura se cierra dibujando una línea del extremo de línea o curva hasta el punto correspondiente al último PT_MOVETO.

[in] cpt

Número total de estructuras POINT que se pueden almacenar en la matriz a la que apuntan lpPoints. Este valor debe ser el mismo que el número de bytes que se pueden colocar en la matriz a la que apunta lpTypes.

Valor devuelto

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

Comentarios

El contexto del dispositivo identificado por el parámetro hdc debe contener una ruta de acceso cerrada.

Los puntos del trazado se devuelven en coordenadas lógicas. Los puntos se almacenan en la ruta de acceso en las coordenadas del dispositivo, por lo que GetPath cambia los puntos de las coordenadas del dispositivo a coordenadas lógicas mediante el uso inverso de la transformación actual.

Se puede llamar a la función FlattenPath antes de GetPath para convertir todas las curvas de la ruta de acceso en segmentos de línea.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll