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.

• Übersichten
• Funktionen
• Makros
• Nachrichten
• Benachrichtigungen
• Strukturen
• Konstanten

Ü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.