fonction CLIPOBJ_bEnum (winddi.h)

La fonction CLIPOBJ_bEnum énumère un lot de rectangles d’une région de clip spécifiée ; un appel antérieur à CLIPOBJ_cEnumStart détermine l’ordre d’énumération.

Syntaxe

ENGAPI BOOL CLIPOBJ_bEnum(
  [in]  CLIPOBJ *pco,
  [in]  ULONG   cj,
  [out] ULONG   *pul
);

Paramètres

[in] pco

Pointeur vers une structure CLIPOBJ décrivant la région de clip à énumérer.

[in] cj

Spécifie la taille, en octets, de la mémoire tampon pointée vers pv.

[out] pul

Pointeur vers la mémoire tampon qui recevra des données sur la région de clip dans une structure ENUMRECTS .

Valeur retournée

La valeur de retour est TRUE si le pilote doit appeler à nouveau cette fonction pour plus de données d’énumération, ou FALSE si l’énumération est terminée. Il est possible pour CLIPOBJ_bEnum de retourner TRUE avec le nombre de rectangles de découpage égal à zéro. Dans ce cas, le pilote doit appeler à nouveau CLIPOBJ_bEnum sans effectuer d’action.

Remarques

Voici une structure de boucle possible pour appeler cette fonction :

do {
    bMore = CLIPOBJ_bEnum(pco, sizeof(buffer), &buffer.c);
    for (i = 0; i < buffer.c; i++) {
        .
        .
        .
    }
} while (bMore);

Le nombre d’objets écrits dans la mémoire tampon est écrit dans la mémoire tampon elle-même.

Configuration requise

Condition requise	Valeur
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

CLIPOBJ

CLIPOBJ_cEnumStart

ENUMRECTS