Compartilhar via


Método ITextStoreAnchor::InsertTextAtSelection (textstor.h)

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

Sintaxe

HRESULT InsertTextAtSelection(
  [in]  DWORD       dwFlags,
  [in]  const WCHAR *pchText,
  [in]  ULONG       cch,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

Parâmetros

[in] dwFlags

Especifica se os parâmetros paStart e paEnd conterão os resultados da inserção de texto.

Os sinalizadores TF_IAS_NOQUERY e TF_IAS_QUERYONLY não podem ser combinados.

Valor Significado
TF_IAS_NOQUERY
O texto é inserido e os valores dos parâmetros ppaStart e ppaEnd podem ser NULL. Use esse sinalizador se os resultados da inserção de texto não forem necessários.
TF_IAS_QUERYONLY
O texto não é inserido e as âncoras ppaStart e ppaEnd contêm os resultados da inserção de texto. Os valores desses parâmetros dependem de como o aplicativo implementa a inserção de texto em um documento. Use esse sinalizador para exibir os resultados da inserção de texto sem realmente inserir o texto. O texto de comprimento zero pode ser inserido.

[in] pchText

Ponteiro para a cadeia de caracteres a ser inserida no documento. A cadeia de caracteres pode ser terminada em NULL .

[in] cch

Especifica o comprimento do texto.

[out] ppaStart

Ponteiro para o objeto de âncora no início da inserção de texto.

[out] ppaEnd

Ponteiro para o objeto de âncora no final da inserção de texto. Para um ponto de inserção, esse valor de parâmetro será o mesmo que o valor do parâmetro ppaStart .

Valor retornado

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
O método foi bem-sucedido.
E_FAIL
O método não pôde instanciar uma das âncoras paStart ou paEnd.
E_INVALIDARG
O parâmetro pchText é inválido.
TS_E_NOLOCK
O chamador não tem um bloqueio no documento.

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 textstor.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

Composições

ITextStoreAnchor

ITextStoreAnchorSink::OnTextChange

Constantes TF_IAS_*

TS_TEXTCHANGE