EM_GETLINE Nachricht (Winuser.h)

Kopiert eine Textzeile aus einem Bearbeitungssteuerelement und platziert sie in einem angegebenen Puffer. Sie können diese Nachricht entweder an ein Bearbeitungssteuerelement oder ein Rich-Edit-Steuerelement senden.

Parameter

wParam

Der nullbasierte Index der Zeile, die aus einem mehrzeiligen Bearbeitungssteuerelement abgerufen werden soll. Der Wert null gibt die oberste Zeile an. Dieser Parameter wird von einem einzeiligen Bearbeitungssteuerelement ignoriert.

lParam

Ein Zeiger auf den Puffer, der eine Kopie der Zeile empfängt. Legen Sie vor dem Senden der Nachricht das erste Wort dieses Puffers auf die Größe des Puffers in TCHARs fest. Für ANSI-Text ist dies die Anzahl der Bytes; Für Unicode-Text ist dies die Anzahl der Zeichen. Die Größe im ersten Wort wird von der kopierten Zeile überschrieben.

Rückgabewert

Der Rückgabewert ist die Anzahl der kopierten TCHAR-Werte. Der Rückgabewert ist 0, wenn die vom wParam-Parameter angegebene Zeilennummer größer als die Anzahl der Zeilen im Bearbeitungssteuerelement ist.

Bemerkungen

Steuerelemente bearbeiten: Die kopierte Zeile enthält kein beendendes NULL-Zeichen.

Rich-Edit-Steuerelemente: Unterstützt in Microsoft Rich Edit 1.0 und höher. Die kopierte Zeile enthält kein abschließendes NULL-Zeichen, es sei denn, es wurde kein Text kopiert. Wenn kein Text kopiert wurde, platziert die Nachricht ein NULL-Zeichen am Anfang des Puffers. Informationen zur Kompatibilität von Rich-Edit-Versionen mit den verschiedenen Systemversionen finden Sie unter Informationen zu Rich-Edit-Steuerelementen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Winuser.h (einschließlich Windows.h)

Siehe auch

Referenz

EM_LINELENGTH

Edit_GetLine

Andere Ressourcen

WM_GETTEXT