macro TabCtrl_GetItem (commctrl.h)

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

Sintaxe

void TabCtrl_GetItem(
   hwnd,
   iItem,
   pitem
);

Parâmetros

hwnd

Tipo: HWND

Manipule para o controle guia.

iItem

Tipo: int

Índice da guia.

pitem

Tipo: LPTCITEM

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.

Retornar valor

Nenhum

Comentários

Se o sinalizador TCIF_TEXT estiver definido no membro de máscara 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]
Plataforma de Destino	Windows
Cabeçalho	commctrl.h