Método ITfInsertAtSelection::InsertTextAtSelection (msctf.h)

  • Artigo

Insere texto no ponto de seleção ou inserção.

Sintaxe

HRESULT InsertTextAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  const WCHAR  *pchText,
  [in]  LONG         cch,
  [out] ITfRange     **ppRange
);

Parâmetros

[in] ec

Identifica o contexto de edição. Isso é obtido de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] dwFlags

Campo de bits com um dos valores a seguir.

Valor Significado
TF_IAS_NOQUERY
 ppRange é NULL. Esse sinalizador não pode ser combinado com o sinalizador TF_IAS_QUERYONLY.
TF_IAS_QUERYONLY
 O contexto não é modificado, mas ppRange é definido como se a inserção tivesse ocorrido. O acesso somente leitura é suficiente. Se esse sinalizador não estiver definido, ec deverá ter acesso de leitura/gravação. Esse sinalizador não pode ser combinado com o sinalizador TF_IAS_NOQUERY.
TF_IAS_NO_DEFAULT_COMPOSITION
 O gerenciador não criará uma composição padrão se uma composição for necessária. O chamador deve criar um objeto de composição que cubra o texto inserido antes de liberar o bloqueio de contexto.

[in] pchText

Especifica o texto a ser inserido.

[in] cch

Especifica a contagem de caracteres do texto em pchText.

[out] ppRange

Recebe a posição do objeto inserido.

Retornar valor

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
 O método foi bem-sucedido.
TF_E_NOLOCK
 O serviço de texto não tem um bloqueio de documento
TF_E_DISCONNECTED
 O objeto de contexto não está em uma pilha de documentos.
TS_E_NOSELECTION
 O contexto não tem seleção.
TS_E_READONLY
 A seleção é somente leitura.

Comentários

Para inserir um objeto IDataObject em vez de texto, use ITfInsertAtSelection::InsertEmbeddedAtSelection.

Requisitos

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

Confira também

Idataobject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfInsertAtSelection

ITfInsertAtSelection::InsertEmbeddedAtSelection