CTabCtrl::GetItem

Artigo
02/25/2013

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

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

Parâmetros

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

Valor de retorno

Retorna se Verdadeiro com êxito; Falso caso contrário.

Comentários

Quando a mensagem é enviada, o membro de mask especifica que atribui para retornar.Se o membro de mask especifica o valor de TCIF_TEXT , o membro de pszText deve conter o endereço de buffer que recebe o texto do item e o membro de cchTextMax deve especificar o tamanho do buffer.

mask
Avalie especificar que os membros de estrutura de TCITEM para recuperar ou definir.Esse membro pode ser zero ou uma combinação dos seguintes valores:
- TCIF_TEXT o membro de pszText é válido.
- TCIF_IMAGE o membro de iImage é válido.
- TCIF_PARAM o membro de lParam é válido.
- TCIF_RTLREADING o texto de pszText é exibido usando a ordem de leitura d-e nos sistemas hebraico ou árabe.
- TCIF_STATE o membro de dwState é válido.
pszText
Ponteiro para uma cadeia de caracteres NULL- finalizada que contém o texto da guia se a estrutura contém informações sobre uma guia.Se a estrutura está recebendo informações, esse membro especifica o endereço de buffer que recebe o texto na guia.
cchTextMax
O tamanho do buffer apontado por pszText.Esse membro é ignorado se a estrutura não está recebendo informações.
iImage
Índice na lista de imagem do controle da guia – 1, ou se não houver nenhuma imagem para a guia.
lParam
Associados a dados definidos pela guia.Se houver mais de quatro bytes de dados definidos pelo aplicativo na guia, um aplicativo deve definir uma estrutura e usá-la em vez da estrutura de TCITEM .O primeiro membro de estrutura application-defined deve ser uma estrutura de TCITEMHEADER.A estrutura de TCITEMHEADER é idêntica a estrutura de TCITEM , mas sem o membro de lParam .A diferença entre o tamanho da sua estrutura e o tamanho da estrutura de TCITEMHEADER deve igual ao número de bytes adicionais na 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();
}