Compartilhar via


TCM_GETITEM mensagem

Recupera informações sobre uma guia em um controle guia. Você pode enviar essa mensagem explicitamente ou usando a macro TabCtrl_GetItem .

Parâmetros

wParam

Índice da guia.

lParam

Ponteiro para uma estrutura TCITEM que especifica as informações a serem recuperadas e recebe informações sobre a guia. Quando a mensagem é enviada, o membro mask especifica quais atributos retornar. Se o membro mask especificar o valor TCIF_TEXT, o membro pszText deverá conter o endereço do buffer que recebe o texto do item e o membro cchTextMax deverá especificar o tamanho do buffer.

Valor retornado

Retornará TRUE se tiver êxito ou FALSE caso contrário.

Comentários

Se o sinalizador TCIF_TEXT for definido no membro mask da estrutura TCITEM , o controle poderá alterar o membro pszText da estrutura para apontar para o novo texto em vez de preencher o buffer com o texto solicitado. O controle pode definir o membro pszText como NULL para indicar que nenhum texto está associado ao item.

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
Nomes Unicode e ANSI
TCM_GETITEMW (Unicode) e TCM_GETITEMA (ANSI)