Função CLIPOBJ_bEnum (winddi.h)

A função CLIPOBJ_bEnum enumera um lote de retângulos de uma região de clipe especificada; uma chamada anterior para CLIPOBJ_cEnumStart determina a ordem da enumeração.

Sintaxe

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

Parâmetros

[in] pco

Ponteiro para uma estrutura CLIPOBJ que descreve a região do clipe que deve ser enumerada.

[in] cj

Especifica o tamanho, em bytes, do buffer apontado por pv.

[out] pul

Ponteiro para o buffer que receberá dados sobre a região de clipe em uma estrutura ENUMRECTS .

Retornar valor

O valor retornado será TRUE se o driver precisar chamar essa função novamente para obter mais dados de enumeração ou FALSE se a enumeração for concluída. É possível que CLIPOBJ_bEnum retorne TRUE com o número de retângulos de recorte igual a zero. Nesses casos, o driver deve chamar CLIPOBJ_bEnum novamente sem tomar nenhuma ação.

Comentários

Uma possível estrutura de loop para chamar essa função segue:

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

A contagem de objetos gravados no buffer é gravada no próprio buffer.

Requisitos

Confira também

CLIPOBJ

CLIPOBJ_cEnumStart

ENUMRECTS