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