fonction PATHOBJ_bEnumClipLines (winddi.h)
La fonction PATHOBJ_bEnumClipLines énumère les segments de ligne coupés d’un chemin donné.
Syntaxe
ENGAPI BOOL PATHOBJ_bEnumClipLines(
PATHOBJ *ppo,
ULONG cb,
CLIPLINE *pcl
);
Paramètres
ppo
Pointeur vers la structure PATHOBJ contenant les segments de ligne clippés à énumérer.
cb
Spécifie la taille du tampon de sortie, en octets. GDI n’écrit pas au-delà de ce point dans la mémoire tampon. La valeur de ce paramètre doit être suffisamment grande pour contenir une structure CLIPLINE avec au moins une structure RUN . Le pilote doit allouer de l’espace pour plusieurs structures RUN.
pcl
Pointeur vers la mémoire tampon qui reçoit une structure CLIPLINE. La structure contient les points de contrôle d’origine non appuyés pour un segment de ligne. (Les pixels corrects pour la ligne ne peuvent pas être calculés sans les points d’origine.) Les structures RUN, qui décrivent des ensembles de pixels le long de la ligne qui ne sont pas coupés, sont écrites dans cette mémoire tampon.
Si une région de clip est complexe, un segment de ligne unique peut être divisé en plusieurs structures RUN. Un segment est retourné autant de fois que nécessaire pour répertorier toutes ses structures RUN.
La structure CLIPLINE contient les points de début et de fin de la ligne d’origine sans saut et les segments de ligne, ou structures RUN, de cette ligne qui doivent apparaître sur l’affichage.
Valeur retournée
La valeur de retour est TRUE si d’autres segments de ligne doivent être énumérés, ce qui indique que ce service doit être appelé à nouveau. Sinon, il est FALSE, ce qui indique que le segment retourné est le dernier segment du chemin d’accès.
Remarques
L’énumération doit être démarrée avec PATHOBJ_vEnumStartClipLines avant que le pilote effectue cet appel.
Configuration requise
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | winddi.h (inclure Winddi.h) |
| Bibliothèque | Win32k.lib |
| DLL | Win32k.sys |