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

Artigo
08/26/2023

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