EM_CHARFROMPOS-Nachricht

Ruft Informationen zum Zeichen ab, das einem angegebenen Punkt im Clientbereich eines Bearbeitungssteuerelements am nächsten liegt. Sie können diese Nachricht entweder an ein Bearbeitungssteuerelement oder ein Rich Edit-Steuerelement senden.

Parameter

wParam

Dieser Parameter wird nicht verwendet.

lParam

Die Koordinaten eines Punkts im Clientbereich des Steuerelements. Die Koordinaten befinden sich in Bildschirmeinheiten und sind relativ zur oberen linken Ecke des Clientbereichs des Steuerelements.

Rich-Edit-Steuerelemente: Ein Zeiger auf eine POINTL-Struktur, welche die horizontalen und vertikalen Koordinaten enthält.

Bearbeitungssteuerelemente: Das LOWORD enthält die horizontale Koordinate. Das HIWORD enthält die vertikale Koordinate.

Rückgabewert

Rich-Edit-Steuerelemente: Der Rückgabewert gibt den nullbasierten Zeichenindex des Zeichens an, das dem angegebenen Punkt am nächsten liegt. Der Rückgabewert gibt das letzte Zeichen im Bearbeitungssteuerelement an, wenn der angegebene Punkt über das letzte Zeichen im Steuerelement hinausgeht.

Bearbeitungssteuerelemente: Das LOWORD gibt den nullbasierten Index des Zeichens an, das dem angegebenen Punkt am nächsten liegt. Dieser Index ist relativ zum Anfang des Steuerelements, nicht zum Anfang der Zeile. Wenn der angegebene Punkt über das letzte Zeichen im Bearbeitungssteuerelement hinausgeht, gibt der Rückgabewert das letzte Zeichen im Steuerelement an. HIWORD gibt den nullbasierten Index der Zeile an, die das Zeichen enthält. Für einzeilige Bearbeitungssteuerelemente ist dieser Wert null. Der Index gibt das Zeilentrennzeichen an, wenn der angegebene Punkt über das letzte sichtbare Zeichen in einer Zeile hinausgeht.

Hinweise

Rich Edit: Unterstützt in Microsoft Rich Edit 1.0 und höher. Informationen zur Kompatibilität von Rich Edit-Versionen mit den verschiedenen Systemversionen finden Sie unter Informationen zu Rich Edit-Steuerelementen.

Wenn ein Punkt an EM_CHARFROMPOS als lParam übergeben wird und sich der Punkt außerhalb der Grenzen des Bearbeitungssteuerelements befindet, lautet das lResult (65535, 65535).

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_POSFROMCHAR

Weitere Ressourcen

MAKELPARAM

POINTL