Estrutura WNDOBJ (winddi.h)

Artigo
08/27/2023

A estrutura WNDOBJ permite que o driver acompanhe as alterações de posição, tamanho e região do cliente visíveis de uma janela.

Sintaxe

typedef struct _WNDOBJ {
  CLIPOBJ coClient;
  PVOID   pvConsumer;
  RECTL   rclClient;
  SURFOBJ *psoOwner;
} WNDOBJ, *PWNDOBJ;

Membros

coClient

Especifica uma estrutura CLIPOBJ que descreve a região do cliente da janela. Se iDComplexity for DC_RECT e a borda esquerda em rclBounds for maior ou igual à borda direita ou a borda superior for maior ou igual à borda inferior, a região do cliente será invisível.

pvConsumer

Ponteiro para um valor definido pelo driver que identifica essa estrutura WNDOBJ específica. Esse valor pode ser definido chamando a função WNDOBJ_vSetConsumer .

rclClient

Especifica uma estrutura RECTL que descreve a área do cliente da janela em coordenadas de tela. Esse retângulo é exclusivo para o canto inferior direito, o que significa que as bordas inferior e direita dessa região não estão incluídas.

psoOwner

Ponteiro para a estrutura SURFOBJ que foi passada para EngCreateWnd quando esse WNDOBJ foi criado.

Comentários

A região do cliente visível pode ser enumerada chamando as funções WNDOBJ_cEnumStart e WNDOBJ_bEnum .

Um driver pode associar seus próprios dados a um WNDOBJ chamando a função WNDOBJ_vSetConsumer .

Como acelerador, o driver pode acessar membros públicos do WNDOBJ. Esses membros públicos têm a garantia de permanecer inalterados somente no contexto da rotina de retorno de chamada do driver fornecida ao GDI na função EngCreateWnd ou nas funções em que um WNDOBJ é fornecido.

O driver deve usar o SURFOBJ para o qual psoOwner aponta para recuperar o estado específico do driver relevante para o WNDOBJ, como a alça PDEV do driver, em vez de manter variáveis globais.