CTabCtrl::GetItem

Artigo
08/25/2010

Recupera informações sobre uma guia em um controle guia.

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

Parâmetros

nItem
Índice baseado em zero da guia.
pTabCtrlItem
Ponteiro para um TCITEM estrutura, usada para especificar as informações para recuperar.Também é usado para receber informações sobre a guia.Essa estrutura é usada com o InsertItem, GetItem, e SetItem funções de membro.

Valor de retorno

RetornaTRUE se for bem-sucedido; FALSE outra forma.

Comentários

Quando a mensagem é enviada, a máscara membro especifica quais atributos para retornar.Se o máscara membro Especifica a TCIF_TEXT valor, o pszText membro deverá conter o endereço do buffer que receberá o texto do item e o cchTextMax membro deve especificar o dimensionar do buffer.

máscara
Valor que especifica qual TCITEM membros de estrutura para recuperar ou conjunto. Este membro pode ser zero ou uma combinação dos seguintes valores:
- TCIF_TEXT O pszText membro é válido.
- TCIF_IMAGE O iImage membro é válido.
- TCIF_PARAM O lParam membro é válido.
- TCIF_RTLREADING O texto da pszText é exibido usando sentido de leitura da direita para a esquerda nos sistemas hebraico ou árabe.
- TCIF_STATE O dwState membro é válido.
pszText
Ponteiro para uma cadeia terminada com nulo que contém o texto do guia se a estrutura contém informações sobre uma guia.Se a estrutura está recebendo informações, esse membro Especifica o endereço do buffer que receberá o texto do guia.
cchTextMax
dimensionar do buffer apontada por pszText.Este membro será ignorado se a estrutura não está recebendo informações.
iImage
Indexar para o controle de guia lista de imagens ou – 1 se não houver nenhuma imagem para a guia.
lParam
Dados definidos pelo aplicativo associados com a guia.Se houver mais de quatro bytes de dados definido pelo aplicativo por guia, um aplicativo deve definir uma estrutura e usá-lo em vez do TCITEM estrutura. O primeiro membro da estrutura definida pelo aplicativo deve ser um TCITEMHEADER estrutura.The TCITEMHEADER é idêntica ao estruturaTCITEM estrutura, mas sem a lParam membro.A diferença entre o dimensionar de sua estrutura e o dimensionar do TCITEMHEADER estrutura deve ser igual o número de bytes extras por guia.

Exemplo

// In this example a CTabCtrl data member, m_TabCtrl, changes the
// text of the tabs in the tab control.  A call to GetItem is used
// to get the current text, and then the text is changed.  A call 
// to SetItem is used to update the tab with the new text.

void CTabDlg::OnChangeItem()
{
   TCITEM tcItem;
   CString pszString;

   //  Get text for the tab item.
   GetDlgItemText(IDC_ITEM_TEXT, pszString);

   //  Get the current tab item text.
   TCHAR buffer[256] = {0};
   tcItem.pszText = buffer;
   tcItem.cchTextMax = 256;
   tcItem.mask = TCIF_TEXT;
   m_TabCtrl.GetItem(0, &tcItem);
   TRACE(_T("Changing item text from %s to %s..."), tcItem.pszText, pszString);

   //  Set the new text for the item.
   tcItem.pszText = pszString.LockBuffer();

   //  Set the item in the tab control.
   m_TabCtrl.SetItem(0, &tcItem);

   pszString.UnlockBuffer();
}