ITfRange::GetEmbedded-Methode (msctf.h)

Artikel
08/24/2023

Die ITfRange::GetEmbedded-Methode ruft Inhalte ab, die einem TS_CHAR_EMBEDDED Zeichen im Textstream entsprechen. Der Startanker des Textbereichs befindet sich unmittelbar vor dem interessanten Zeichen.

Syntax

HRESULT GetEmbedded(
  [in]  TfEditCookie ec,
  [in]  REFGUID      rguidService,
  [in]  REFIID       riid,
  [out] IUnknown     **ppunk
);

Parameter

[in] ec

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

[in] rguidService

Bezeichner, der angibt, wie der eingebettete Inhalt abgerufen wird.

Wert	Bedeutung
GUID_TS_SERVICE_ACCESSIBLE	Die Ausgabe sollte ein Accessible-Objekt sein.
GUID_TS_SERVICE_ACTIVEX	Der Aufrufer erfordert einen direkten Zeiger auf das Objekt, das die durch riid angegebene Schnittstelle unterstützt.
GUID_TS_SERVICE_DATAOBJECT	Inhalt sollte als IDataObject-Datenübertragungsobjekt abgerufen werden, wobei riid IID_IDataObject ist. Clients sollten diese Option angeben, wenn eine Kopie des Inhalts erforderlich ist.
Aufruferdefiniert	Textdienste und Kontextbesitzer können benutzerdefinierte GUIDs definieren.

[in] riid

UUID der Schnittstelle des angeforderten Objekts.

[out] ppunk

Zeiger auf das Objekt. Es kann so umgewandelt werden, dass es riid entspricht.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
E_NOTIMPL	Die implementierenden Anwendungen machen keine eingebetteten Objekte in ihrem Textstream verfügbar.
TF_E_NOINTERFACE	Das -Objekt unterstützt die angeforderte Schnittstelle nicht.
TF_E_NOLOCK	Der Wert im ec-Parameter ist ein ungültiges Cookie, oder der Aufrufer verfügt nicht über eine schreibgeschützte Sperre.
TF_E_NOOBJECT	Der Startanker des Bereichs wird nicht vor einem TF_CHAR_EMBEDDED Zeichen positioniert.
TF_E_NOSERVICE	Der Inhalt kann nicht zurückgegeben werden, um rguidService zu entsprechen.

Hinweise

Obwohl das abgerufene Objekt bestimmte Schnittstellen möglicherweise nicht unterstützt, ist es wahrscheinlich, dass das Objekt die Schnittstellen unterstützt, die eingebetteten Dokumenten oder Steuerelementen zugeordnet sind, z. B. IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache oder IDispatch. Der Aufrufer muss QueryInterface verwenden, um auf eine interessante Schnittstelle zu testen. Wenn die Methode erfolgreich ist, riid jedoch NULL ist, gibt die Anwendung das Vorhandensein eines eingebetteten Objekts an, macht das Objekt selbst jedoch nicht verfügbar. Textprozessoren können weiterhin von einer Benachrichtigung über den möglichen Wortumbruch profitieren.

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