Allgemeine Steuerelementreferenz

  • Artikel

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. Beispielsweise verwenden die meisten Steuerelemente die NM_HOVER Benachrichtigungen, um Mausklicks zu verarbeiten.

Übersichten

Thema Inhalte
Allgemeine Steuerelemente Bei den allgemeinen Steuerelementen handelt es sich um eine Reihe von Fenstern, die von der allgemeinen Steuerelementbibliothek implementiert werden, die eine DLL ist, die im Windows-Betriebssystem enthalten ist.
Häufig gestellte Fragen zu häufig gestellten Steuerelementen Diese faq enthält Antworten auf einige häufig gestellte Fragen zu den gängigen Steuerelementen.

Functions

Thema Inhalte
DoReaderMode Aktiviert den Lesermodus in einem Fenster.
DPA_Clone Dupliziert ein dynamisches Zeigerarray (DPA).
DPA_Create Erstellt eine DPA.
DPA_CreateEx Erstellt einen DPA mit einer angegebenen Größe und einem angegebenen Heapspeicherort.
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 (DPA) frei.
DPA_DestroyCallback Ruft pfnCB für jedes Element des DPA auf, und gibt dann den DPA frei.
DPA_EnumCallback Durchläuft das Dynamische Zeigerarray (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 ab, das in einem DPA gefunden wurde.
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 Stream, 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 Stream, indem ein Header ausgeschrieben und dann die angegebene Rückruffunktion aufgerufen wird, um jedes Element zu schreiben.
DPA_Search Sucht ein Element in einem DPA.
DPA_SetPtr Weist einem Element in einem DPA einen Wert zu.
DPA_Sort Sortiert die Elemente in einem dynamischen Zeigerarray (DPA).
DrawShadowText Zeichnet Text, der einen Schatten aufweist.
DrawTextExPrivWrap Zeichnet formatierten Text im angegebenen Rechteck. Diese Funktion umschließt einen Aufruf von DrawTextEx.
DrawTextWrap Zeichnet formatierten Text im angegebenen Rechteck. Es formatiert den Text gemäß der angegebenen Methode (Erweitern von Registerkarten, Rechtfertigungszeichen, Zeilenbruchlinien 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 und ruft eine angegebene Rückruffunktion für jedes Element auf. Am Ende 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 einem DSA ab.
DSA_GetSize Ruft die Größe des 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 einem DSA.
ExtTextOutWrap Zeichnet Text mit der aktuell ausgewählten Schriftart, Hintergrundfarbe und Textfarbe. Optional können Sie Dimensionen angeben, 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 unterscheidet.
LoadIconMetric Lädt eine angegebene Symbolressource mit einer vom Client angegebenen Systemmetrik.
LoadIconWithScaleDown Lädt ein Symbol. Wenn das Symbol keine Standardgröße hat, skaliert diese Funktion ein größeres Bild, anstatt ein kleineres Bild hochzuskalieren.
MirrorIcon Umgekehrte Symbole (Spiegelung), sodass sie in einem gespiegelten Gerätekontext ordnungsgemäß angezeigt werden.
PFNDACOMPARE Definiert den Prototyp für die von DSA_Sort verwendete Vergleichsfunktion.
PFNDACOMPARECONST Definiert den Prototyp für die Vergleichsfunktion, 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 von DPA_Sort und DPA_Search verwendete Vergleichsfunktion.
PFNDPACOMPARECONST Definiert den Prototyp für die Vergleichsfunktion, 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 merge-Funktion, die von DPA_Merge verwendet wird.
PFNDPAMERGECONST Definiert den Prototyp für die von DPA_Merge verwendete Mergefunktion unter Verwendung konstanter Werte.
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 Als aktiver Bildlaufbereich deklarierten Bereichs des Lesermodusfensters bewegt wird.
ShowHideMenuCtl Legt das Häkchen-Attribut des angegebenen Menüelements fest oder entfernt es und zeigt das entsprechende Steuerelement an oder blendet es 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 aus einem Puffer in einen anderen.
Str_SetPtrW Legt ppszCurrent auf eine Kopie von pszNew fest und gibt ggf. den vorherigen Wert frei.
TranslateDispatch Wird vom Client der DoReaderMode-Funktion zum Abfangen und expliziten Verarbeiten von Windows-Meldungen verwendet, die für den Scrollbereich des Lesemodusfensters bestimmt sind. Dies ist eine anwendungsdefinierte Rückruffunktion.

Makros

Thema Inhalte
DPA_AppendPtr Fügt ein neues Element am Ende eines DPA ein.
DPA_FastDeleteLastPtr Löscht den letzten Zeiger aus einem DPA.
DPA_FastGetPtr Ruft den Wert des angegebenen Zeigers im 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 einem DSA ab.
FORWARD_WM_NOTIFY Sendet oder postet die WM_NOTIFY Nachricht.
HANDLE_WM_NOTIFY Ruft eine Funktion auf, die die WM_NOTIFY-Nachricht verarbeitet.
INDEXTOSTATEIMAGEMASK Bereitet den Index eines Zustandsbilds so vor, dass ein Strukturansichts- oder Listenansichtssteuerelement den Index verwenden kann, um das Zustandsbild für ein Element abzurufen.

Nachrichten

Thema Inhalte
CCM_DPISCALE Ermöglicht die automatische Skalierung hoher Punkte pro Zoll (DPI) in Strukturansicht-Steuerelementen, Listenansicht-Steuerelementen, ComboBoxEx-Steuerelementen, Kopfzeilensteuerelementen, Schaltflächen, Symbolleistensteuerelementen, Animationssteuerelementen und Bildlisten.
CCM_GETUNICODEFORMAT Ruft das Unicode-Zeichenformatflag für das Steuerelement ab.
CCM_GETVERSION Ruft die Versionsnummer für einen Steuerelementsatz durch die neueste CCM_SETVERSION-Meldung ab.
CCM_SETUNICODEFORMAT Legt das Unicode-Zeichenformatflag für das Steuerelement fest. Mit dieser Meldung können Sie den zeichensatz ändern, der vom Steuerelement zur Laufzeit verwendet wird, 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 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 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 Listenansichtssteuerelement 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 sein übergeordnetes Element gesendet, um Messungen 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 die Maus über 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 der Eingabefokus für das Steuerelement verloren gegangen ist. 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 Beleistensteuerelement 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, weil nicht genügend Arbeitsspeicher verfügbar war. Dieser Benachrichtigungscode wird in Form einer WM_NOTIFY Nachricht gesendet.
NM_RDOWN Wird derzeit nicht unterstützt.
NM_RELEASEDCAPTURE Benachrichtigt das übergeordnete Fenster eines Steuerelements, dass das Steuerelement die Mausaufnahme freigibt. 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 dass 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 das Design geändert wurde. 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 Wird von einem Strukturansichtssteuerelement an das übergeordnete Fenster gesendet, das sich vom Zustandsbild ä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 einer Leiste.
DPASTREAMINFO Enthält ein Streamelement, das von der PFNDPASTREAM-Rückruffunktion verwendet wird.
INITCOMMONCONTROLSEX Enthält Informationen, die zum Laden gängiger Steuerungsklassen aus der Dll (Dynamic Link Library) verwendet werden. Diese Struktur wird mit der Funktion InitCommonControlsEx verwendet.
NMCHAR Enthält Informationen, die mit Zeichenbenachrichtigungen verwendet werden.
NMCUSTOMSPLITRECTINFO Enthält Informationen zu den beiden Rechtecken einer geteilten Schaltfläche. Wird mit der NM_GETCUSTOMSPLITRECT-Benachrichtigung gesendet.
NMCUSTOMTEXT Enthält Informationen, die mit benutzerdefinierten Textbenachrichtigungen 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_GETOBJECT und 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 Inhalte
CDRF-Konstanten Diese Konstanten werden als Rückgabewerte von einem Steuerelement als Reaktion auf einen NM_CUSTOMDRAW Benachrichtigungscode verwendet.
Stile In diesem Abschnitt werden allgemeine Steuerelementstile aufgeführt. Sofern nicht angegeben, gelten diese Formatvorlagen für Headersteuerelemente, Symbolleistensteuerelemente und status Fenster.
Fensterklassen In diesem Abschnitt werden die Fensterklassennamen aufgelistet, die von der allgemeinen Steuerelementbibliothek bereitgestellt werden.