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