ITfContext::GetAppProperty-Methode (msctf.h)

  • Artikel

Ruft eine Anwendungseigenschaft ab.

Syntax

HRESULT GetAppProperty(
  [in]  REFGUID             guidProp,
  [out] ITfReadOnlyProperty **ppProp
);

Parameter

[in] guidProp

Gibt den Eigenschaftenbezeichner an. Dies kann ein benutzerdefinierter Bezeichner oder einer der vordefinierten Eigenschaftenbezeichner sein.

[out] ppProp

Zeiger auf einen ITfReadOnlyProperty-Schnittstellenzeiger , der das Eigenschaftsobjekt empfängt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert BESCHREIBUNG
S_OK
 Die Methode war erfolgreich.
S_FALSE
 Der Kontextbesitzer unterstützt die Eigenschaft nicht.
TF_E_DISCONNECTED
 Der Kontext befindet sich nicht in einem Dokumentstapel.
E_INVALIDARG
 Mindestens ein Parameter ist ungültig.
E_OUTOFMEMORY
 Ein Speicherbelegungsfehler ist aufgetreten.
E_NOTIMPL
 Der Kontextbesitzer implementiert diese Methode nicht.
E_FAIL
 Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Anwendungen können eindeutige Eigenschaften definieren, die durch eine GUID identifiziert werden. Eigenschaften werden als VARIANT-Daten gespeichert, sodass der Aufrufer das Format und die Bedeutung eindeutiger Eigenschaften erkennen muss, um sie verwenden zu können.

Anwendungseigenschaften unterscheiden sich von Texteigenschaften, die von ITfContext::GetProperty abgerufen werden, da Anwendungseigenschaften vom Kontextbesitzer verwaltet werden und nicht von einem Textdienst geändert werden können. Anwendungseigenschaften können nur vom Kontextbesitzer geändert werden.

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

Weitere Informationen

ITfContext-Schnittstelle, ITfContext::GetProperty, ITfReadOnlyProperty-Schnittstelle, Vordefinierte Eigenschaften