Compartilhar via

Método ITfContext::GetAppProperty (msctf.h)

  • Artigo

Obtém uma propriedade de aplicativo.

Sintaxe

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

Parâmetros

[in] guidProp

Especifica o identificador de propriedade. Esse pode ser um identificador personalizado ou um dos identificadores de propriedade predefinidos.

[out] ppProp

Ponteiro para um ponteiro de interface ITfReadOnlyProperty que recebe o objeto de propriedade.

Valor retornado

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
 O método foi bem-sucedido.
S_FALSE
 O proprietário do contexto não dá suporte à propriedade .
TF_E_DISCONNECTED
 O contexto não está em uma pilha de documentos.
E_INVALIDARG
 Um ou mais parâmetros são inválidos.
E_OUTOFMEMORY
 Ocorreu uma falha de alocação de memória.
E_NOTIMPL
 O proprietário do contexto não implementa esse método.
E_FAIL
 Ocorreu um erro não especificado.

Comentários

Os aplicativos podem definir propriedades exclusivas identificadas por um GUID. As propriedades são armazenadas como dados VARIANT, portanto, o chamador deve reconhecer o formato e o significado das propriedades exclusivas para poder usá-las.

As propriedades do aplicativo diferem das propriedades de texto, obtidas por ITfContext::GetProperty, na mesma, as propriedades do aplicativo são mantidas pelo proprietário do contexto e não podem ser modificadas por um serviço de texto. As propriedades do aplicativo só podem ser modificadas pelo proprietário do contexto.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho msctf.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

Interface ITfContext, ITfContext::GetProperty, interface ITfReadOnlyProperty, Propriedades Predefinidas