Freigeben über


Allgemeine Steuerelementreferenz

Dieser Abschnitt enthält Referenzinformationen zu Programmierelementen, die für mehrere Steuerelemente gelten, nicht nur für ein bestimmtes Steuerelement. Es gibt Funktionen, Makros, Nachrichten, Benachrichtigungen und Strukturen, die die meisten Steuerelemente unterstützen. Die meisten Steuerelemente verwenden beispielsweise die NM_HOVER Benachrichtigungen, um Mausklicks zu verarbeiten.

Überblicke

Thema Inhalt
zu allgemeinen Steuerelementen Die allgemeinen Steuerelemente sind eine Reihe von Fenstern, die von der allgemeinen Steuerelementbibliothek implementiert werden, bei der es sich um eine DLL handelt, die im Windows-Betriebssystem enthalten ist.
Häufig gestellte Fragen zu steuerelementen Diese häufig gestellten Fragen enthalten Antworten auf einige häufig gestellte Fragen zu den allgemeinen Steuerelementen.

Funktionen

Thema Inhalt
DoReaderMode- Aktiviert den Lesemodus in einem Fenster.
DPA_Clone Dupliziert ein dynamisches Zeigerarray (DPA).
DPA_Create Erstellt einen DPA.
DPA_CreateEx Erstellt einen DPA mit einer bestimmten angegebenen Größe und heap-Position.
DPA_DeleteAllPtrs Entfernt alle Elemente aus einem DPA und verkleinert den DPA entsprechend.
DPA_DeletePtr Entfernt ein Element aus einer DPA. Der DPA wird bei Bedarf verkleinern, um das entfernte Element aufzunehmen.
DPA_Destroy Gibt ein dynamisches Zeigerarray (Dynamic Pointer Array, DPA) frei.
DPA_DestroyCallback Ruft pfnCB- für jedes Element der DPA auf und gibt dann die DPA frei.
DPA_EnumCallback Durchlaufen Sie das Dynamische Zeigerarray (Dynamic Pointer Array, DPA) und ruft pfnCB- für jedes Element auf.
DPA_GetPtr Ruft ein Element aus einer DPA ab.
DPA_GetPtrIndex Ruft den Index eines übereinstimmenden Elements ab, das in einer DPA gefunden wird.
DPA_GetSize Ruft die Größe eines DPA ab.
DPA_Grow Ändert die Anzahl der Zeiger in einem DPA.
DPA_InsertPtr Fügt ein neues Element an einer angegebenen Position in einem DPA ein. Bei Bedarf wird der DPA erweitert, um das neue Element aufzunehmen.
DPA_LoadStream Lädt den DPA aus einem Datenstrom, indem die angegebene Rückruffunktion aufgerufen wird, um die einzelnen Elemente zu lesen.
DPA_Merge Kombiniert den Inhalt von zwei DPAs.
DPA_SaveStream Speichert den DPA in einem Datenstrom, indem er einen Header ausschreiben und dann die angegebene Rückruffunktion aufruft, um jedes Element zu schreiben.
DPA_Search Sucht ein Element in einem DPA.
DPA_SetPtr Weist einem Element in einer DPA einen Wert zu.
DPA_Sort Sortiert die Elemente in einem dynamischen Zeigerarray (Dynamic Pointer Array, DPA).
DrawShadowText- Zeichnet Text mit einem Schatten.
DrawTextExPrivWrap Zeichnet formatierten Text im angegebenen Rechteck. Diese Funktion umschließt einen Aufruf von DrawTextEx-.
DrawTextWrap- Zeichnet formatierten Text im angegebenen Rechteck. Er formatiert den Text gemäß der angegebenen Methode (Erweitern von Tabstopps, Blocksatzzeichen, Zeilentrennung usw.). Diese Funktion umschließt einen Aufruf von DrawText-.
DSA_Clone Dupliziert ein dynamisches Strukturarray (DSA).
DSA_Create Erstellt eine DSA.
DSA_DeleteAllItems Löscht alle Elemente aus einer DSA.
DSA_DeleteItem Löscht ein Element aus einer DSA.
DSA_Destroy Gibt eine DSA frei.
DSA_DestroyCallback Durchläuft eine DSA, wobei für jedes Element eine angegebene Rückruffunktion aufgerufen wird. Nach Erreichen des Endes des Arrays wird die DSA freigegeben.
DSA_EnumCallback Durchläuft die DSA und ruft pfnCB- für jedes Element auf.
DSA_GetItem Ruft ein Element aus einer DSA ab.
DSA_GetItemPtr Ruft einen Zeiger auf ein Element aus einer DSA ab.
DSA_GetSize Ruft die Größe der DSA ab.
DSA_InsertItem Fügt ein neues Element in eine DSA ein. Bei Bedarf wird die DSA erweitert, um das neue Element aufzunehmen.
DSA_SetItem Legt den Inhalt eines Elements in einer DSA fest.
DSA_Sort Sortiert die Elemente in einer DSA.
ExtTextOutWrap- Zeichnet Text mithilfe der aktuell ausgewählten Schriftart, der Hintergrundfarbe und der Textfarbe. Sie können optional Abmessungen bereitstellen, die für Clipping, Deckkraft oder beides verwendet werden sollen. Diese Funktion umschließt einen Aufruf von ExtTextOut-.
GetEffectiveClientRect- Berechnet die Dimensionen eines Rechtecks im Clientbereich, der alle angegebenen Steuerelemente enthält.
GetMUILanguage Ruft die Sprache ab, die derzeit von den allgemeinen Steuerelementen für einen bestimmten Prozess verwendet wird.
GetTextExtentPoint32Wrap- Berechnet die Breite und Höhe der angegebenen Textzeichenfolge. Diese Funktion umschließt einen Aufruf von GetTextExtentPoint.
InitCommonControls- Registriert und initialisiert bestimmte allgemeine Steuerelementfensterklassen. Diese Funktion ist veraltet. Neue Anwendungen sollten die InitCommonControlsEx--Funktion verwenden.
InitCommonControlsEx- Registriert bestimmte allgemeine Steuerelementklassen aus der allgemeinen Steuerelement-DLL.
InitMUILanguage Ermöglicht es einer Anwendung, eine Sprache anzugeben, die mit den allgemeinen Steuerelementen verwendet werden soll, die sich von der Systemsprache unterscheiden.
LoadIconMetric- Lädt eine angegebene Symbolressource mit einer clientspezifischen Systemmetrik.
LoadIconWithScaleDown- Lädt ein Symbol. Wenn das Symbol keine Standardgröße ist, skaliert diese Funktion ein größeres Bild nach unten, anstatt ein kleineres Bild zu skalieren.
MirrorIcon- Umgekehrte Symbole (Spiegel) so, dass sie ordnungsgemäß in einem gespiegelten Gerätekontext angezeigt werden.
PFNDACOMPARE- Definiert den Prototyp für die Vergleichsfunktion, die von DSA_Sortverwendet wird.
PFNDACOMPARECONST Definiert den Prototyp für die Vergleichsfunktion, die von DSA_Sort verwendet wird, wenn die zu vergleichenden Elemente Konstantenobjekte sind.
PFNDAENUMCALLBACK Definiert den Prototyp für die Rückruffunktion, die von DSA- und DPA-Funktionen verwendet wird.
PFNDAENUMCALLBACKCONST Definiert den Prototyp für die Rückruffunktion, die von DSA- und DPA-Funktionen verwendet wird, wenn die beteiligten Elemente Zeiger auf konstanten Daten sind.
PFNDPACOMPARE- Definiert den Prototyp für die Vergleichsfunktion, die von DPA_Sort und DPA_Searchverwendet wird.
PFNDPACOMPARECONST Definiert den Prototyp für die Vergleichsfunktion, die von DPA_Sort oder DPA_Search verwendet wird, wenn die zu vergleichenden Elemente Konstantenobjekte sind.
PFNDPAENUMCALLBACK Definiert den Prototyp für die Rückruffunktion, die von DPA_EnumCallbackverwendet wird.
PFNDPAMERGE Definiert den Prototyp für die Zusammenführungsfunktion, die von DPA_Mergeverwendet wird.
PFNDPAMERGECONST Definiert den Prototyp für die Zusammenführungsfunktion, die von DPA_Mergeverwendet wird, mithilfe von Konstantenwerten.
PFNDPASTREAM- Definiert den Prototyp für die Rückruffunktion, die von DPA_LoadStream und DPA_SaveStreamverwendet wird.
PFNDSAENUMCALLBACK Definiert den Prototyp für die Rückruffunktion, die von DSA_DestroyCallbackverwendet wird.
ReaderScroll- Eine anwendungsdefinierte Rückruffunktion, die verwendet wird, wenn der Mauszeiger innerhalb des Teils des Lesemodusfensters verschoben wird, das als aktiver Bildlaufbereich deklariert wurde.
ShowHideMenuCtl Legt das Häkchen-Attribut des angegebenen Menüelements fest oder entfernt es und blendet das entsprechende Steuerelement ein oder aus. Die Funktion fügt dem angegebenen Menüelement ein Häkchen hinzu, wenn es nicht über eins verfügt, und zeigt dann das entsprechende Steuerelement an. Wenn das Menüelement bereits über ein Häkchen verfügt, entfernt die Funktion das Häkchen und blendet das entsprechende Steuerelement aus.
Str_GetPtr Kopiert eine Zeichenfolge aus einem Puffer in einen anderen.
Str_SetPtrW Legt ppszCurrent auf eine Kopie pszNew fest und gibt den vorherigen Wert bei Bedarf frei.
TranslateDispatch- Wird vom Client der DoReaderMode--Funktion verwendet, um Alle Fenstermeldungen, die für den Bildlaufbereich des Lesemodusfensters vorgesehen sind, abzufangen und explizit zu behandeln. Dies ist eine anwendungsdefinierte Rückruffunktion.

Macros

Thema Inhalt
DPA_AppendPtr Fügt ein neues Element am Ende einer DPA ein.
DPA_FastDeleteLastPtr Löscht den letzten Zeiger aus einem DPA.
DPA_FastGetPtr Ruft den Wert des angegebenen Zeigers in der DPA ab.
DPA_GetPtrCount Ruft die Anzahl der Zeiger in einem DPA ab.
DPA_GetPtrPtr Ruft den Zeiger auf das interne Zeigerarray eines DPA ab.
DPA_SetPtrCount Legt die Anzahl der Zeiger in einem DPA fest.
DPA_SortedInsertPtr Fügt ein neues Element vor oder nach einem angegebenen vorhandenen Element ein.
DSA_AppendItem Fügt ein neues Element am Ende einer DSA an.
DSA_GetItemCount Ruft die Anzahl der Elemente in einer DSA ab.
FORWARD_WM_NOTIFY Sendet die WM_NOTIFY Nachricht, oder sendet sie.
HANDLE_WM_NOTIFY Ruft eine Funktion auf, die die WM_NOTIFY Nachricht verarbeitet.
INDEXTOSTATEIMAGEMASK Bereitet den Index eines Zustandsbilds vor, sodass ein Strukturansicht-Steuerelement oder ein Listenansicht-Steuerelement den Index verwenden kann, um das Zustandsbild für ein Element abzurufen.

Meldungen

Thema Inhalt
CCM_DPISCALE Aktiviert die automatische Skalierung von Punkten pro Zoll (DPI) in Tree-View Steuerelementen, List-View Steuerelemente, ComboBoxEx-Steuerelemente, Headersteuerelemente, Schaltflächen, Symbolleistensteuerelemente, Animationssteuerelementeund Bildlisten.
CCM_GETUNICODEFORMAT Ruft das Unicode-Zeichenformat-Flag für das Steuerelement ab.
CCM_GETVERSION Ruft die Versionsnummer für ein Steuerelement ab, das von der letzten CCM_SETVERSION Nachricht festgelegt wurde.
CCM_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.
CCM_SETVERSION Diese Meldung wird verwendet, um das Steuerelement darüber zu informieren, dass Sie ein Verhalten erwarten, das einer bestimmten Version zugeordnet ist.
CCM_SETWINDOWTHEME Legt den visuellen Stil eines Steuerelements fest.
WM_NOTIFY Gesendet von einem allgemeinen Steuerelement an das übergeordnete Fenster, wenn ein Ereignis aufgetreten ist oder das Steuerelement einige Informationen benötigt.
WM_NOTIFYFORMAT Bestimmt, ob ein Fenster ANSI- oder Unicode-Strukturen in der WM_NOTIFY Benachrichtigung akzeptiert. WM_NOTIFYFORMAT Nachrichten werden von einem allgemeinen Steuerelement an das übergeordnete Fenster und vom übergeordneten Fenster an das allgemeine Steuerelement gesendet.

Benachrichtigungen

Thema Inhalt
NM_CHAR Der NM_CHAR Benachrichtigungscode wird von einem Steuerelement gesendet, wenn ein Zeichenschlüssel verarbeitet wird. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_CUSTOMDRAW Benachrichtigt das übergeordnete Fenster eines Steuerelements über benutzerdefinierte Zeichnungsvorgänge. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_CUSTOMTEXT Benachrichtigt das übergeordnete Fenster eines Steuerelements über benutzerdefinierte Textvorgänge. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_FONTCHANGED Wird von einem Listenansichtssteuerelement gesendet, wenn das Steuerelement eine Schriftart geändert hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_GETCUSTOMSPLITRECT Gesendet von einem Schaltflächensteuerelement an das übergeordnete Steuerelement, um Maßangaben für die beiden Rechtecke abzurufen, aus denen die geteilte Schaltfläche besteht. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_HOVER Wird von einem Steuerelement gesendet, wenn der Mauszeiger auf ein Element bewegt wird. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_KEYDOWN Wird von einem Steuerelement gesendet, wenn das Steuerelement den Tastaturfokus hat und der Benutzer eine Taste drückt. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_KILLFOCUS Benachrichtigt das übergeordnete Fenster eines Steuerelements, dass das Steuerelement den Eingabefokus verloren hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_LDOWN Benachrichtigt das übergeordnete Fenster eines Steuerelements, dass die linke Maustaste gedrückt wurde. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_NCHITTEST Wird von einem Rebar-Steuerelement gesendet, wenn das Steuerelement eine WM_NCHITTEST Nachricht empfängt. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_OUTOFMEMORY Benachrichtigt das übergeordnete Fenster eines Steuerelements, dass das Steuerelement einen Vorgang nicht abschließen konnte, da nicht genügend Arbeitsspeicher verfügbar war. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_RDOWN Zurzeit nicht unterstützt.
NM_RELEASEDCAPTURE Benachrichtigt das übergeordnete Fenster eines Steuerelements, dass das Steuerelement die Mausaufnahme loslässt. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_RETURN Benachrichtigt das übergeordnete Fenster eines Steuerelements, dass das Steuerelement den Eingabefokus hat und der Benutzer die EINGABETASTE gedrückt hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_SETCURSOR Benachrichtigt das übergeordnete Fenster eines Steuerelements, dass das Steuerelement den Cursor als Reaktion auf eine NM_SETCURSOR Nachricht festlegt. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_SETFOCUS Benachrichtigt das übergeordnete Fenster eines Steuerelements, dass das Steuerelement den Eingabefokus erhalten hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_THEMECHANGED Benachrichtigt das übergeordnete Fenster eines Steuerelements, dass sich das Design geändert hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_TOOLTIPSCREATED Benachrichtigt das übergeordnete Fenster eines Steuerelements, dass das Steuerelement ein QuickInfo-Steuerelement erstellt hat. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_TVSTATEIMAGECHANGING Gesendet von einem Strukturansicht-Steuerelement an das übergeordnete Fenster, das das Zustandsbild ändert. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.

Strukturen

Thema Inhalt
COLORSCHEME- Enthält Informationen für die Zeichnung von Schaltflächen in einer Symbolleiste oder einer Leiste.
DPASTREAMINFO- Enthält ein Streamelement, das von der PFNDPASTREAM Rückruffunktion verwendet wird.
INITCOMMONCONTROLSEX- Enthält Informationen, die verwendet werden, um allgemeine Steuerelementklassen aus der Dynamic Link Library (DLL) zu laden. Diese Struktur wird mit der funktion InitCommonControlsEx verwendet.
NMCHAR- Enthält Informationen, die mit Zeichenbenachrichtigungen verwendet werden.
NMCUSTOMSPLITRECTINFO Enthält Informationen zu den beiden Rechtecke einer geteilten Schaltfläche. Gesendet mit der NM_GETCUSTOMSPLITRECT-Benachrichtigung.
NMCUSTOMTEXT- Enthält Informationen, die mit benutzerdefinierter Textbenachrichtigung verwendet werden.
NMHDR- Enthält Informationen zu einer Benachrichtigung.
NMKEY- Enthält Informationen, die mit wichtigen Benachrichtigungen verwendet werden.
NMMOUSE- Enthält Informationen, die mit Mausbenachrichtigungen verwendet werden.
NMOBJECTNOTIFY Enthält Informationen, die mit den Benachrichtigungscodes TBN_GETOBJECT, TCN_GETOBJECTund PSN_GETOBJECT verwendet werden.
NMTOOLTIPSCREATED Enthält Informationen, die mit NM_TOOLTIPSCREATED Benachrichtigungscode verwendet werden.
READERMODEINFO- Enthält Informationen, die zum Initialisieren der DoReaderMode--Funktion erforderlich sind.

Konstanten

Thema Inhalt
CDRF-Konstanten Diese Konstanten werden als Rückgabewerte von einem Steuerelement als Reaktion auf einen NM_CUSTOMDRAW Benachrichtigungscode verwendet.
Formatvorlagen In diesem Abschnitt werden allgemeine Steuerelementstile aufgeführt. Sofern nicht angegeben, gelten diese Formatvorlagen für Kopfzeilensteuerelemente, Symbolleistensteuerelemente und Statusfenster.
Fensterklassen In diesem Abschnitt werden die Fensterklassennamen aufgeführt, die von der allgemeinen Steuerelementbibliothek bereitgestellt werden.