Metodo ITfContext::GetAppProperty (msctf.h)

  • Articolo

Ottiene una proprietà dell'applicazione.

Sintassi

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

Parametri

[in] guidProp

Specifica l'identificatore della proprietà. Questo può essere un identificatore personalizzato o uno degli identificatori di proprietà predefiniti.

[out] ppProp

Puntatore a un puntatore dell'interfaccia ITfReadOnlyProperty che riceve l'oggetto proprietà.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Descrizione
S_OK
 Il metodo è stato eseguito correttamente.
S_FALSE
 Il proprietario del contesto non supporta la proprietà.
TF_E_DISCONNECTED
 Il contesto non è in uno stack di documenti.
E_INVALIDARG
 Uno o più parametri non sono validi.
E_OUTOFMEMORY
 Si è verificato un errore di allocazione della memoria.
E_NOTIMPL
 Il proprietario del contesto non implementa questo metodo.
E_FAIL
 Si è verificato un errore non specificato.

Commenti

Le applicazioni possono definire proprietà univoce identificate da un GUID. Le proprietà vengono archiviate come dati VARIANT, quindi il chiamante deve riconoscere il formato e il significato delle proprietà univoche per poterle usare.

Le proprietà dell'applicazione differiscono dalle proprietà di testo ottenute da ITfContext::GetProperty, in quanto le proprietà dell'applicazione vengono gestite dal proprietario del contesto e non possono essere modificate da un servizio di testo. Le proprietà dell'applicazione possono essere modificate solo dal proprietario del contesto.

Requisiti

   
Client minimo supportato Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione msctf.h
DLL Msctf.dll
Componente ridistribuibile TSF 1.0 in Windows 2000 Professional

Vedi anche

Interfaccia ITfContext, ITfContext::GetProperty, interfacciaITfReadOnlyProperty, Proprietà predefinite