SendDlgItemMessageA-Funktion (winuser.h)

  • Artikel

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

Dialogfelder

Referenz

SendMessage