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 Systemdefinierte Nachrichten.
[in] wParam
Typ: WPARAM
Zusätzliche meldungsspezifische Informationen.
[in] lParam
Typ: LPARAM
Zusätzliche meldungsspezifische Informationen.
Rückgabewert
Typ: LRESULT
Der Rückgabewert gibt das Ergebnis der Nachrichtenverarbeitung an und hängt von der gesendeten Nachricht ab.
Hinweise
Die SendDlgItemMessage-Funktion wird erst zurückgegeben, wenn die Nachricht verarbeitet wurde.
Die Verwendung von SendDlgItemMessage ist identisch mit dem Abrufen eines Handles für das angegebene Steuerelement und dem Aufrufen der SendMessage-Funktion .
Beispiele
Ein Beispiel finden Sie unter Erstellen eines dialogfelds ohne Modus.
Hinweis
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 nicht codierungsneutralem Code 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (einschließlich Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-dialogbox-l1-1-0 (eingeführt in Windows 8) |
Siehe auch
Konzept
Referenz