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

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