CTabCtrl::GetItem

Artikel
02/26/2013

Ruft Informationen zu einer Registerkarte in einem Tab-Steuerelement ab.

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

Parameter

nItem
Der nullbasierte Index der Registerkarte.
pTabCtrlItem
Zeiger auf eine Struktur TCITEM, verwendet die Informationen angeben, um abzurufen.Wird auch verwendet, um Informationen über die Registerkarte zu erhalten.Diese Struktur wird mit InsertItem, GetItem und SetItem-Memberfunktionen verwendet.

Rückgabewert

Gibt zurück, wenn TRUE erfolgreich; FALSE andernfalls.

Hinweise

Wenn die Meldung gesendet wird, gibt der mask-Members, der Attribute, um zurückzugeben.Wenn der mask-Member den TCIF_TEXT-Wert angibt, muss der pszText-Member die Adresse des Puffers enthalten, der den Elementtext empfängt und der cchTextMax-Member die Größe des Puffers angeben muss.

Maske
Bewerten Sie anzugeben, das abzurufen oder festzulegen TCITEM-Strukturmember.Dieser Member kann null oder eine Kombination der folgenden Werte sein:
- TCIF_TEXT der pszText-Member ist gültig.
- TCIF_IMAGE der iImage-Member ist gültig.
- TCIF_PARAM der lParam-Member ist gültig.
- TCIF_RTLREADING der Text von pszText wird mithilfe der Lesefolges von rechts nach links auf den arabischen oder hebräischen Systemen angezeigt.
- TCIF_STATE der dwState-Member ist gültig.
pszText
Zeiger auf eine auf NULL endende Zeichenfolge, die den Registerkarten enthält, wenn die Struktur Informationen über eine Registerkarte enthält.Wenn die Struktur Informationen empfängt, gibt dieser Member die Adresse des Puffers an, der den Registerkarten empfängt.
cchTextMax
Größe des Puffers wurde auf durch pszText.Dieser Member wird ignoriert, wenn die Struktur Informationen nicht empfängt.
iImage
Index in der Bildliste des Tab-Steuerelements oder 1, wenn kein Bild für die Registerkarte gibt.
lParam
Anwendungsdefinierte Daten zugeordnet mit der Registerkarte.Wenn mehr als vier Bytes anwendungsdefinierte Daten pro Registerkarte wird, muss eine Anwendung eine Struktur definieren und sie anstelle von TCITEM-Struktur verwenden.Der erste Member der anwendungsdefinierten Struktur muss eine TCITEMHEADER-Struktur sein.Die TCITEMHEADER-Struktur ist zur TCITEM-Struktur, aber ohne den lParam-Member identisch.Der Unterschied zwischen der Größe der Struktur und der Größe der TCITEMHEADER-Struktur sollte der Anzahl von zusätzlichen Bytes pro Registerkarte entspricht.

Beispiel

// 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();
}