ITfProperty::SetValueStore-Methode (msctf.h)

Artikel
08/24/2023

Legt den Wert der -Eigenschaft für einen Textbereich mithilfe eines Eigenschaftenspeicherobjekts fest.

Syntax

HRESULT SetValueStore(
  [in] TfEditCookie     ec,
  [in] ITfRange         *pRange,
  [in] ITfPropertyStore *pPropStore
);

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] pPropStore

Zeiger auf eine ITfPropertyStore-Schnittstelle , die die Eigenschaftendaten abruft.

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_FAIL	Es ist ein unbekannter Fehler aufgetreten.
TF_E_NOLOCK	Der von ec identifizierte Bearbeitungskontext verfügt nicht über eine Lese-/Schreibsperre.

Hinweise

Eigenschaftswerte, die mit ITfProperty::SetValue festgelegt sind, werden verworfen, wenn der Text, den der Eigenschaftswert abdeckt, geändert wird. Verwenden Sie ITfProperty::SetValueStore , um die Kontrolle darüber zu erhalten, was mit einem Eigenschaftswert geschieht, wenn der Text geändert wird.

Mit ITfProperty::SetValue 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


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