ITfContextView::GetRangeFromPoint-Methode (msctf.h)

Die ITfContextView::GetRangeFromPoint-Methode konvertiert einen Punkt in Bildschirmkoordinaten in einen leeren Textbereich, der an einer entsprechenden Position positioniert ist.

Syntax

HRESULT GetRangeFromPoint(
  [in]  TfEditCookie ec,
  [in]  const POINT  *ppt,
  [in]  DWORD        dwFlags,
  [out] ITfRange     **ppRange
);

Parameter

[in] ec

Gibt das Bearbeitungscookies mit schreibgeschütztem Zugriff an.

[in] ppt

Gibt den Punkt in den Bildschirmkoordinaten an.

[in] dwFlags

Gibt die zurückzugebende Bereichsposition basierend auf den Bildschirmkoordinaten des Punkts zu einem zeichengebundenen Feld an. Standardmäßig ist die zurückgegebene Bereichsposition das zeichengebundene Feld, das die Bildschirmkoordinaten des Punkts enthält. Wenn sich der Punkt außerhalb eines Zeichenbegrenzungsrahmens befindet, gibt die Methode NULL oder TF_E_INVALIDPOINT zurück. Andere Bitflags für diesen Parameter sind wie folgt.

Die Bitflags können kombiniert werden.

Wert	Bedeutung
GXFPF_ROUND_NEAREST	Wenn die Bildschirmkoordinaten des Punkts in einem Zeichenbegrenzungsfeld enthalten sind, ist die zurückgegebene Bereichsposition der Begrenzungskante, die den Bildschirmkoordinaten des Punkts am nächsten kommt.
GXFPF_NEAREST	Wenn die Bildschirmkoordinaten des Punkts nicht in einem Zeichenbegrenzungsfeld enthalten sind, wird die nächstgelegene Bereichsposition zurückgegeben.

[out] ppRange

Empfängt einen Zeiger auf die ITfRange-Schnittstelle.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
TF_E_INVALIDPOINT	Der pptScreen-Parameter deckt keinen Dokumenttext ab.
TF_E_NOLAYOUT	Die Anwendung hat kein Textlayout berechnet.
TF_E_NOLOCK	Das angegebene Bearbeitungscookies ist ungültig.

Hinweise

Standardmäßig gibt die -Methode einen Bereich zurück, der für Punkt 1 bei 0 und für Punkt 2 TF_E_INVALIDPOINT. Wenn der dwFlags-Parameter auf GXFPF_ROUND_NEAREST festgelegt ist, gibt die Methode für Punkt 1 bereichsposition 1 zurück. Wenn der dwFlags-Parameter auf GXFPF_NEAREST gibt die Methode für Punkt 2 bereichsposition 2 zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

GXFPF_NEAREST

GXFPF_ROUND_NEAREST

ITfContextView

TF_E_INVALIDPOINT