Registerkarte (Windows-Steuerelemente)
Dieser Abschnitt enthält Informationen zu den Programmierelementen, die mit Registerkartensteuerelementen verwendet werden.
Übersichten
| Thema | Inhalte |
|---|---|
| Informationen zu Registerkartensteuerelementen | Ein Registerkarten-Steuerelement entspricht in etwa einem Trennblatt in einem Notizbuch den Beschriftungen in einer Hängeregistratur. Durch Verwenden eines Registerkarten-Steuerelements können in einer Anwendung mehrere Seiten für denselben Bereich in einem Fenster oder Dialogfeld definiert werden. |
| Verwenden von Registerkartensteuerelementen | Dieses Thema enthält zwei Beispiele, in denen Registerkartensteuerelemente verwendet werden. |
Makros
| Thema | Inhalte |
|---|---|
| TabCtrl_AdjustRect | Berechnet den Anzeigebereich eines Registerkartensteuerelements für ein Fensterrechteck oder berechnet das Fensterrechteck, das einem angegebenen Anzeigebereich entsprechen würde. Sie können dieses Makro verwenden oder die TCM_ADJUSTRECT Nachricht explizit senden. |
| TabCtrl_DeleteAllItems | Entfernt alle Elemente aus einem Registerkartensteuerelement. Sie können dieses Makro verwenden oder die TCM_DELETEALLITEMS Nachricht explizit senden. |
| TabCtrl_DeleteItem | Entfernt ein Element aus einem Registerkartensteuerelement. Sie können dieses Makro verwenden oder die TCM_DELETEITEM Nachricht explizit senden. |
| TabCtrl_DeselectAll | Setzt Elemente in einem Registerkartensteuerelement zurück, und löscht alle Elemente, die auf den TCIS_BUTTONPRESSED-Zustand festgelegt wurden. Sie können dieses Makro verwenden oder die TCM_DESELECTALL Nachricht explizit senden. |
| TabCtrl_GetCurFocus | Gibt den Index des Elements zurück, das den Fokus in einem Registerkartensteuerelement hat. Sie können dieses Makro verwenden oder die TCM_GETCURFOCUS Nachricht explizit senden. |
| TabCtrl_GetCurSel | Bestimmt die aktuell ausgewählte Registerkarte in einem Registerkartensteuerelement. Sie können dieses Makro verwenden oder die TCM_GETCURSEL Nachricht explizit senden. |
| TabCtrl_GetExtendedStyle | Ruft die erweiterten Stile ab, die derzeit für das Registerkartensteuerelement verwendet werden. Sie können dieses Makro verwenden oder die TCM_GETEXTENDEDSTYLE Nachricht explizit senden. |
| TabCtrl_GetImageList | Ruft die Bildliste ab, die einem Registerkartensteuerelement zugeordnet ist. Sie können dieses Makro verwenden oder die TCM_GETIMAGELIST Nachricht explizit senden. |
| TabCtrl_GetItem | Ruft Informationen zu einer Registerkarte in einem Registerkartensteuerelement ab. Sie können dieses Makro verwenden oder die TCM_GETITEM Nachricht explizit senden. |
| TabCtrl_GetItemCount | Ruft die Anzahl der Registerkarten im Registerkartensteuerelement ab. Sie können dieses Makro verwenden oder die TCM_GETITEMCOUNT Nachricht explizit senden. |
| TabCtrl_GetItemRect | Ruft das umgebende Rechteck für eine Registerkarte in einem Registerkartensteuerelement ab. Sie können dieses Makro verwenden oder die TCM_GETITEMRECT Nachricht explizit senden. |
| TabCtrl_GetRowCount | Ruft die aktuelle Anzahl von Zeilen von Registerkarten in einem Registerkartensteuerelement ab. Sie können dieses Makro verwenden oder die TCM_GETROWCOUNT Nachricht explizit senden. |
| TabCtrl_GetToolTips | Ruft das Handle zum QuickInfo-Steuerelement ab, das einem Registerkartensteuerelement zugeordnet ist. Sie können dieses Makro verwenden oder die TCM_GETTOOLTIPS Nachricht explizit senden. |
| TabCtrl_GetUnicodeFormat | Ruft das UNICODE-Zeichenformatflag für das Steuerelement ab. Sie können dieses Makro verwenden oder die TCM_GETUNICODEFORMAT Nachricht explizit senden. |
| TabCtrl_HighlightItem | Legt den Hervorhebungsstatus eines Registerkartenelements fest. Sie können dieses Makro verwenden oder die TCM_HIGHLIGHTITEM Nachricht explizit senden. |
| TabCtrl_HitTest | Bestimmt, welche Registerkarte sich an einer angegebenen Bildschirmposition befindet, falls vorhanden. Sie können dieses Makro verwenden oder die TCM_HITTEST-Nachricht explizit senden. |
| TabCtrl_InsertItem | Fügt eine neue Registerkarte in ein Registerkartensteuerelement ein. Sie können dieses Makro verwenden oder die TCM_INSERTITEM Nachricht explizit senden. |
| TabCtrl_RemoveImage | Entfernt ein Bild aus der Bildliste eines Registerkartensteuerelements. Sie können dieses Makro verwenden oder die TCM_REMOVEIMAGE Nachricht explizit senden. |
| TabCtrl_SetCurFocus | Legt den Fokus auf eine angegebene Registerkarte in einem Registerkartensteuerelement fest. Sie können dieses Makro verwenden oder die TCM_SETCURFOCUS Nachricht explizit senden. |
| TabCtrl_SetCurSel | Wählt eine Registerkarte in einem Registerkartensteuerelement aus. Sie können dieses Makro verwenden oder die TCM_SETCURSEL Nachricht explizit senden. |
| TabCtrl_SetExtendedStyle | Legt die erweiterten Stile fest, die das Registerkartensteuerelement verwendet. Sie können dieses Makro verwenden oder die TCM_SETEXTENDEDSTYLE Nachricht explizit senden. |
| TabCtrl_SetImageList | Weist einem Registerkartensteuerelement eine Bildliste zu. Sie können dieses Makro verwenden oder die TCM_SETIMAGELIST Nachricht explizit senden. |
| TabCtrl_SetItem | Legt einige oder alle Attribute einer Registerkarte fest. Sie können dieses Makro verwenden oder die TCM_SETITEM Nachricht explizit senden. |
| TabCtrl_SetItemExtra | Legt die Anzahl der Bytes pro Registerkarte fest, die für anwendungsdefinierte Daten in einem Registerkartensteuerelement reserviert ist. Sie können dieses Makro verwenden oder die TCM_SETITEMEXTRA Nachricht explizit senden. |
| TabCtrl_SetItemSize | Legt die Breite und Höhe von Registerkarten in einem Steuerelement mit fester Breite oder einem vom Besitzer gezeichneten Registerkarten fest. Sie können dieses Makro verwenden oder die TCM_SETITEMSIZE-Nachricht explizit senden. |
| TabCtrl_SetMinTabWidth | Legt die Mindestbreite von Elementen in einem Registerkartensteuerelement fest. Sie können dieses Makro verwenden oder die TCM_SETMINTABWIDTH Nachricht explizit senden. |
| TabCtrl_SetPadding | Legt den Speicherplatz (Auffüllung) um das Symbol und die Bezeichnung jeder Registerkarte in einem Registerkartensteuerelement fest. Sie können dieses Makro verwenden oder die TCM_SETPADDING Nachricht explizit senden. |
| TabCtrl_SetToolTips | Weist einem Registerkartensteuerelement ein QuickInfo-Steuerelement zu. Sie können dieses Makro verwenden oder die TCM_SETTOOLTIPS Nachricht explizit senden. |
| TabCtrl_SetUnicodeFormat | Legt das Unicode-Zeichenformatflag für das Steuerelement fest. Mit dieser Meldung können Sie den vom Steuerelement verwendeten Zeichensatz zur Laufzeit ändern, anstatt das Steuerelement neu erstellen zu müssen. Sie können dieses Makro verwenden oder die TCM_SETUNICODEFORMAT-Nachricht explizit senden. |
Nachrichten
| Thema | Inhalte |
|---|---|
| TCM_ADJUSTRECT | Berechnet den Anzeigebereich eines Registerkartensteuerelements für ein Fensterrechteck oder berechnet das Fensterrechteck, das einem angegebenen Anzeigebereich entsprechen würde. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_AdjustRect senden. |
| TCM_DELETEALLITEMS | Entfernt alle Elemente aus einem Registerkartensteuerelement. Sie können diese Nachricht explizit oder mithilfe des Makros TabCtrl_DeleteAllItems senden. |
| TCM_DELETEITEM | Entfernt ein Element aus einem Registerkartensteuerelement. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_DeleteItem senden. |
| TCM_DESELECTALL | Setzt Elemente in einem Registerkartensteuerelement zurück, und löscht alle Elemente, die auf den TCIS_BUTTONPRESSED-Zustand festgelegt wurden. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_DeselectAll senden. |
| TCM_GETCURFOCUS | Gibt den Index des Elements zurück, das den Fokus in einem Registerkartensteuerelement hat. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_GetCurFocus senden. |
| TCM_GETCURSEL | Bestimmt die aktuell ausgewählte Registerkarte in einem Registerkartensteuerelement. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_GetCurSel senden. |
| TCM_GETEXTENDEDSTYLE | Ruft die erweiterten Stile ab, die derzeit für das Registerkartensteuerelement verwendet werden. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_GetExtendedStyle senden. |
| TCM_GETIMAGELIST | Ruft die Bildliste ab, die einem Registerkartensteuerelement zugeordnet ist. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_GetImageList senden. |
| TCM_GETITEM | Ruft Informationen zu einer Registerkarte in einem Registerkartensteuerelement ab. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_GetItem senden. |
| TCM_GETITEMCOUNT | Ruft die Anzahl der Registerkarten im Registerkartensteuerelement ab. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_GetItemCount senden. |
| TCM_GETITEMRECT | Ruft das umgebende Rechteck für eine Registerkarte in einem Registerkartensteuerelement ab. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_GetItemRect senden. |
| TCM_GETROWCOUNT | Ruft die aktuelle Anzahl von Zeilen von Registerkarten in einem Registerkartensteuerelement ab. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_GetRowCount senden. |
| TCM_GETTOOLTIPS | Ruft das Handle zum QuickInfo-Steuerelement ab, das einem Registerkartensteuerelement zugeordnet ist. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_GetToolTips senden. |
| TCM_GETUNICODEFORMAT | Ruft das Unicode-Zeichenformatflag für das Steuerelement ab. Sie können diese Nachricht explizit senden oder das makro TabCtrl_GetUnicodeFormat verwenden. |
| TCM_HIGHLIGHTITEM | Legt den Hervorhebungsstatus eines Registerkartenelements fest. Sie können diese Nachricht explizit oder mithilfe des Makros TabCtrl_HighlightItem senden. |
| TCM_HITTEST | Bestimmt, welche Registerkarte sich an einer angegebenen Bildschirmposition befindet, falls vorhanden. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_HitTest senden. |
| TCM_INSERTITEM | Fügt eine neue Registerkarte in ein Registerkartensteuerelement ein. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_InsertItem senden. |
| TCM_REMOVEIMAGE | Entfernt ein Bild aus der Bildliste eines Registerkartensteuerelements. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_RemoveImage senden. |
| TCM_SETCURFOCUS | Legt den Fokus auf eine angegebene Registerkarte in einem Registerkartensteuerelement fest. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_SetCurFocus-Makros senden. |
| TCM_SETCURSEL | Wählt eine Registerkarte in einem Registerkartensteuerelement aus. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_SetCurSel senden. |
| TCM_SETEXTENDEDSTYLE | Legt die erweiterten Stile fest, die das Registerkartensteuerelement verwendet. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_SetExtendedStyle senden. |
| TCM_SETIMAGELIST | Weist einem Registerkartensteuerelement eine Bildliste zu. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_SetImageList senden. |
| TCM_SETITEM | Legt einige oder alle Attribute einer Registerkarte fest. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_SetItem senden. |
| TCM_SETITEMEXTRA | Legt die Anzahl der Bytes pro Registerkarte fest, die für anwendungsdefinierte Daten in einem Registerkartensteuerelement reserviert ist. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_SetItemExtra senden. |
| TCM_SETITEMSIZE | Legt die Breite und Höhe von Registerkarten in einem Steuerelement mit fester Breite oder einem vom Besitzer gezeichneten Registerkarten fest. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_SetItemSize senden. |
| TCM_SETMINTABWIDTH | Legt die Mindestbreite von Elementen in einem Registerkartensteuerelement fest. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_SetMinTabWidth senden. |
| TCM_SETPADDING | Legt den Speicherplatz (Auffüllung) um das Symbol und die Bezeichnung jeder Registerkarte in einem Registerkartensteuerelement fest. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_SetPadding senden. |
| TCM_SETTOOLTIPS | Weist einem Registerkartensteuerelement ein QuickInfo-Steuerelement zu. Sie können diese Nachricht explizit oder mithilfe des makros TabCtrl_SetToolTips senden. |
| TCM_SETUNICODEFORMAT | Legt das Unicode-Zeichenformatflag für das Steuerelement fest. Mit dieser Meldung können Sie den vom Steuerelement verwendeten Zeichensatz zur Laufzeit ändern, anstatt das Steuerelement neu erstellen zu müssen. Sie können diese Nachricht explizit senden oder das makro TabCtrl_SetUnicodeFormat verwenden. |
Benachrichtigungen
| Thema | Inhalte |
|---|---|
| NM_CLICK (Registerkarte) | Benachrichtigt das übergeordnete Fenster eines Registerkartensteuerelements, dass der Benutzer auf die linke Maustaste im Steuerelement geklickt hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. |
| NM_DBLCLK (Registerkarte) | Benachrichtigt ein übergeordnetes Fenster eines Registerkartensteuerelements, dass der Benutzer auf die linke Maustaste im Steuerelement doppelklicken hat. Diese Benachrichtigung wird in Form einer WM_NOTIFY-Nachricht gesendet. |
| NM_RCLICK (Registerkarte) | Benachrichtigt das übergeordnete Fenster eines Registerkartensteuerelements, dass der Benutzer auf die rechte Maustaste im Steuerelement geklickt hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. |
| NM_RDBLCLK (Registerkarte) | Benachrichtigt das übergeordnete Fenster eines Registerkartensteuerelements, dass der Benutzer auf die rechte Maustaste im Steuerelement doppelklicken hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. |
| NM_RELEASEDCAPTURE (Registerkarte) | Benachrichtigt das übergeordnete Fenster eines Registerkartensteuerelements, dass das Steuerelement die Mausaufnahme freigibt. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. |
| TCN_FOCUSCHANGE | Benachrichtigt das übergeordnete Fenster eines Registerkartensteuerelements, dass der Schaltflächenfokus geändert wurde. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. |
| TCN_GETOBJECT | Wird von einem Registerkartensteuerelement gesendet, wenn es über die TCS_EX_REGISTERDROP erweiterten Stil verfügt und ein Objekt über ein Registerkartenelement im Steuerelement gezogen wird. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. |
| TCN_KEYDOWN | Benachrichtigt das übergeordnete Fenster eines Registerkartensteuerelements, dass eine Taste gedrückt wurde. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. |
| TCN_SELCHANGE | Benachrichtigt das übergeordnete Fenster eines Registerkartensteuerelements, dass die aktuell ausgewählte Registerkarte geändert wurde. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. |
| TCN_SELCHANGING | Benachrichtigt das übergeordnete Fenster eines Registerkartensteuerelements, dass die aktuell ausgewählte Registerkarte im Moment geändert werden soll. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. |
Strukturen
| Thema | Inhalte |
|---|---|
| NMTCKEYDOWN | Enthält Informationen zu einem Tastendruck in einem Registerkartensteuerelement. Sie wird mit dem TCN_KEYDOWN Benachrichtigungscode verwendet. Diese Struktur ersetzt die TC_KEYDOWN-Struktur . |
| TCHITTESTINFO | Enthält Informationen zu einem Treffertest. Diese Struktur ersetzt die TC_HITTESTINFO-Struktur . |
| TCITEM | Gibt die Attribute eines Registerkartenelements an oder empfängt sie. Es wird mit den TCM_INSERTITEM-, TCM_GETITEM- und TCM_SETITEM-Nachrichten verwendet. Diese Struktur ersetzt die TC_ITEM-Struktur . |
| TCITEMHEADER | Gibt die Attribute einer Registerkarte an oder empfängt sie. Es wird mit den TCM_INSERTITEM-, TCM_GETITEM- und TCM_SETITEM-Nachrichten verwendet. Diese Struktur ersetzt die TC_ITEMHEADER-Struktur . |
Konstanten
| Thema | Inhalte |
|---|---|
| Erweiterte Formatvorlagen für Registerkartensteuerelemente | Das Registerkartensteuerelement unterstützt jetzt erweiterte Stile. Diese Stile werden mithilfe der TCM_GETEXTENDEDSTYLE und TCM_SETEXTENDEDSTYLE Meldungen bearbeitet und sollten nicht mit erweiterten Fensterstilen verwechselt werden, die an CreateWindowEx übergeben werden. |
| Elementstatus des Registerkartensteuerelements | Registerkartensteuerelementelemente unterstützen jetzt einen Elementzustand, um die TCM_DESELECTALL Nachricht zu unterstützen. Darüber hinaus unterstützt die TCITEM-Struktur Elementzustandswerte. |
| Formatvorlagen für Registerkartensteuerelemente | In diesem Abschnitt werden die unterstützten Steuerelementstile für Registerkarten aufgeführt. |