ITextStoreACP::InsertEmbeddedAtSelection-Methode (textstor.h)

Artikel
08/26/2023

Die ITextStoreACP::InsertEmbeddedAtSelection-Methode fügt ein IDataObject-Objekt 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	Das Einfügen von Text erfolgt, 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 das Einfügen von Text 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 IDataObject-Objekt , das eingefügt werden soll.

[out] pacpStart

Zeiger auf die Anfangszeichenposition der Anwendung, an der das Objekt eingefügt wird.

[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 des Anwendungszeichens, 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 mit acpStart für eine Einfügemarke identisch. Wenn sich dieser Wert von acpStart unterscheidet, wurde text vor dem Einfügen des Objekts ausgewählt.
acpNewEnd	Die endende Anwendungszeichenposition 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 pchText-Parameter 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 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	textstor.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

Freigeben über