ITfRange::AdjustForInsert-Methode (msctf.h)

Artikel
08/24/2023

Die ITfRange::AdjustForInsert-Methode erweitert oder ordnet einen Textbereich an, der für das Einfügen von Text angepasst werden soll.

Syntax

HRESULT AdjustForInsert(
  [in]  TfEditCookie ec,
  [in]  ULONG        cchInsert,
  [out] BOOL         *pfInsertOk
);

Parameter

[in] ec

Bearbeiten Sie das cookie, das von ITfDocumentMgr::CreateContext oder ITfEditSession::D oEditSession abgerufen wurde.

[in] cchInsert

Zeichenanzahl des eingefügten Texts. Diese Anzahl wird in einem futurecall to ITfRange::SetText verwendet. Wenn die Zeichenanzahl unbekannt ist, kann 0 verwendet werden.

[out] pfInsertOk

Zeiger auf ein Flag, das angibt, ob der Kontextbesitzer das Einfügen akzeptiert (TRUE) oder abgelehnt (FALSE).

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_FAIL	Fehler bei der Methode.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
E_NOTIMPL	Die Anwendung konnte die Auswahl nicht ersetzen.
TF_E_NOLOCK	Der Wert im ec-Parameter ist ein ungültiges Cookie, oder der Aufrufer verfügt nicht über eine schreibgeschützte Sperre.

Hinweise

Diese Methode sollte verwendet werden, um einen Bereich vorzubereiten, um eine neue Komposition zu initiieren, bevor die Bearbeitung beginnt. Sie sollte nur verwendet werden, wenn der Text bei der aktuellen Auswahl nicht eingefügt wird. ITFInsertAtSelection:InsertTextAtSelection oder ITfInsertAtSelection::InsertEmbeddedAtSelection sind die richtigen Methoden, die verwendet werden können, wenn Text bei der aktuellen Auswahl eingefügt wird.

Der Kontextbesitzer kann diese Methode verwenden, um das Verhalten beizubehalten und eine konsistente Benutzeroberfläche zu gewährleisten. Beispielsweise können bestimmte Zeichen oder Objekte im Kontext vor Änderungen beibehalten werden, oder die Übertypisierung kann unterstützt werden.

Diese Methode ist beim Ändern einer vorhandenen Komposition nicht erforderlich. Es ist akzeptabel, ITfRange::SetText direkt aufzurufen, um Text zu ändern, der zuvor vom Aufrufer eingegeben wurde.

Wenn beim Beenden *pfInsertOk auf FALSE festgelegt ist, schlägt ein zukünftiger Aufruf von ITfRange::SetText oder ITfRange::InsertEmbedded mit diesem Bereich wahrscheinlich fehl. Andernfalls wird *pfInsertOk auf TRUE festgelegt, und der Bereich Startanker oder Endanker kann nach Ermessen des Kontextbesitzers neu positioniert werden.

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