CTabCtrl-Klasse

Stellt die Funktionalität des allgemeinen Windows-Registerkarten-Steuerelements bereit.

Syntax

class CTabCtrl : public CWnd

Member

Öffentliche Konstruktoren

Name	Beschreibung
CTabCtrl::CTabCtrl	Erstellt ein CTabCtrl-Objekt.

Öffentliche Methoden

Name	Beschreibung
CTabCtrl::AdjustRect	Berechnet den Anzeigebereich eines Registerkartensteuerelements aufgrund eines Fensterrechtecks oder berechnet das Fensterrechteck, das einem bestimmten Anzeigebereich entspricht.
CTabCtrl::Create	Erstellt ein Registersteuerelement und fügt es an eine Instanz eines Objekts an.TabCtrl
CTabCtrl::CreateEx	Erstellt ein Registerkartensteuerelement mit den angegebenen erweiterten Windows-Formatvorlagen und fügt es an eine Instanz eines CTabCtrl Objekts an.
CTabCtrl::DeleteAllItems	Entfernt alle Elemente aus einem Registerkartensteuerelement.
CTabCtrl::DeleteItem	Entfernt ein Element aus einem Registerkartensteuerelement.
CTabCtrl::DeselectAll	Setzt Elemente in einem Registerkartensteuerelement zurück, sodass alle gedrückten Elemente gelöscht werden.
CTabCtrl::DrawItem	Zeichnet ein angegebenes Element eines Registerkartensteuerelements.
CTabCtrl::GetCurFocus	Ruft die Registerkarte mit dem aktuellen Fokus eines Registerkartensteuerelements ab.
CTabCtrl::GetCurSel	Bestimmt die aktuell ausgewählte Registerkarte in einem Registerkartensteuerelement.
CTabCtrl::GetExtendedStyle	Ruft die erweiterten Formatvorlagen ab, die derzeit für das Registerkartensteuerelement verwendet werden.
CTabCtrl::GetImageList	Ruft die Bildliste ab, die einem Registerkartensteuerelement zugeordnet ist.
CTabCtrl::GetItem	Ruft Informationen zu einer Registerkarte in einem Registerkartensteuerelement ab.
CTabCtrl::GetItemCount	Ruft die Anzahl der Registerkarten im Registerkartensteuerelement ab.
CTabCtrl::GetItemRect	Ruft das umgebende Rechteck für eine Registerkarte in einem Registerkartensteuerelement ab.
CTabCtrl::GetItemState	Ruft den Status des angegebenen Registerkartensteuerelementelements ab.
CTabCtrl::GetRowCount	Ruft die aktuelle Anzahl von Zeilen von Registerkarten in einem Registerkartensteuerelement ab.
CTabCtrl::GetToolTips	Ruft den Handle des QuickInfo-Steuerelements ab, das einem Registerkartensteuerelement zugeordnet ist.
CTabCtrl::HighlightItem	Legt den Hervorhebungsstatus eines Registerkartenelements fest.
CTabCtrl::HitTest	Bestimmt, welche Registerkarte (falls vorhanden) an einer angegebenen Bildschirmposition liegt.
CTabCtrl::InsertItem	Fügt eine neue Registerkarte in ein Registerkartensteuerelement ein.
CTabCtrl::RemoveImage	Entfernt ein Bild aus der Bildliste eines Registerkartensteuerelements.
CTabCtrl::SetCurFocus	Legt den Fokus auf eine angegebene Registerkarte in einem Registerkartensteuerelement fest.
CTabCtrl::SetCurSel	Wählt eine Registerkarte in einem Registerkartensteuerelement aus.
CTabCtrl::SetExtendedStyle	Legt die erweiterten Formatvorlagen für ein Registerkartensteuerelement fest.
CTabCtrl::SetImageList	Weist einem Registerkartensteuerelement eine Bildliste zu.
CTabCtrl::SetItem	Legt einige oder alle Attribute einer Registerkarte fest.
CTabCtrl::SetItemExtra	Legt die Anzahl der Bytes pro Registerkarte fest, die für anwendungsdefinierte Daten in einem Registerkartensteuerelement reserviert sind.
CTabCtrl::SetItemSize	Legt die Breite und Höhe eines Elements fest.
CTabCtrl::SetItemState	Legt den Status des angegebenen Registerkartensteuerelementelements fest.
CTabCtrl::SetMinTabWidth	Legt die mindestbreite von Elementen in einem Registerkartensteuerelement fest.
CTabCtrl::SetPadding	Legt den Abstand (Abstand) um jedes Registerkartensymbol und die Beschriftung in einem Registerkartensteuerelement fest.
CTabCtrl::SetToolTips	Weist einem Registerkartensteuerelement ein QuickInfo-Steuerelement zu.

Hinweise

Ein "Tabulatorsteuerelement" entspricht den Trennern in einem Notizbuch oder den Beschriftungen in einem Dateischrank. Durch Verwenden eines Registerkarten-Steuerelements können in einer Anwendung mehrere Seiten für denselben Bereich in einem Fenster oder Dialogfeld definiert werden. Jede Seite besteht aus einer Reihe von Informationen oder einer Gruppe von Steuerelementen, die die Anwendung anzeigt, wenn der Benutzer die entsprechende Registerkarte auswählt. Ein spezieller Typ von Registerkartensteuerelement zeigt Registerkarten an, die wie Schaltflächen aussehen. Durch Klicken auf eine Schaltfläche sollte sofort ein Befehl ausgeführt werden, anstatt eine Seite anzuzeigen.

Dieses Steuerelement (und daher die Klasse) ist nur für Programme verfügbar, die CTabCtrl unter Windows 95/98 und Windows NT, Version 3.51 und höher ausgeführt werden.

Weitere Informationen finden Sie unter "Steuerelemente und Verwenden"CTabCtrl.CTabCtrl

Vererbungshierarchie

CObject
CCmdTarget
CWnd

CTabCtrl

Anforderungen

Header: afxcmn.h

CTabCtrl::AdjustRect

Berechnet den Anzeigebereich eines Registerkartensteuerelements aufgrund eines Fensterrechtecks oder berechnet das Fensterrechteck, das einem bestimmten Anzeigebereich entspricht.

void AdjustRect(BOOL bLarger,   LPRECT lpRect);

Parameter

bLarger
Gibt an, welcher Vorgang ausgeführt werden soll. Wenn dieser Parameter lautet TRUE, lpRect gibt ein Anzeigerechteck an und empfängt das entsprechende Fensterrechteck. Wenn dieser Parameter lautet FALSE, lpRect gibt ein Fensterrechteck an und empfängt das entsprechende Anzeigerechteck.

lpRect
Zeiger auf eine RECT Struktur, die das angegebene Rechteck angibt und das berechnete Rechteck empfängt.

Beispiel

void CTabDlg::OnSize(UINT nType, int cx, int cy)
{
   CDialog::OnSize(nType, cx, cy);

   if (m_TabCtrl.m_hWnd == NULL)
      return; // Return if window is not created yet.

   RECT rect;

   // Get size of dialog window.
   GetClientRect(&rect);

   // Adjust the rectangle to fit the tab control into the
   // dialog's client rectangle.
   m_TabCtrl.AdjustRect(FALSE, &rect);

   // Move the tab control to the new position and size.
   m_TabCtrl.MoveWindow(&rect, TRUE);
}

CTabCtrl::Create

Erstellt ein Registersteuerelement und fügt es an eine Instanz eines CTabCtrl Objekts an.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwStyle
Gibt die Formatvorlage des Registerkartensteuerelements an. Wenden Sie eine beliebige Kombination aus Formatvorlagen für Registerkartensteuerelemente an, die im Windows SDK beschrieben werden. Eine Liste der Fensterformatvorlagen, die Sie auch auf das Steuerelement anwenden können, finden Sie in den Hinweisen .

rect
Gibt die Größe und Position des Registerkartensteuerelements an. Dabei kann es sich um ein CRect Objekt oder eine RECT Struktur handeln.

pParentWnd
Gibt das übergeordnete Fenster des Registerkartensteuerelements an, in der Regel ein CDialog. Es darf nicht sein NULL.

nID
Gibt die ID des Registerkartensteuerelements an.

Rückgabewert

TRUE wenn die Initialisierung des Objekts erfolgreich war; andernfalls FALSE.

Hinweise

Sie erstellen ein CTabCtrl Objekt in zwei Schritten. Rufen Sie zuerst den Konstruktor auf, und rufen Sie dann den Konstruktor auf Create, wodurch das Registersteuerelement erstellt und an das CTabCtrl Objekt angefügt wird.

Zusätzlich zu Formatvorlagen für Registerkartensteuerelemente können Sie die folgenden Fensterformatvorlagen auf ein Registerkartensteuerelement anwenden:

• WS_CHILD: Erstellt ein untergeordnetes Fenster, das das Registerkartensteuerelement darstellt. Kann nicht mit der WS_POPUP-Formatvorlage verwendet werden.
• WS_VISIBLE: Erstellt ein Registerkartensteuerelement, das anfangs sichtbar ist.
• WS_DISABLED: Erstellt ein Anfänglich deaktiviertes Fenster.
• WS_GROUP: Gibt das erste Steuerelement einer Gruppe von Steuerelementen an, in der der Benutzer mit den Pfeiltasten von einem Steuerelement zum nächsten wechseln kann. Alle Steuerelemente, die mit der WS_GROUPFormatvorlage definiert sind, nach dem ersten Steuerelement gehören zur gleichen Gruppe. Das nächste Steuerelement mit der WS_GROUPFormatvorlage : beendet die Formatvorlagengruppe und startet die nächste Gruppe (d. a. eine Gruppe endet an der nächsten Stelle).
• WS_TABSTOP: Gibt eine beliebige Anzahl von Steuerelementen an, über die der Benutzer mithilfe der TAB-TASTE navigieren kann. Die TAB-TASTE verschiebt den Benutzer zum nächsten Steuerelement, das durch die WS_TABSTOPFormatvorlage angegeben wird.

Um ein Registerkartensteuerelement mit erweiterten Fensterformatvorlagen zu erstellen, rufen Sie CTabCtrl::CreateEx anstelle von Create.

Beispiel

// Assuming you have a member variable m_TabCtrl, that is a CTabCtrl
// object, you can use the following to create a tab control.

m_TabCtrl.Create(TCS_TABS | TCS_FIXEDWIDTH | WS_CHILD | WS_VISIBLE,
                 rect, this, IDC_MYTAB);

// This creates a tab control with the given styles, and with
// an ID of IDC_MYTAB.

CTabCtrl::CreateEx

Erstellt ein Steuerelement (ein untergeordnetes Fenster) und ordnet es dem Objekt zu CTabCtrl .

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwExStyle
Gibt die erweiterte Formatvorlage des zu erstellenden Steuerelements an. Eine Liste der erweiterten Windows-Stile finden Sie im dwExStyle Parameter für CreateWindowEx das Windows SDK.

dwStyle
Gibt die Formatvorlage des Registerkartensteuerelements an. Wenden Sie eine beliebige Kombination aus Formatvorlagen für Registerkartensteuerelemente an, die im Windows SDK beschrieben werden. Eine Liste der Fensterformatvorlagen, die Sie auch auf das Steuerelement anwenden können, finden Sie in Create den Hinweisen.

rect
Ein Verweis auf eine RECT Struktur, die die Größe und Position des zu erstellenden Fensters in Clientkoordinaten pParentWndbeschreibt.

pParentWnd
Ein Zeiger auf das Fenster, das das übergeordnete Steuerelement ist.

nID
Die Untergeordnete Fenster-ID des Steuerelements.

Rückgabewert

Nonzero bei erfolgreicher Ausführung andernfalls 0.

Hinweise

Verwenden Sie CreateEx anstelle von Create erweiterten Windows-Formatvorlagen, die durch die Erweiterte Formatvorlage WS_EX_von Windows angegeben werden.

CreateEx erstellt das Steuerelement mit den erweiterten Windows-Formatvorlagen, die durch dwExStyle. Festlegen erweiterter Formatvorlagen, die für ein Steuerelement spezifisch sind.SetExtendedStyle Verwenden Sie CreateEx z. B. zum Festlegen von Formatvorlagen wie WS_EX_CONTEXTHELP, aber zum SetExtendedStyle Festlegen von Formatvorlagen wie TCS_EX_FLATSEPARATORS. Weitere Informationen finden Sie in den formatvorlagen, die in erweiterten Formatvorlagen von Registerkartensteuerelementen im Windows SDK beschrieben werden.

CTabCtrl::CTabCtrl

Erstellt ein CTabCtrl-Objekt.

CTabCtrl();

CTabCtrl::DeleteAllItems

Entfernt alle Elemente aus einem Registerkartensteuerelement.

BOOL DeleteAllItems();

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

CTabCtrl::DeleteItem

Entfernt das angegebene Element aus einem Registerkartensteuerelement.

BOOL DeleteItem(int nItem);

Parameter

nItem
Nullbasierter Wert des zu löschenden Elements.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Beispiel

// This example assumes that there is a CTabCtrl member of the
// CTabDlg class named m_TabCtrl.  On a button handler
// called OnDeleteItem of the dialog box the tab control will
// delete the 0 indexed item.

void CTabDlg::OnDeleteItem()
{
   // Delete the first item in the tab control.
   m_TabCtrl.DeleteItem(0);
}

CTabCtrl::DeselectAll

Setzt Elemente in einem Registerkartensteuerelement zurück, sodass alle gedrückten Elemente gelöscht werden.

void DeselectAll(BOOL fExcludeFocus);

Parameter

fExcludeFocus
Flag, das den Bereich des Elemententwahl angibt. Wenn dieser Parameter auf FALSE festgelegt ist, werden alle Registerkartenschaltflächen zurückgesetzt. Wenn sie auf TRUE", dann werden alle Registerkartenelemente mit Ausnahme der aktuell ausgewählten Elemente zurückgesetzt.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht, TCM_DESELECTALLwie im Windows SDK beschrieben.

CTabCtrl::DrawItem

Wird vom Framework aufgerufen, wenn sich ein visueller Aspekt eines Besitzer-Draw-Registerkartensteuerelements ändert.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Parameter

lpDrawItemStruct
Ein Zeiger auf eine DRAWITEMSTRUCT Struktur, die das zu gezeichnete Element beschreibt.

Hinweise

Das itemAction Element der DRAWITEMSTRUCT Struktur definiert die auszuführende Zeichnungsaktion.

Standardmäßig führt diese Memberfunktion nichts aus. Überschreiben Sie diese Memberfunktion, um die Zeichnung für ein Besitzer-Draw-Objekt CTabCtrl zu implementieren.

Die Anwendung sollte alle GDI-Objekte (Graphics Device Interface) wiederherstellen, die für den angezeigten Kontext ausgewählt lpDrawItemStruct sind, bevor diese Memberfunktion beendet wird.

CTabCtrl::GetCurFocus

Ruft den Index der Registerkarte mit dem aktuellen Fokus ab.

int GetCurFocus() const;

Rückgabewert

Der nullbasierte Index der Registerkarte mit dem aktuellen Fokus.

CTabCtrl::GetCurSel

Ruft die aktuell ausgewählte Registerkarte in einem Registerkartensteuerelement ab.

int GetCurSel() const;

Rückgabewert

Nullbasierter Index der ausgewählten Registerkarte, wenn erfolgreich oder -1, wenn keine Registerkarte ausgewählt ist.

CTabCtrl::GetExtendedStyle

Ruft die erweiterten Formatvorlagen ab, die derzeit für das Registerkartensteuerelement verwendet werden.

DWORD GetExtendedStyle();

Rückgabewert

Stellt die erweiterten Formatvorlagen dar, die derzeit für das Registerkartensteuerelement verwendet werden. Dieser Wert ist eine Kombination aus erweiterten Formatvorlagen für Registerkartensteuerelemente, wie im Windows SDK beschrieben.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TCM_GETEXTENDEDSTYLE, wie im Windows SDK beschrieben.

CTabCtrl::GetImageList

Ruft die einem Tab-Steuerelement zugeordnete Bildliste ab.

CImageList* GetImageList() const;

Rückgabewert

Bei erfolgreicher Ausführung zeigt ein Zeiger auf die Bildliste des Registerkartensteuerelements; andernfalls . NULL

CTabCtrl::GetItem

Ruft Informationen zu einer Registerkarte in einem Registerkartensteuerelement ab.

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

Parameter

nItem
Nullbasierter Index der Registerkarte.

pTabCtrlItem
Zeiger auf eine TCITEM Struktur, die zum Angeben der abzurufenden Informationen verwendet wird. Wird auch verwendet, um Informationen zur Registerkarte zu erhalten. Diese Struktur wird mit den InsertItemFunktionen , GetItemund SetItem Memberfunktionen verwendet.

Rückgabewert

Gibt bei erfolgreicher Ausführung zurück TRUE , FALSE andernfalls.

Hinweise

Wenn die Nachricht gesendet wird, gibt das mask Element an, welche Attribute zurückgegeben werden sollen. Wenn das mask Element den TCIF_TEXT Wert angibt, muss das pszText Element die Adresse des Puffers enthalten, der den Elementtext empfängt, und das cchTextMax Element muss die Größe des Puffers angeben.

• mask

  Wert, der angibt, welche TCITEM Strukturmmber abgerufen oder festgelegt werden sollen. Dieses Element kann null oder eine Kombination der folgenden Werte sein:

  • TCIF_TEXT: Das pszText Element ist gültig.
  • TCIF_IMAGE: Das iImage Element ist gültig.
  • TCIF_PARAM: Das lParam Element ist gültig.
  • TCIF_RTLREADING: Der Text wird mit Leserichtung von pszText rechts nach links auf hebräischen oder arabischen Systemen angezeigt.
  • TCIF_STATE: Das dwState Element ist gültig.

• pszText

  Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Registerkartentext enthält, wenn die Struktur Informationen zu einer Registerkarte enthält. Wenn die Struktur Informationen empfängt, gibt dieses Element die Adresse des Puffers an, der den Registerkartentext empfängt.

• cchTextMax

  Größe des Puffers, auf den verwiesen wird, nach pszText. Dieses Element wird ignoriert, wenn die Struktur keine Informationen empfängt.

• iImage Index in der Bildliste des Registerkartensteuerelements oder -1, wenn für die Registerkarte kein Bild vorhanden ist.

• lParam

  Anwendungsdefinierte Daten, die der Registerkarte zugeordnet sind. Wenn pro Registerkarte mehr als 4 Byte anwendungsdefinierte Daten vorhanden sind, muss eine Anwendung eine Struktur definieren und anstelle der TCITEM Struktur verwenden. Das erste Element der anwendungsdefinierten Struktur muss eine TCITEMHEADERStruktur sein. Die TCITEMHEADER Struktur ist identisch mit der TCITEM Struktur, aber ohne das lParam Element. Der Unterschied zwischen der Größe der Struktur und der Größe der TCITEMHEADER Struktur sollte der Anzahl zusätzlicher Bytes pro Registerkarte entsprechen.

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

CTabCtrl::GetItemCount

Ruft die Anzahl der Registerkarten im Registerkartensteuerelement ab.

int GetItemCount() const;

Rückgabewert

Anzahl der Elemente im Registerkartensteuerelement.

Beispiel

Ein Beispiel hierfür finden Sie unter CPropertySheet::GetTabControl.

CTabCtrl::GetItemRect

Ruft das umgebende Rechteck für die angegebene Registerkarte in einem Registerkartensteuerelement ab.

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

Parameter

nItem
Nullbasierter Index des Registerkartenelements.

lpRect
Zeigen Sie auf eine RECT Struktur, die das umgebende Rechteck der Registerkarte empfängt. Diese Koordinaten verwenden den aktuellen Zuordnungsmodus des Viewports.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Beispiel

Ein Beispiel hierfür finden Sie unter CPropertySheet::GetTabControl.

CTabCtrl::GetItemState

Ruft den Zustand des durch .nItem

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

Parameter

nItem
Die nullbasierte Indexnummer des Elements, für das Statusinformationen abgerufen werden sollen.

dwMask
Maske, die angibt, welche Statuskennzeichnungen des Elements zurückgegeben werden sollen. Eine Liste der Werte finden Sie im Maskenelement der TCITEM Struktur, wie im Windows SDK beschrieben.

Rückgabewert

Ein Verweis auf einen DWORD-Wert, der die Statusinformationen empfängt. Folgenden Werte sind möglich:

Wert	Beschreibung
TCIS_BUTTONPRESSED	Das Registerkartensteuerelement-Element ist ausgewählt.
TCIS_HIGHLIGHTED	Das Registerkartensteuerelement-Element ist hervorgehoben, und die Registerkarte und der Text werden mit der aktuellen Hervorhebungsfarbe gezeichnet. Bei Verwendung der Hervorhebungsfarbe ist dies eine echte Interpolation, keine gestreute Farbe.

Hinweise

Der Status eines Elements wird vom dwState Element der TCITEM Struktur angegeben.

CTabCtrl::GetRowCount

Ruft die aktuelle Anzahl von Zeilen in einem Registerkartensteuerelement ab.

int GetRowCount() const;

Rückgabewert

Die Anzahl der Zeilen von Registerkarten im Registerkartensteuerelement.

Hinweise

Nur Registerkartensteuerelemente mit der TCS_MULTILINE Formatvorlage können mehrere Zeilen mit Registerkarten enthalten.

CTabCtrl::GetToolTips

Ruft den Handle des QuickInfo-Steuerelements ab, das einem Registerkartensteuerelement zugeordnet ist.

CToolTipCtrl* GetToolTips() const;

Rückgabewert

Handle des QuickInfo-Steuerelements bei erfolgreicher Ausführung; andernfalls NULL.

Hinweise

Ein Registerkartensteuerelement erstellt ein QuickInfo-Steuerelement, wenn es über die TCS_TOOLTIPS Formatvorlage verfügt. Sie können einem Registerkartensteuerelement auch ein QuickInfo-Steuerelement zuweisen, indem Sie die SetToolTips Memberfunktion verwenden.

CTabCtrl::HighlightItem

Legt den Hervorhebungsstatus eines Registerkartenelements fest.

BOOL HighlightItem(int idItem,  BOOL fHighlight = TRUE);

Parameter

idItem
Nullbasierter Index eines Registerkartensteuerelementelements.

fHighlight
Wert, der den festzulegenden Hervorhebungszustand angibt. Wenn dieser Wert lautet TRUE, wird die Registerkarte hervorgehoben. Wenn FALSE, wird die Registerkarte auf den Standardzustand festgelegt.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Diese Memberfunktion implementiert die Win32-Nachricht TCM_HIGHLIGHTITEM, wie im Windows SDK beschrieben.

CTabCtrl::HitTest

Bestimmt, welche Registerkarte (falls vorhanden) an der angegebenen Bildschirmposition liegt.

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

Parameter

pHitTestInfo
Zeigen Sie auf eine TCHITTESTINFO Struktur, wie im Windows SDK beschrieben, die die zu testde Bildschirmposition angibt.

Rückgabewert

Gibt den nullbasierten Index der Registerkarte oder -1 zurück, wenn sich keine Registerkarte an der angegebenen Position befindet.

CTabCtrl::InsertItem

Fügt eine neue Registerkarte in ein vorhandenes Registerkartensteuerelement ein.

LONG InsertItem(
    int nItem,
    TCITEM* pTabCtrlItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem,
    int nImage);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam,
    DWORD dwState,
    DWORD dwStateMask);

Parameter

nItem
Nullbasierter Index der neuen Registerkarte.

pTabCtrlItem
Zeigen Sie auf eine TCITEM Struktur, die die Attribute der Registerkarte angibt.

lpszItem
Adresse einer mit Null beendeten Zeichenfolge, die den Text der Registerkarte enthält.

nImage
Der nullbasierte Index eines Bilds, das aus einer Bildliste eingefügt werden soll.

nMask
Gibt an, welche TCITEM Strukturattribute festgelegt werden sollen. Kann null oder eine Kombination der folgenden Werte sein:

• TCIF_TEXT: Das pszText Element ist gültig.
• TCIF_IMAGE: Das iImage Element ist gültig.
• TCIF_PARAM: Das lParam Element ist gültig.
• TCIF_RTLREADING: Der Text wird mit Leserichtung von pszText rechts nach links auf hebräischen oder arabischen Systemen angezeigt.
• TCIF_STATE: Das dwState Element ist gültig.

lParam
Anwendungsdefinierte Daten, die der Registerkarte zugeordnet sind.

dwState
Gibt Werte für die Zustände des Elements an. Weitere Informationen finden Sie im TCITEM Windows SDK.

dwStateMask
Gibt an, welche Zustände festgelegt werden sollen. Weitere Informationen finden Sie im TCITEM Windows SDK.

Rückgabewert

Nullbasierter Index der neuen Registerkarte bei erfolgreicher Ausführung; andernfalls -1.

Beispiel

TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");

m_TabCtrl.InsertItem(0, &tcItem);

CTabCtrl::RemoveImage

Entfernt das angegebene Bild aus der Bildliste eines Registerkartensteuerelements.

void RemoveImage(int nImage);

Parameter

nImage
Nullbasierter Index des zu entfernenden Bilds.

Hinweise

Das Registerkartensteuerelement aktualisiert den Bildindex der einzelnen Registerkarten, sodass jede Registerkarte demselben Bild zugeordnet bleibt.

CTabCtrl::SetCurFocus

Legt den Fokus auf eine angegebene Registerkarte in einem Registerkartensteuerelement fest.

void SetCurFocus(int nItem);

Parameter

nItem
Gibt den Index der Registerkarte an, die den Fokus erhält.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TCM_SETCURFOCUS, wie im Windows SDK beschrieben.

CTabCtrl::SetCurSel

Wählt eine Registerkarte in einem Registerkartensteuerelement aus.

int SetCurSel(int nItem);

Parameter

nItem
Der nullbasierte Index des zu wählenden Elements.

Rückgabewert

Nullbasierter Index der zuvor ausgewählten Registerkarte bei erfolgreicher Ausführung, andernfalls -1.

Hinweise

Ein Registerkartensteuerelement sendet TCN_SELCHANGING keine Benachrichtigung oder TCN_SELCHANGE Benachrichtigung, wenn eine Registerkarte mithilfe dieser Funktion ausgewählt wird. Diese Benachrichtigungen werden mithilfe des WM_NOTIFYKlickens oder Verwendens der Tastatur gesendet, um Registerkarten zu ändern.

CTabCtrl::SetExtendedStyle

Legt die erweiterten Formatvorlagen für ein Registerkartensteuerelement fest.

DWORD SetExtendedStyle(DWORD dwNewStyle, DWORD dwExMask = 0);

Parameter

dwNewStyle
Wert, der eine Kombination aus erweiterten Formatvorlagen des Registerkartensteuerelements angibt.

dwExMask
Ein DWORD-Wert, der angibt, welche Formatvorlagen dwNewStyle betroffen sind. Nur die erweiterten Formatvorlagen dwExMask werden geändert. Alle anderen Stile werden wie folgt beibehalten. Wenn dieser Parameter null ist, sind alle Formatvorlagen dwNewStyle betroffen.

Rückgabewert

Ein DWORD-Wert, der die vorherigen erweiterten Formatvorlagen für Registerkartensteuerelement enthält, wie im Windows SDK beschrieben.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TCM_SETEXTENDEDSTYLE, wie im Windows SDK beschrieben.

CTabCtrl::SetImageList

Weist einem Registerkartensteuerelement eine Bildliste zu.

CImageList* SetImageList(CImageList* pImageList);

Parameter

pImageList
Zeigen Sie auf die Bildliste, die dem Registerkartensteuerelement zugewiesen werden soll.

Rückgabewert

Gibt einen Zeiger auf die vorherige Bildliste zurück oder NULL wenn keine vorherige Bildliste vorhanden ist.

CTabCtrl::SetItem

Legt einige oder alle Attribute einer Registerkarte fest.

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

Parameter

nItem
Nullbasierter Index des Elements.

pTabCtrlItem
Zeigen Sie auf eine TCITEM Struktur, die die neuen Elementattribute enthält. Das mask Element gibt an, welche Attribute festgelegt werden sollen. Wenn das mask Element den TCIF_TEXT Wert angibt, ist das pszText Element die Adresse einer mit Null beendeten Zeichenfolge, und das cchTextMax Element wird ignoriert.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Beispiel

Ein Beispiel hierfür finden Sie unter GetItem.

CTabCtrl::SetItemExtra

Legt die Anzahl der Bytes pro Registerkarte fest, die für anwendungsdefinierte Daten in einem Registerkartensteuerelement reserviert sind.

BOOL SetItemExtra(int nBytes);

Parameter

nBytes
Die Anzahl zusätzlicher Bytes, die festgelegt werden sollen.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TCM_SETITEMEXTRA, wie im Windows SDK beschrieben.

CTabCtrl::SetItemSize

Legt die Breite und Höhe des Registerkarten-Steuerelements fest.

CSize SetItemSize(CSize size);

Parameter

size
Die neue Breite und Höhe des Registerkarten-Steuerelements in Pixeln.

Rückgabewert

Gibt die alte Breite und Höhe des Registerkarten-Steuerelements zurück.

CTabCtrl::SetItemState

Legt den Zustand des durch .nItem

BOOL SetItemState(
    int nItem,
    DWORD dwMask,
    DWORD dwState);

Parameter

nItem
Die nullbasierte Indexnummer des Elements, für das Statusinformationen festgelegt werden sollen.

dwMask
Maske, die angibt, welche Statuskennzeichnungen des Elements festgelegt werden sollen. Eine Liste der Werte finden Sie im Maskenelement der TCITEM Struktur, wie im Windows SDK beschrieben.

dwState
Ein Verweis auf einen DWORD-Wert, der die Statusinformationen enthält. Folgenden Werte sind möglich:

Wert	Beschreibung
TCIS_BUTTONPRESSED	Das Registerkartensteuerelement-Element ist ausgewählt.
TCIS_HIGHLIGHTED	Das Registerkartensteuerelement-Element ist hervorgehoben, und die Registerkarte und der Text werden mit der aktuellen Hervorhebungsfarbe gezeichnet. Bei Verwendung der Hervorhebungsfarbe ist dies eine echte Interpolation, keine gestreute Farbe.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

CTabCtrl::SetMinTabWidth

Legt die mindestbreite von Elementen in einem Registerkartensteuerelement fest.

int SetMinTabWidth(int cx);

Parameter

cx
Mindestbreite, die für ein Registerkartensteuerelementelement festgelegt werden soll. Wenn dieser Parameter auf -1 festgelegt ist, verwendet das Steuerelement die Standardregisterkartenbreite.

Rückgabewert

Die vorherige Minimale Tabstoppbreite.

Hinweise

Diese Memberfunktion implementiert das Verhalten der Win32-Nachricht TCM_SETMINTABWIDTH, wie im Windows SDK beschrieben.

CTabCtrl::SetPadding

Legt den Abstand um das Symbol und die Beschriftung der einzelnen Registerkarten in einem Registerkartensteuerelement fest.

void SetPadding(CSize size);

Parameter

size
Legt den Abstand um das Symbol und die Beschriftung der einzelnen Registerkarten in einem Registerkartensteuerelement fest.

CTabCtrl::SetToolTips

Weist einem Registerkartensteuerelement ein QuickInfo-Steuerelement zu.

void SetToolTips(CToolTipCtrl* pWndTip);

Parameter

pWndTip
Handle des QuickInfo-Steuerelements.

Hinweise

Sie können das QuickInfo-Steuerelement abrufen, das einem Registerkartensteuerelement zugeordnet ist, indem Sie einen Aufruf ausführen GetToolTips.

Beispiel

Ein Beispiel hierfür finden Sie unter CPropertySheet::GetTabControl.

Siehe auch

CWnd Klasse
CHeaderCtrl Klasse
CListCtrl Klasse
Hierarchiediagramm