Função WNDOBJ_bEnum (winddi.h)

A função WNDOBJ_bEnum obtém um lote de retângulos da região visível de uma janela.

Sintaxe

ENGAPI BOOL WNDOBJ_bEnum(
  WNDOBJ *pwo,
  ULONG  cj,
  ULONG  *pul
);

Parâmetros

pwo

Ponteiro para uma estrutura WNDOBJ criada por uma chamada para EngCreateWnd.

cj

Especifica o tamanho, em bytes, do buffer apontado por pul. O GDI não escreverá além desse limite.

pul

Ponteiro para o buffer no qual uma estrutura do formulário a seguir deve ser gravada. Nessa estrutura, c é uma contagem dos retângulos retornados e arcl é uma matriz de retângulos:

typedef struct _ENUMRECTS{
    ULONG c;
    RECTL arcl[]
} ENUMRECTS;

Valor retornado

O valor retornado será TRUE se houver mais dados a serem enumerados e o driver deverá repetir a chamada. Ele será FALSE se a enumeração estiver concluída.

Comentários

A ordem de enumeração é determinada pela chamada para WNDOBJ_cEnumStart.

Segue-se uma possível estrutura de loop para chamar essa função.

do {
    bMore = WNDOBJ_bEnum(pwo, sizeof(buffer), &buffer.c);
    for (i = 0; i < buffer.c; i++) { 
        //  Process the data
    }
} while (bMore);

WNDOBJ_bEnum deve ser chamado apenas pela função de retorno de chamada fornecida ao GDI pela função EngCreateWnd ou pelas funções DDI gráficas que recebem um WNDOBJ.

Requisitos

Confira também

EngCreateWnd

WNDOBJ

WNDOBJ_cEnumStart