TreeView_GetItemPartRect macro (commctrl.h)

Artigo
10/24/2024

Recupera o maior retângulo delimitador possível que constitui a "zona de ocorrência" para uma parte especificada de um item. Use essa macro ou envie a mensagem TVM_GETITEMPARTRECT explicitamente.

Sintaxe

BOOL TreeView_GetItemPartRect(
   HWND       hwnd,
   HTREEITEM  hitem,
   RECT       *prc,
   TVITEMPART *partid
);

Parâmetros

hwnd

Tipo: HWND

Manipule para o controle de exibição de árvore.

hitem

Tipo: HTREEITEM

Manipule para o item de exibição de árvore.

prc

Tipo: * RECT

Ponteiro para uma estrutura RECT que recebe o retângulo delimitador. O chamador é responsável por alocar essa estrutura. As coordenadas recebidas são relativas ao canto superior esquerdo do controle de exibição de árvore.

partid

Tipo: TVITEMPART*

ID da parte do item. Esse valor deve ser TVGIPR_BUTTON (0x0001).

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

Essa mensagem retorna o maior retângulo delimitador possível, de modo que para cada coordenada (x,y) dentro do retângulo, um clique do usuário nessa coordenada constituiria um impacto nessa parte do item.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Compartilhar via