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

Vedi anche

CLIPOBJ

CLIPOBJ_cEnumStart

ENUMRECTS