Compartilhar via


TVM_GETITEMRECT mensagem

Recupera o retângulo delimitador para um item de exibição de árvore e indica se o item está visível. Você pode enviar essa mensagem explicitamente ou usando a macro TreeView_GetItemRect .

Parâmetros

wParam

Valor que especifica a parte do item para a qual recuperar o retângulo delimitador. Se esse parâmetro for TRUE, o retângulo delimitador incluirá apenas o texto do item. Caso contrário, ele inclui a linha inteira que o item ocupa no controle de exibição de árvore.

lParam

Ponteiro para uma estrutura RECT que, ao enviar a mensagem, contém o identificador do item para o qual recuperar o retângulo. Consulte o exemplo abaixo para obter mais informações sobre como colocar o identificador de item nesse parâmetro. Depois de retornar da mensagem, esse parâmetro contém o retângulo delimitador. As coordenadas são relativas ao canto superior esquerdo do controle de exibição de árvore.

Valor retornado

Se o item estiver visível e o retângulo delimitador tiver sido recuperado com êxito, o valor retornado será TRUE. Caso contrário, a mensagem retornará FALSE e não recuperará o retângulo delimitador.

Comentários

Ao enviar essa mensagem, o parâmetro lParam contém o identificador do item para o qual o retângulo está sendo recuperado. O identificador é colocado em lParam , conforme mostrado no exemplo a seguir:

RECT rc;

*(HTREEITEM*)&rc = hTreeItem;

SendMessage(hwndTreeView, TVM_GETITEMRECT, FALSE, (LPARAM)&rc);

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Commctrl.h