SendDlgItemMessageA-Funktion (winuser.h)
Sendet eine Nachricht an das angegebene Steuerelement in einem Dialogfeld.
Syntax
LRESULT SendDlgItemMessageA(
[in] HWND hDlg,
[in] int nIDDlgItem,
[in] UINT Msg,
[in] WPARAM wParam,
[in] LPARAM lParam
);
Parameter
[in] hDlg
Typ: HWND-
Ein Handle für das Dialogfeld, das das Steuerelement enthält.
[in] nIDDlgItem
Typ: int
Der Bezeichner des Steuerelements, das die Nachricht empfängt.
[in] Msg
Typ: UINT-
Die zu sendende Nachricht.
Listen der vom System bereitgestellten Nachrichten finden Sie unter System-Defined Nachrichten.
[in] wParam
Typ: WPARAM-
Zusätzliche nachrichtenspezifische Informationen.
[in] lParam
Typ: LPARAM-
Zusätzliche nachrichtenspezifische Informationen.
Rückgabewert
Typ: LRESULT-
Der Rückgabewert gibt das Ergebnis der Nachrichtenverarbeitung an und hängt von der gesendeten Nachricht ab.
Bemerkungen
Die SendDlgItemMessage--Funktion wird erst zurückgegeben, wenn die Nachricht verarbeitet wurde.
Die Verwendung von SendDlgItemMessage ist identisch mit dem Abrufen eines Handles zum angegebenen Steuerelement und aufrufen der SendMessage--Funktion.
Beispiele
Ein Beispiel finden Sie unter Erstellen eines Dialogfelds ohne Modus.
Anmerkung
Der winuser.h-Header definiert SendDlgItemMessage als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform- | Fenster |
Header- | winuser.h (enthalten Windows.h) |
Library | User32.lib |
DLL- | User32.dll |
API-Satz | ext-ms-win-ntuser-dialogbox-l1-1-0 (eingeführt in Windows 8) |
Siehe auch
Konzeptionelle
Referenz-