Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Die Methode war erfolgreich. |
|
Mindestens ein Parameter ist ungültig. |
|
Ein Speicherbelegungsfehler ist aufgetreten. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
Der von ec identifizierte Bearbeitungskontext verfügt nicht über eine Lese-/Schreibsperre. |
|
Der Bearbeitungskontext ist schreibgeschützt. |
|
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 |