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

O método ITextStoreAnchor::QueryInsert determina se as âncoras inicial e final especificadas são válidas. Use esse método para ajustar uma edição a um documento antes de executar a edição. O método não deve retornar valores fora do intervalo do documento.

Sintaxe

HRESULT QueryInsert(
  [in]  IAnchor *paTestStart,
  [in]  IAnchor *paTestEnd,
  [in]  ULONG   cch,
  [out] IAnchor **ppaResultStart,
  [out] IAnchor **ppaResultEnd
);

Parâmetros

[in] paTestStart

Recebe um ponteiro para uma âncora inicial para o texto inserido.

[in] paTestEnd

Recebe um ponteiro para uma âncora final para o texto inserido. Isso será o mesmo que paTestStart se o texto for inserido em um ponto em vez de substituir o texto selecionado.

[in] cch

Comprimento do texto de substituição.

[out] ppaResultStart

Ponteiro para o novo objeto de âncora no local inicial do texto inserido. Se o valor desse parâmetro for NULL, o texto não poderá ser inserido na posição especificada. Essa âncora não pode estar fora do documento.

[out] ppaResultEnd

Ponteiro para o novo objeto de âncora no local final do texto inserido. Se o valor desse parâmetro for NULL, o texto não poderá ser inserido na posição especificada. Essa âncora não pode estar fora do documento.

Retornar valor

Esse método pode retornar um desses valores.

Comentários

Os valores de ppaResultStart e ppaResultEnd dependem de como o aplicativo insere texto no documento. Se ppaResultStart e ppaResultEnd forem iguais a paTestStart, o cursor estará no início do texto inserido após a inserção. Se ppaResultStart e ppaResultEnd forem iguais a paTextEnd, o cursor estará no final do texto inserido após a inserção.

Requisitos