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

Define a seleção dentro do documento.

Sintaxe

HRESULT SetSelection(
  [in] TfEditCookie       ec,
  [in] ULONG              ulCount,
  [in] const TF_SELECTION *pSelection
);

Parâmetros

[in] ec

Contém um cookie de edição que identifica a sessão de edição. Esse é o valor passado para ITfEditSession::D oEditSession.

[in] ulCount

Especifica o número de seleções na matriz pSelection .

[in] pSelection

Uma matriz de estruturas TF_SELECTION que contêm as informações de cada seleção.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
TF_E_NOSELECTION	O documento não tem seleção.
TF_E_NOLOCK	O cookie no ec é inválido.

Comentários

Uma seleção é um intervalo de texto realçado ou um ponto de inserção se o intervalo estiver vazio, identificando a área de foco do usuário em um documento. Alguns documentos são capazes de ter várias seleções. Só pode haver uma seleção de comprimento zero na pSelection , pois ela representa a posição do cursor do documento.

Se um aplicativo precisar ajustar o texto coberto por uma seleção, ele deverá aguardar até que o chamador libere o bloqueio. No entanto, os aplicativos podem ajustar qualquer um dos membros de estilo das estruturas TF_SELECTION enquanto ainda retornam S_OK.

O chamador só poderá definir o sinalizador fInterimChar se uma seleção estiver definida. Nesse caso, a seleção deve abranger exatamente um caractere e o membro ase da estrutura TF_SELECTION está definido como TFAE_NONE.

Requisitos

Requisito	Valor
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, ITfEditSession::D oEditSession, estrutura TF_SELECTION, ITfContext::GetSelection