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

Artigo
08/26/2023

O método ITextStoreAnchor::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 IDataObject no fluxo de texto.

Sintaxe

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD       dwFlags,
  [in]  IDataObject *pDataObject,
  [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 do objeto.

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, por exemplo, para prever os resultados do recolhimento ou ajustar uma seleção de outra forma.

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, por exemplo, para prever os resultados do recolhimento ou ajustar uma seleção de outra forma.

[in] pDataObject

Ponteiro para o objeto IDataObject a ser inserido.

[out] ppaStart

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

[out] ppaEnd

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

Retornar valor

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.
E_OUTOFMEMORY	O método não pôde instanciar uma das âncoras paStart ou paEnd.
TS_E_NOLOCK	O chamador não tem um bloqueio no documento.

Comentários

Os clientes devem usar esse método para inserir um objeto em um fluxo de texto, pois uma constante TS_CHAR_EMBEDDED não pode ser passada para ITextStoreAnchor::SetText.

Requisitos

Requisito	Valor
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