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

Voir aussi

CLIPLINE

PATHOBJ

PATHOBJ_vEnumStartClipLines

COURIR