ITextStoreACP2::GetACPFromPoint-Methode (textstor.h)

Artikel
08/26/2023

Konvertiert einen Punkt in Bildschirmkoordinaten in eine Anwendungszeichenposition.

Syntax

HRESULT GetACPFromPoint(
  [in]  TsViewCookie vcView,
  [in]  const POINT  *ptScreen,
  [in]  DWORD        dwFlags,
  [out] LONG         *pacp
);

Parameter

[in] vcView

Gibt die Kontextansicht an.

[in] ptScreen

Zeiger auf die POINT-Struktur mit den Bildschirmkoordinaten des Punkts.

[in] dwFlags

Gibt die Zeichenposition an, die basierend auf den Bildschirmkoordinaten des Punkts relativ zu einem Zeichenbegrenzungsfeld zurückgegeben werden soll. Standardmäßig ist die zurückgegebene Zeichenposition das Zeichenbegrenzungsfeld, 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 Zeichenposition der begrenzungsenden Kante, 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 Zeichenposition zurückgegeben.

[out] pacp

Empfängt die Zeichenposition, die den Bildschirmkoordinaten des Punkts entspricht.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
TS_E_INVALIDPOINT	Der ptScreen-Parameter befindet sich nicht innerhalb des Begrenzungsrahmens eines Zeichens.
TS_E_NOLAYOUT	Die Anwendung hat kein Textlayout berechnet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	textstor.h
DLL	Msctf.dll

Weitere Informationen

GXFPF_*-Konstanten

ITextStoreACP2

ITfContextOwner::GetACPFromPoint

ITfContextView::GetRangeFromPoint

Manager-Rückgabewerte

TsViewCookie

Freigeben über