CTabCtrl::GetItem

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

Rückgabewert

Gibt zurück TRUE wenn erfolgreich; Falsch sonst.

Parameter

nItem

Nullbasierte Index der Registerkarte.

pTabCtrlItem

Zeiger auf eine TCITEM -Struktur verwendet, um die Informationen abrufen angeben. Auch verwendet, um Informationen über die Registerkarte zu erhalten. Diese Struktur wird mit der GetItem-Methode InsertItemund SetItem Memberfunktionen verwendet.

Bemerkungen

Rufen Sie diese Funktion zum Abrufen von Informationen über eine Registerkarte in einem Registersteuerelement.

Wenn die Nachricht gesendet wird, gibt das Maske Mitglied der zurückzugebenden Attribute an. Wenn das Maske Mitglied der TCIF_TEXT -Wert angibt, der PszText -Member muss die Adresse des Puffers, die den Text des Elements erhält und das CchTextMax -Element muss die Größe des Puffers angeben.

maske

Wert, der angibt welche TCITEM Strukturmember zum Abrufen oder festlegen. Dieses Element kann 0 (null) oder eine Kombination der folgenden Werte sein.:

• TCIF_TEXT&Nbsp;  Der PszText -Member ist gültig.
  
  
• TCIF_IMAGE&Nbsp;  Gilt der iImage -member.
  
  
• TCIF_PARAM&Nbsp;  Das lParam -Element ist gültig.
  
  
• TCIF_RTLREADI&NGNbsp;  Der Text der PszText wird angezeigt mit rechts-nach-links Leserichtung auf Hebräisch oder Arabisch-Systeme.
  
  
• TCIF_STATE&Nbsp;  Das DwState Mitglied ist gültig.

pszText

Zeiger auf eine auf Null endende Zeichenfolge, enthält den Registerkartentext, wenn die Struktur Informationen über eine Registerkarte enthält. Wenn die Struktur Informationen empfängt, gibt dieser Member die Adresse des Puffers, die den Registertext empfängt.

cchTextMax

Größe des Puffers, auf den PszText. Dieser Member wird ignoriert, wenn die Struktur nicht mit Informationen versorgt wird.

iImage

I&ndex für das Registerkarten-Steuerelement Bildliste, Ornbsp; – 1, wenn kein für die Registerkarte Bild.

lParam

Anwendungsdefinierte Daten der Registerkarte zugeordnet. Wenn mehr als vier Bytes der anwendungsdefinierten Daten pro Registerkarte sind, muss eine Anwendung eine Struktur definieren und verwenden Sie es anstelle der TCITEM -Struktur. Das erste Mitglied der Anwendung definierte Struktur muß eine TCITEMHEADER -Struktur. Die TCITEMHEADER -Struktur entspricht der TCITEM -Struktur, jedoch ohne die lParam -Mitglied. Der Unterschied zwischen der Größe der Struktur und der Größe der TCITEMHEADER -Struktur sollte die Anzahl der zusätzlichen Bytes pro Registerkarte entsprechen.

Übersicht über die CTabCtrl |  Member der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;CTabCtrl::InsertItem, CTabCtrl::SetItem