Allgemeine Steuerelementreferenz

Dieser Abschnitt enthält Referenzinformationen zu Programmierelementen, die für mehrere Steuerelemente und nicht nur für ein bestimmtes Steuerelement gelten. Es gibt Funktionen, Makros, Nachrichten, Benachrichtigungen und Strukturen, die von den meisten Steuerelementen unterstützt werden. Beispielsweise verwenden die meisten Steuerelemente die NM _ HOVER-Benachrichtigungen, um Mausklicks zu verarbeiten.

Übersichten

Thema Inhalte
Informationen 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 ist.
Häufig gestellte Fragen zu allgemeinen Steuerelementen Diese häufig gestellten Fragen bieten Antworten auf einige häufig gestellte Fragen zu den allgemeinen Steuerelementen.

Functions

Thema Inhalte
DoReaderMode Aktiviert den Readermodus in einem Fenster.
_DPA-Klon Dupliziert ein dynamisches Zeigerarray (Dynamic Pointer Array, DPA).
_DPA-Erstellung Erstellt einen DPA.
DPA _ CreateEx Erstellt eine DPA mit einer angegebenen Größe und heap-Position.
DPA _ DeleteAllPtrs Entfernt alle Elemente aus einem DPA und verkleinert die DPA entsprechend.
DPA _ DeletePtr Entfernt ein Element aus einer DPA. Die DPA wird bei Bedarf verkleinert, um das entfernte Element aufnehmen zu können.
DPA _ Destroy Gibt ein Dynamic Pointer Array (DPA) frei.
DPA _ DestroyCallback Ruft pfnCB für jedes Element der DPA auf und gibt dann die DPA frei.
DPA _ EnumCallback Durch iteriert das Dynamic Pointer Array (DPA) und ruft pfnCB für jedes Element auf.
DPA _ GetPtr Ruft ein Element aus einem DPA ab.
DPA _ GetPtrIndex Ruft den Index eines übereinstimmenden Elements in einem DPA ab.
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 die DPA erweitert, um das neue Element aufnehmen zu können.
DPA _ LoadStream Lädt die DPA aus einem Stream, indem die angegebene Rückruffunktion zum Lesen der einzelnen Elemente aufruft.
DPA _ Merge Kombiniert den Inhalt von zwei DPAs.
DPA _ SaveStream Speichert die DPA in einem Stream, indem ein Header geschrieben und dann die angegebene Rückruffunktion zum Schreiben der einzelnen Elemente aufruft.
_DPA-Suche Sucht ein Element in einem DPA.
DPA _ SetPtr Weist einem Element in einem DPA einen Wert zu.
_DPA-Sortierung Sortiert die Elemente in einem Dynamic Pointer Array (DPA).
DrawShadowText Zeichnet Text, der einen Schatten hat.
DrawTextExPrivWrap Zeichnet formatierten Text im angegebenen Rechteck. Diese Funktion umschließt einen Aufruf von DrawTextEx.
DrawTextWrap Zeichnet formatierten Text im angegebenen Rechteck. Der Text wird gemäß der angegebenen Methode formatiert (Erweitern von Registerkarten, Rechtfertigen von Zeichen, Zeilenbruch und so weiter). Diese Funktion umschließt einen Aufruf von DrawText.
_DSA-Klon Dupliziert ein dynamisches Strukturarray (Dynamic Structure Array, DSA).
DSA _ Erstellen Erstellt eine DSA.
DSA _ DeleteAllItems Löscht alle Elemente aus einem DSA.
DSA _ DeleteItem Löscht ein Element aus einem DSA.
DSA _ Destroy Gibt ein DSA frei.
DSA _ DestroyCallback Durch iteriert ein DSA und ruft für jedes Element eine angegebene Rückruffunktion auf. Beim Erreichen des Endes des Arrays wird die DSA wieder frei.
DSA _ EnumCallback Durch iteriert das DSA und ruft pfnCB für jedes Element auf.
DSA _ GetItem Ruft ein Element aus einem DSA ab.
DSA _ GetItemPtr Ruft einen Zeiger auf ein Element aus einem DSA ab.
DSA _ GetSize Ruft die Größe des DSA ab.
DSA _ InsertItem Fügt ein neues Element in ein DSA ein. Bei Bedarf wird das DSA erweitert, um das neue Element aufnehmen zu können.
DSA _ SetItem Legt den Inhalt eines Elements in einem DSA fest.
DSA _ Sort Sortiert die Elemente in einem DSA.
ExtTextOutWrap Zeichnet Text unter Verwendung der aktuell ausgewählten Schriftart, Hintergrundfarbe und Textfarbe. Sie können optional Dimensionen bereitstellen, die für Clipping, Deckkraft oder beides verwendet werden sollen. Diese Funktion umschließt einen Aufruf von ExtTextOut.
GetEffectiveClientRect Berechnet die Abmessungen eines Rechtecks im Clientbereich, das 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 vom Client angegebenen Systemmetrik.
LoadIconWithScaleDown Lädt ein Symbol. Wenn das Symbol keine Standardgröße ist, skaliert diese Funktion ein größeres Bild herunter, anstatt ein kleineres Bild hochskalieren zu müssen.
MirrorIcon Kehrt Symbole (Spiegelungen) um, sodass sie ordnungsgemäß in einem gespiegelten Gerätekontext angezeigt werden.
PFNDACOMPARE Definiert den Prototyp für die compare-Funktion, die von DSA _ Sort verwendet wird.
PFNDACOMPARECONST Definiert den Prototyp für die compare-Funktion, die von DSA _ Sort verwendet wird, wenn die verglichenen Elemente konstante Objekte 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 konstante Daten sind.
PFNDPACOMPARE Definiert den Prototyp für die compare-Funktion, die von DPA _ Sort und DPA Search verwendet _ wird.
PFNDPACOMPARECONST Definiert den Prototyp für die compare-Funktion, die von DPA _ Sort oder DPA _ Search verwendet wird, wenn die verglichenen Elemente konstante Objekte sind.
PFNDPAENUMCALLBACK Definiert den Prototyp für die Rückruffunktion, die von DPA _ EnumCallback verwendet wird.
PFNDPAMERGE Definiert den Prototyp für die Mergefunktion, die von DPA _ Merge verwendet wird.
PFNDPAMERGECONST Definiert den Prototyp für die Mergefunktion, die von DPA _ Merge mitkonstanten Werten verwendet wird.
PFNDPASTREAM Definiert den Prototyp für die Rückruffunktion, die von DPA _ LoadStream und DPA _ SaveStream verwendet wird.
PFNDSAENUMCALLBACK Definiert den Prototyp für die Rückruffunktion, die von DSA _ DestroyCallback verwendet wird.
ReaderScroll Eine anwendungsdefinierte Rückruffunktion, die verwendet wird, wenn der Mauszeiger innerhalb des Teils des Fensters im Readermodus bewegt wird, der als aktiver Bildlaufbereich deklariert wurde.
ShowHideMenuCtl Legt das Häkchenattribut 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 keins hat, 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 von einem Puffer in einen anderen.
Str _ SetPtrW Legt ppszCurrent auf eine Kopie von pszNew fest und gibt bei Bedarf den vorherigen Wert frei.
TranslateDispatch Wird vom Client der DoReaderMode-Funktion verwendet, um Windows-Nachrichten abzufangen und explizit zu verarbeiten, die für den Bildlaufbereich des Fensters im Readermodus verwendet werden. Dies ist eine anwendungsdefinierte Rückruffunktion.

Makros

Thema Inhalte
DPA _ AppendPtr Fügt am Ende einer DPA ein neues Element ein.
DPA _ FastDeleteLastPtr Löscht den letzten Zeiger aus einer 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 einer 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 an das Ende eines DSA an.
DSA _ GetItemCount Ruft die Anzahl der Elemente in einem DSA ab.
FORWARD _ WM _ NOTIFY Sendet oder sendet die WM _ NOTIFY-Nachricht.
BEHANDELN VON _ _ WM-BENACHRICHTIGUNGEN Ruft eine Funktion auf, die die WM _ NOTIFY-Nachricht verarbeitet.
INDEXTOSTATEIMAGEMASK Bereitet den Index eines Zustandsbilds so vor, dass ein Strukturansicht-Steuerelement oder Listenansicht-Steuerelement den Index verwenden kann, um das Statusbild für ein Element abzurufen.

Nachrichten

Thema Inhalte
CCM _ DPISCALE Ermöglicht die automatische DPI-Skalierung (High Dots per Inch) in Tree-View-Steuerelementen, List-View-Steuerelementen, ComboBoxEx-Steuerelementen, Headersteuerelementen, Schaltflächen,Symbolleistensteuerelementen, Animationssteuerelementenund Bildlisten.
CCM _ GETUNICODEFORMAT Ruft das Unicode-Zeichenformatflag für das -Steuerelement ab.
CCM _ GETVERSION Ruft die Versionsnummer für ein Steuerelement ab, das von der letzten CCM _ SETVERSION-Meldung festgelegt wurde.
CCM _ SETUNICODEFORMAT Legt das Unicode-Zeichenformatflag für das Steuerelement fest. Mit dieser Meldung können Sie den vom Steuerelement zur Laufzeit verwendeten Zeichensatz ändern, anstatt das Steuerelement neu 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 Wird von einem allgemeinen Steuerelement an das übergeordnete Fenster gesendet, wenn ein Ereignis aufgetreten ist oder das Steuerelement einige Informationen erfordert.
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 Inhalte
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 Listenansicht-Steuerelement gesendet, wenn das Steuerelement eine Schriftart geändert hat. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet.
NM _ GETCUSTOMSPLITRECT Wird von einem Schaltflächen-Steuerelement an das übergeordnete Steuerelement gesendet, um Messungen für die beiden Rechtecke zu erhalten, aus denen die Teilungsschaltfläche wird. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet.
NM _ HOVER Wird von einem -Steuerelement gesendet, wenn mit der Maus auf ein Element gezeigert wird. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet.
NM _ KEYDOWN Wird von einem Steuerelement gesendet, wenn das Steuerelement den Tastaturfokus besitzt 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 Derzeit nicht unterstützt.
NM _ RELEASEDCAPTURE Benachrichtigt das übergeordnete Fenster eines Steuerelements, dass das Steuerelement die Mausaufnahme frei gibt. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet.
NM _ RETURN Benachrichtigt das übergeordnete Fenster eines Steuerelements, dass das Steuerelement über den Eingabefokus verfügt 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 darüber, dass das Steuerelement den Cursor als Reaktion auf eine NM _ SETCURSOR-Meldung anordnt. 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-QUICKINFOERERZEUGT 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 Wird von einem Strukturansicht-Steuerelement an das übergeordnete Fenster gesendet, in dem sich das Statusbild ändert. Dieser Benachrichtigungscode wird in Form einer WM _ NOTIFY-Nachricht gesendet.

Strukturen

Thema Inhalte
Colorscheme Enthält Informationen zum Zeichnen von Schaltflächen in einer Symbolleiste oder Leiste.
DPASTREAMINFO Enthält ein Streamelement, das von der PFNDPASTREAM-Rückruffunktion verwendet wird.
INITCOMMONCONTROLSEX Enthält Informationen, die zum Laden gängiger Steuerelementklassen aus der Dynamic Link Library (DLL) verwendet werden. Diese Struktur wird mit der InitCommonControlsEx-Funktion verwendet.
NMCHAR Enthält Informationen, die mit Zeichenbenachrichtigungsmeldungen verwendet werden.
NMCUSTOMSPLITRECTINFO Enthält Informationen zu den beiden Rechtecke einer geteilten Schaltfläche. Wird mit der NM _ GETCUSTOMSPLITRECT-Benachrichtigung gesendet.
NMCUSTOMTEXT Enthält Informationen, die mit einer benutzerdefinierten Textbenachrichtigung verwendet werden.
NMHDR Enthält Informationen zu einer Benachrichtigungsmeldung.
NMKEY Enthält Informationen, die mit Schlüsselbenachrichtigungsmeldungen verwendet werden.
NMMOUSE Enthält Informationen, die mit Mausbenachrichtigungsmeldungen verwendet werden.
NMOBJECTNOTIFY Enthält Informationen, die mit den TBN _ GETOBJECT-, TCN _ GETOBJECT-und PSN _ GETOBJECT-Benachrichtigungscodes verwendet werden.
NMTOOLTIPSCREATED Enthält Informationen, die mit dem NM _ TOOLTIPSCREATED-Benachrichtigungscode verwendet werden.
READERMODEINFO Enthält Informationen, die zum Initialisieren der DoReaderMode-Funktion erforderlich sind.

Konstanten

Thema Inhalte
CDRF-Konstanten Diese Konstanten werden von einem Steuerelement als Antwort auf einen NM CUSTOMDRAW-Benachrichtigungscode als _ Rückgabewerte verwendet.
Stile In diesem Abschnitt werden allgemeine Steuerelementstile aufgeführt. Sofern nicht anders angegeben, gelten diese Stile für Headersteuerelemente, Symbolleistensteuerelemente und Statusfenster.
Fensterklassen In diesem Abschnitt werden die Fensterklassennamen aufgeführt, die von der allgemeinen Steuerelementbibliothek bereitgestellt werden.