TabCtrl_GetItem macro (commctrl.h)

Artigo
10/24/2024

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

Sintaxe

BOOL TabCtrl_GetItem(
   HWND     hwnd,
   int      iItem,
   LPTCITEM pitem
);

Parâmetros

hwnd

Tipo: HWND

Manipule para o controle tab.

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, a máscara de membro especifica quais atributos retornar. Se a máscara membro 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 de retorno

Tipo: BOOL

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

Observações

Se o sinalizador TCIF_TEXT estiver definido na máscara membro 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
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Compartilhar via