funzione CLIPOBJ_bEnum (winddi.h)
La funzione CLIPOBJ_bEnum enumera un batch di rettangoli da un'area di ritaglio specificata; una chiamata precedente a CLIPOBJ_cEnumStart determina l'ordine di enumerazione.
Sintassi
ENGAPI BOOL CLIPOBJ_bEnum(
[in] CLIPOBJ *pco,
[in] ULONG cj,
[out] ULONG *pul
);
Parametri
[in] pco
Puntatore a una struttura CLIPOBJ che descrive l'area clip da enumerare.
[in] cj
Specifica le dimensioni, in byte, del buffer a cui punta il pv.
[out] pul
Puntatore al buffer che riceverà i dati sull'area di ritaglio in una struttura ENUMRECTS .
Valore restituito
Il valore restituito è TRUE se il driver deve chiamare nuovamente questa funzione per altri dati di enumerazione o FALSE se l'enumerazione è stata completata. È possibile che CLIPOBJ_bEnum restituisca TRUE con il numero di rettangoli di ritaglio uguali a zero. In questi casi, il driver deve chiamare di nuovo CLIPOBJ_bEnum senza eseguire alcuna azione.
Commenti
Di seguito è illustrata una possibile struttura del ciclo per chiamare questa funzione:
do {
bMore = CLIPOBJ_bEnum(pco, sizeof(buffer), &buffer.c);
for (i = 0; i < buffer.c; i++) {
.
.
.
}
} while (bMore);
Il numero di oggetti scritti nel buffer viene scritto nel buffer stesso.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |