Registerkarte (Windows-Steuerelemente)
Dieser Abschnitt enthält Informationen zu den Programmierelementen, die mit Registerkartensteuerelementen verwendet werden.
Überblicke
| Thema | Inhalt |
|---|---|
| Zu Registerkartensteuerelementen | Ein Registerkartensteuerelement entspricht den Trennern in einem Notizbuch oder den Beschriftungen in einem Dateischrank. Mithilfe eines Registerkartensteuerelements kann eine Anwendung mehrere Seiten für denselben Bereich eines Fensters oder Dialogfelds definieren. |
| Verwenden von Registerkartensteuerelementen | Dieses Thema enthält zwei Beispiele, in denen Registerkartensteuerelemente verwendet werden. |
Macros
| Thema | Inhalt |
|---|---|
| TabCtrl_AdjustRect | Berechnet den Anzeigebereich eines Registerkartensteuerelements aufgrund eines Fensterrechtecks oder berechnet das Fensterrechteck, das einem angegebenen Anzeigebereich entspricht. 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, sodass alle Elemente gelöscht werden, 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 Formatvorlagen 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-Zeichenformat-Flag 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 (falls vorhanden) an einer angegebenen Bildschirmposition liegt. 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 Formatvorlagen fest, die vom Registerkartensteuerelement verwendet werden. 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 sind. 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 durch 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 Abstand (Abstand) um das Symbol und die Beschriftung der einzelnen Registerkarten 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-Zeichenformat-Flag für das Steuerelement fest. Mit dieser Meldung können Sie den zeichensatz ändern, der vom Steuerelement zur Laufzeit verwendet wird, anstatt das Steuerelement erneut erstellen zu müssen. Sie können dieses Makro verwenden oder die TCM_SETUNICODEFORMAT Nachricht explizit senden. |
Meldungen
| Thema | Inhalt |
|---|---|
| TCM_ADJUSTRECT | Berechnet den Anzeigebereich eines Registerkartensteuerelements aufgrund eines Fensterrechtecks oder berechnet das Fensterrechteck, das einem angegebenen Anzeigebereich entspricht. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_AdjustRect-Makros senden. |
| TCM_DELETEALLITEMS | Entfernt alle Elemente aus einem Registerkartensteuerelement. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_DeleteAllItems Makros senden. |
| TCM_DELETEITEM | Entfernt ein Element aus einem Registerkartensteuerelement. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_DeleteItem-Makros senden. |
| TCM_DESELECTALL | Setzt Elemente in einem Registerkartensteuerelement zurück, sodass alle Elemente gelöscht werden, die auf den TCIS_BUTTONPRESSED Zustand festgelegt wurden. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_DeselectAll-Makros 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 TabCtrl_GetCurFocus Makros senden. |
| TCM_GETCURSEL | Bestimmt die aktuell ausgewählte Registerkarte in einem Registerkartensteuerelement. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_GetCurSel Makros senden. |
| TCM_GETEXTENDEDSTYLE | Ruft die erweiterten Formatvorlagen ab, die derzeit für das Registerkartensteuerelement verwendet werden. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_GetExtendedStyle-Makros senden. |
| TCM_GETIMAGELIST | Ruft die Bildliste ab, die einem Registerkartensteuerelement zugeordnet ist. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_GetImageList Makros senden. |
| TCM_GETITEM | Ruft Informationen zu einer Registerkarte in einem Registerkartensteuerelement ab. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_GetItem Makros senden. |
| TCM_GETITEMCOUNT | Ruft die Anzahl der Registerkarten im Registerkartensteuerelement ab. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_GetItemCount Makros senden. |
| TCM_GETITEMRECT | Ruft das umgebende Rechteck für eine Registerkarte in einem Registerkartensteuerelement ab. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_GetItemRect Makros senden. |
| TCM_GETROWCOUNT | Ruft die aktuelle Anzahl von Zeilen von Registerkarten in einem Registerkartensteuerelement ab. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_GetRowCount Makros senden. |
| TCM_GETTOOLTIPS | Ruft das Handle zum QuickInfo-Steuerelement ab, das einem Registerkartensteuerelement zugeordnet ist. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_GetToolTips Makros senden. |
| TCM_GETUNICODEFORMAT | Ruft das Unicode-Zeichenformat-Flag für das Steuerelement ab. Sie können diese Nachricht explizit senden oder das TabCtrl_GetUnicodeFormat-Makro verwenden. |
| TCM_HIGHLIGHTITEM | Legt den Hervorhebungsstatus eines Registerkartenelements fest. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_HighlightItem Makros senden. |
| TCM_HITTEST | Bestimmt, welche Registerkarte (falls vorhanden) an einer angegebenen Bildschirmposition liegt. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_HitTest-Makros senden. |
| TCM_INSERTITEM | Fügt eine neue Registerkarte in ein Registerkartensteuerelement ein. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_InsertItem-Makros senden. |
| TCM_REMOVEIMAGE | Entfernt ein Bild aus der Bildliste eines Registerkartensteuerelements. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_RemoveImage Makros 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 TabCtrl_SetCurSel-Makros senden. |
| TCM_SETEXTENDEDSTYLE | Legt die erweiterten Formatvorlagen fest, die vom Registerkartensteuerelement verwendet werden. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_SetExtendedStyle Makros senden. |
| TCM_SETIMAGELIST | Weist einem Registerkartensteuerelement eine Bildliste zu. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_SetImageList Makros senden. |
| TCM_SETITEM | Legt einige oder alle Attribute einer Registerkarte fest. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_SetItem Makros senden. |
| TCM_SETITEMEXTRA | Legt die Anzahl der Bytes pro Registerkarte fest, die für anwendungsdefinierte Daten in einem Registerkartensteuerelement reserviert sind. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_SetItemExtra Makros senden. |
| TCM_SETITEMSIZE | Legt die Breite und Höhe von Registerkarten in einem Steuerelement mit fester Breite oder durch Besitzer gezeichneten Registerkarten fest. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_SetItemSize Makros senden. |
| TCM_SETMINTABWIDTH | Legt die mindestbreite von Elementen in einem Registerkartensteuerelement fest. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_SetMinTabWidth Makros senden. |
| TCM_SETPADDING | Legt den Abstand (Abstand) um das Symbol und die Beschriftung der einzelnen Registerkarten in einem Registerkartensteuerelement fest. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_SetPadding-Makros senden. |
| TCM_SETTOOLTIPS | Weist einem Registerkartensteuerelement ein QuickInfo-Steuerelement zu. Sie können diese Nachricht explizit oder mithilfe des TabCtrl_SetToolTips Makros senden. |
| TCM_SETUNICODEFORMAT | Legt das Unicode-Zeichenformat-Flag für das Steuerelement fest. Mit dieser Meldung können Sie den zeichensatz ändern, der vom Steuerelement zur Laufzeit verwendet wird, anstatt das Steuerelement erneut erstellen zu müssen. Sie können diese Nachricht explizit senden oder das TabCtrl_SetUnicodeFormat Makro verwenden. |
Benachrichtigungen
| Thema | Inhalt |
|---|---|
| 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 loslässt. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. |
| TCN_FOCUSCHANGE | Benachrichtigt das übergeordnete Fenster eines Registerkartensteuerelements, dass sich der Fokus der Schaltfläche geändert hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. |
| TCN_GETOBJECT | Wird von einem Registerkartensteuerelement gesendet, wenn es die TCS_EX_REGISTERDROP erweiterten Formatvorlage aufweist 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 sich die aktuell ausgewählte Registerkarte geändert hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. |
| TCN_SELCHANGING | Benachrichtigt das übergeordnete Fenster eines Registerkartensteuerelements, dass sich die aktuell ausgewählte Registerkarte ändert. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet. |
Strukturen
| Thema | Inhalt |
|---|---|
| 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. Sie wird zusammen mit den nachrichten TCM_INSERTITEM, TCM_GETITEMund TCM_SETITEM verwendet. Diese Struktur ersetzt die TC_ITEM Struktur. |
| TCITEMHEADER- | Gibt die Attribute einer Registerkarte an oder empfängt sie. Sie wird zusammen mit den nachrichten TCM_INSERTITEM, TCM_GETITEMund TCM_SETITEM verwendet. Diese Struktur ersetzt die TC_ITEMHEADER Struktur. |
Konstanten
| Thema | Inhalt |
|---|---|
| erweiterte Formatvorlagen Registerkartensteuerelement | Das Registerkartensteuerelement unterstützt jetzt erweiterte Formatvorlagen. Diese Formatvorlagen werden mithilfe der TCM_GETEXTENDEDSTYLE und TCM_SETEXTENDEDSTYLE Nachrichten bearbeitet und sollten nicht mit erweiterten Fensterformatvorlagen verwechselt werden, die an CreateWindowExübergeben werden. |
| Status des Registerkartensteuerelements | Registerkartensteuerelementelemente unterstützen jetzt einen Elementstatus, um die TCM_DESELECTALL Nachricht zu unterstützen. Darüber hinaus unterstützt die TCITEM- Struktur Elementstatuswerte. |
| Formatvorlagen für Registerkartensteuerelemente | In diesem Abschnitt werden unterstützte Formatvorlagen für Registerkartensteuerelemente aufgeführt. |