Funzione GetPath (wingdi.h)

Articolo
08/27/2023

La funzione GetPath recupera le coordinate che definiscono gli endpoint delle linee e i punti di controllo delle curve presenti nel percorso selezionato nel contesto di dispositivo specificato.

Sintassi

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

Parametri

[in] hdc

Handle per un contesto di dispositivo che contiene un percorso chiuso.

[out] apt

Puntatore a una matrice di strutture POINT che riceve gli endpoint di linea e i punti di controllo della curva, in coordinate logiche.

[out] aj

Puntatore a una matrice di byte che riceve i tipi di vertice. Questo parametro può avere uno dei valori seguenti.

Tipo	Descrizione
PT_MOVETO	Specifica che il punto corrispondente nel parametro lpPoints avvia una figura non contigua.
PT_LINETO	Specifica che il punto precedente e il punto corrispondente in lpPoint sono gli endpoint di una riga.
PT_BEZIERTO	Specifica che il punto corrispondente in lpPoints è un punto di controllo o un punto finale per una curva di Bézier. PT_BEZIERTO i valori si verificano sempre in set di tre. Il punto nel percorso immediatamente precedente definisce il punto iniziale per la curva di Bézier. I primi due punti PT_BEZIERTO sono i punti di controllo e il terzo punto PT_BEZIERTO è il punto finale (se hardcoded).

Un valore PT_LINETO o PT_BEZIERTO può essere combinato con il valore seguente (usando l'operatore bit per bit OR) per indicare che il punto corrispondente è l'ultimo punto di una figura e la figura deve essere chiusa.

Flag	Descrizione
PT_CLOSEFIGURE	Specifica che la figura viene chiusa automaticamente dopo la traccia della linea o della curva corrispondente. La figura viene chiusa disegnando una linea dalla linea o dall'endpoint della curva al punto corrispondente all'ultimo PT_MOVETO.

[in] cpt

Numero totale di strutture POINT che possono essere archiviate nella matrice a cui punta lpPoints. Questo valore deve essere uguale al numero di byte che possono essere inseriti nella matrice a cui punta lpTypes.

Valore restituito

Se il parametro nSize è diverso da zero, il valore restituito è il numero di punti enumerati. Se nSize è 0, il valore restituito è il numero totale di punti nel percorso e GetPath non scrive nulla nei buffer. Se nSize è diverso da zero e è minore del numero di punti nel percorso, il valore restituito è 1.

Commenti

Il contesto del dispositivo identificato dal parametro hdc deve contenere un percorso chiuso.

I punti del percorso vengono restituiti in coordinate logiche. I punti vengono archiviati nel percorso nelle coordinate del dispositivo, quindi GetPath modifica i punti dalle coordinate del dispositivo alle coordinate logiche usando l'inverso della trasformazione corrente.

La funzione FlattenPath può essere chiamata prima di GetPath per convertire tutte le curve nel percorso in segmenti di linea.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll