ITfProperty::SetValue-Methode (msctf.h)

Artikel
02/29/2024

Legt den Wert der -Eigenschaft für einen Bereich fest.

Syntax

HRESULT SetValue(
  [in] TfEditCookie  ec,
  [in] ITfRange      *pRange,
  [in] const VARIANT *pvarValue
);

Parameter

[in] ec

Enthält ein Bearbeitungscookies, das den Bearbeitungskontext identifiziert. Dies wird von ITfDocumentMgr::CreateContext oder ITfEditSession::D oEditSession abgerufen.

[in] pRange

Zeiger auf eine ITfRange-Schnittstelle , die den Bereich enthält, für den der Eigenschaftswert festgelegt ist. Dieser Parameter darf nicht NULL sein. Diese Methode schlägt fehl, wenn pRange leer ist.

[in] pvarValue

Zeiger auf eine VARIANT-Struktur , die den neuen Eigenschaftswert enthält. Es werden nur Werte vom Typ VT_I4, VT_UNKNOWN, VT_BSTR und VT_EMPTY unterstützt.

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_OUTOFMEMORY	Ein Speicherbelegungsfehler ist aufgetreten.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
TF_E_NOLOCK	Der von ec identifizierte Bearbeitungskontext verfügt nicht über eine Lese-/Schreibsperre.
TF_E_READONLY	Der Bearbeitungskontext ist schreibgeschützt.
TF_E_NOTOWNEDRANGE	Der TSF-Manager besitzt den Bereich nicht.

Hinweise

Mit dieser Methode festgelegte Eigenschaftswerte werden verworfen, wenn der Text, den der Eigenschaftswert abdeckt, geändert wird. Verwenden Sie ITfProperty::SetValueStore, um benutzerdefinierte Kontrolle über eine Wertantwort auf Textbearbeitungen zu erhalten.

Mit dieser Methode festgelegte Werte werden serialisiert, mit Ausnahme von Werten vom Typ VT_UNKNOWN, die nicht serialisiert werden. Wenn ein Eigenschaftswert vom Typ VT_UNKNOWN serialisiert werden muss, verwenden Sie stattdessen ITfProperty::SetValueStore .

Überlappende Eigenschaftswerte desselben Typs werden nicht unterstützt.

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

Weitere Informationen

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfProperty::SetValueStore

ITfRange

Freigeben über