Compartilhar via


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

O método ITextStoreACP::InsertTextAtSelection insere texto no ponto de inserção ou seleção. Um chamador deve ter um bloqueio de leitura/gravação no documento antes de inserir texto.

Sintaxe

HRESULT InsertTextAtSelection(
  [in]  DWORD         dwFlags,
  [in]  const WCHAR   *pchText,
  [in]  ULONG         cch,
  [out] LONG          *pacpStart,
  [out] LONG          *pacpEnd,
  [out] TS_TEXTCHANGE *pChange
);

Parâmetros

[in] dwFlags

Especifica se os parâmetros pacpStart e pacpEnd e a estrutura TS_TEXTCHANGE contêm os resultados da inserção de texto.

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

Valor Significado
0
A inserção de texto ocorrerá e os parâmetros pacpStart e pacpEnd conterão os resultados da inserção de texto. A estrutura TS_TEXTCHANGE deve ser preenchida com esse sinalizador.
TF_IAS_NOQUERY
O texto é inserido, os valores dos parâmetros pacpStart e pacpEnd podem ser NULL e a estrutura TS_TEXTCHANGE deve ser preenchida. Use esse sinalizador para exibir os resultados da inserção de texto.
TF_IAS_QUERYONLY
O texto não é inserido e os valores dos parâmetros pacpStart e pacpEnd 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. Para obter mais informações, consulte a seção Comentários. Use esse sinalizador para exibir os resultados da inserção de texto sem realmente inserir o texto. Não é necessário preencher a estrutura de TS_TEXTCHANGE se você usar esse sinalizador.

[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] pacpStart

Ponteiro para a posição inicial do caractere do aplicativo em que ocorre a inserção de texto.

[out] pacpEnd

Ponteiro para a posição final do caractere do aplicativo em que a inserção de texto ocorre. Esse valor de parâmetro é o mesmo que o valor do parâmetro pacpStart para um ponto de inserção.

[out] pChange

Ponteiro para uma estrutura TS_TEXTCHANGE com os membros a seguir.

Valor Significado
acpStart
A posição inicial do caractere do aplicativo antes que o texto seja inserido no documento.
acpOldEnd
A posição final do caractere do aplicativo antes que o texto seja inserido no documento. Esse valor é o mesmo que acpStart para um ponto de inserção. Se esse valor for diferente de acpStart, o texto foi selecionado antes da inserção de texto.
acpNewEnd
A posição final após a inserção de texto.

Retornar valor

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
O método foi bem-sucedido.
TS_E_NOLOCK
O chamador não tem um bloqueio no documento.
E_INVALIDARG
O parâmetro pchText é inválido.

Comentários

Os valores dos parâmetros pacpStart e pacpEnd dependem de como o aplicativo cliente insere texto em um documento. Por exemplo, se o aplicativo definir o cursor no início do texto inserido após a inserção de texto, o valor dos parâmetros pacpStart e pacpEnd será o mesmo que o membro acpStart da estrutura TS_TEXTCHANGE .

Os aplicativos não devem chamar o método ITextStoreACPSink::OnTextChange em resposta a esse método.

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

Confira também

Composições

Itextstoreacp

ITextStoreACPSink::OnTextChange

Constantes TF_IAS_*

TS_TEXTCHANGE