CTabCtrl::GetItem

BOOL GetItem ( int nItem, TCITEM * pTabCtrlItem ) const;

Valor de retorno

Retorna TRUE se bem-sucedido; Falso caso contrário.

Parâmetros

nItem

Índice baseado em zero da guia.

pTabCtrlItem

Ponteiro para um estrutura TCITEM , usada para especificar as informações para recuperar. Também usado para receber informações sobre a guia. Essa estrutura é usada com as funções de membro InsertItem, GetIteme SetItem.

Observações

Chame essa função para recuperar informações sobre uma guia em um controle guia.

Quando a mensagem é enviada, a máscara membro especifica quais atributos para retornar. Se o membro de máscara especifica o valor de TCIF_TEXT , pszText membro deve conter o endereço da reserva que recebe o texto item e o cchTextMax membro deve especificar o tamanho do buffer.

máscara

Valor especificando quais membros de estrutura TCITEM para recuperar ou definir. Esse membro pode ser zero ou uma combinação dos seguintes valores:

• TCIF_TEXT   O pszText membro é válido.
  
  
• TCIF_IMAGE   O membro iImage é válido.
  
  
• TCIF_PARAM   O membro de lParam é válido.
  
  
• TCIF_RTLREADI&NGnbsp;  O texto de pszText é exibido usando ordem de leitura da direita para a esquerda nos sistemas hebraico ou árabe.
  
  
• TCIF_STATE   O membro dwState é válido.

pszText

Ponteiro para uma seqüência de caracteres null-terminated que contém o texto guia se a estrutura contém informações sobre uma guia. Se a estrutura está recebendo informações, esse membro especifica o endereço da reserva que recebe o texto do guia.

cchTextMax

Tamanho da reserva apontado pelo pszText. Este membro será ignorado se a estrutura não está recebendo informações.

iImage

I&ndexar em lista de imagem o Controlarar de guia, ornbsp; -1 se não houver nenhuma imagem para a guia.

lParam

Application-defined dados associado com a guia. Se houver mais de quatro bytes de dados application-defined por guia, um aplicativo deve definir uma estrutura e usá-lo em vez de TCITEM estrutura. O primeiro membro da estrutura definida pelo aplicativo deve ser uma TCITEMHEADER estrutura. A estrutura TCITEMHEADER é idêntica à estrutura de TCITEM , mas sem o membro de lParam . A diferença entre o tamanho da sua estrutura e o tamanho da estrutura TCITEMHEADER deve ser igual o número de adicional bytes por guia.

Visão geral de CTabCtrl |  Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CTabCtrl::InsertItem, CTabCtrl::SetItem