ITextStoreACP2::InsertEmbeddedAtSelection-Methode (textstor.h)

Artikel
03/02/2024

Fügt ein IDataObject an der Einfügemarke oder Auswahl ein. Der Client, der diese Methode aufruft, muss über eine Lese-/Schreibsperre verfügen, bevor ein IDataObject-Objekt in das Dokument eingefügt wird.

Syntax

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD         dwFlags,
  [in]  IDataObject   *pDataObject,
  [out] LONG          *pacpStart,
  [out] LONG          *pacpEnd,
  [out] TS_TEXTCHANGE *pChange
);

Parameter

[in] dwFlags

Gibt an, ob die Parameter pacpStart und pacpEnd sowie die TS_TEXTCHANGE-Struktur die Ergebnisse der Objekteinfügung enthalten.

Die flags TF_IAS_NOQUERY und TF_IAS_QUERYONLY können nicht kombiniert werden.

Wert	Bedeutung
0	Text wird eingefügt, und die Parameter pacpStart und pacpEnd enthalten die Ergebnisse der Texteinfügung. Die TS_TEXTCHANGE-Struktur muss mit diesem Flag gefüllt werden.
TF_IAS_NOQUERY	Text wird eingefügt, die Werte der Parameter pacpStart und pacpEnd können NULL sein, und die TS_TEXTCHANGE-Struktur muss ausgefüllt werden. Verwenden Sie dieses Flag, wenn die Ergebnisse der Texteinfügung nicht erforderlich sind.
TF_IAS_QUERYONLY	Text wird nicht eingefügt, und die Werte für die Parameter pacpStart und pacpEnd enthalten die Ergebnisse der Texteinfügung. Die Werte dieser Parameter hängen davon ab, wie die Anwendung texteinfügung in ein Dokument implementiert. Weitere Informationen finden Sie im Abschnitt mit Hinweisen. Verwenden Sie dieses Flag, um die Ergebnisse der Texteinfügung anzuzeigen, ohne den Text tatsächlich einzufügen, z. B. um die Ergebnisse des Zusammenbrechens oder anderweitigen Anpassens einer Auswahl vorherzusagen. Es ist nicht erforderlich, dass Sie die TS_TEXTCHANGE-Struktur mit diesem Flag füllen.

[in] pDataObject

Zeiger auf das einzufügende IDataObject-Objekt .

[out] pacpStart

Zeiger auf die Anfangsposition der Anwendung, an der die Objekteinfügung erfolgt.

[out] pacpEnd

Zeiger auf die endende Anwendungszeichenposition, an der die Objekteinfügung erfolgt. Dieser Parameterwert entspricht dem Wert des pacpStart-Parameters für eine Einfügemarke.

[out] pChange

Zeiger auf eine TS_TEXTCHANGE-Struktur mit den folgenden Membern.

Wert	Bedeutung
acpStart	Die Anfangsposition der Anwendung, bevor das Objekt in das Dokument eingefügt wird.
acpOldEnd	Die endende Anwendungszeichenposition, bevor das Objekt in das Dokument eingefügt wird. Dieser Wert ist identisch mit acpStart für eine Einfügemarke. Wenn sich dieser Wert von acpStart unterscheidet, wurde vor dem Einfügen des Objekts Text ausgewählt.
acpNewEnd	Die endende Position des Anwendungszeichens nach dem Einfügen des Objekts.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	Der parameter pchText ist ungültig.
TS_E_NOLOCK	Der Aufrufer verfügt nicht über eine Sperre für das Dokument.

Hinweise

Die Werte der Parameter pacpStart und pacpEnd hängen davon ab, wie die Clientanwendung ein Objekt in ein Dokument einfügt. Wenn die Anwendung beispielsweise den Cursor am Anfang des Objekts nach dem Einfügen des Objekts festlegt, ist der Wert der Parameter pacpStart und pacpEnd identisch mit dem acpStart-Member der TS_TEXTCHANGE-Struktur .

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

Freigeben über