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

O método ITextStoreACP::InsertEmbeddedAtSelection insere um objeto IDataObject no ponto de inserção ou seleção. O cliente que chama esse método deve ter um bloqueio de leitura/gravação antes de inserir um objeto IDataObject no documento.

Sintaxe

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD         dwFlags,
  [in]  IDataObject   *pDataObject,
  [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 conterão os resultados da inserção do objeto.

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 se os resultados da inserção de texto não forem necessários.
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, por exemplo, para prever os resultados do recolhimento ou ajustar uma seleção de outra forma. Não é necessário preencher a estrutura TS_TEXTCHANGE com esse sinalizador.

[in] pDataObject

Ponteiro para o objeto IDataObject a ser inserido.

[out] pacpStart

Ponteiro para a posição inicial do caractere do aplicativo em que a inserção do objeto ocorrerá.

[out] pacpEnd

Ponteiro para a posição final do caractere do aplicativo em que a inserção do objeto ocorrerá. Esse valor de parâmetro será 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 objeto seja inserido no documento.
acpOldEnd	A posição final do caractere do aplicativo antes que o objeto 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 do objeto.
acpNewEnd	A posição final do caractere do aplicativo após a inserção do objeto.

Retornar valor

Esse método pode retornar um desses valores.

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

Comentários

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

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

Idataobject

Itextstoreacp

Constantes TF_IAS_*

TS_TEXTCHANGE