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

O método ITextStoreACP::QueryInsert determina se as posições de caractere 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]  LONG  acpTestStart,
  [in]  LONG  acpTestEnd,
  [in]  ULONG cch,
  [out] LONG  *pacpResultStart,
  [out] LONG  *pacpResultEnd
);

Parâmetros

[in] acpTestStart

Iniciando a posição do caractere do aplicativo para o texto inserido.

[in] acpTestEnd

Posição final do caractere do aplicativo para o texto inserido. Esse valor será igual a acpTextStart se o texto for inserido em um ponto em vez de substituir o texto selecionado.

[in] cch

Comprimento do texto de substituição.

[out] pacpResultStart

Retorna a nova posição de caractere de aplicativo inicial do texto inserido. Se esse parâmetro for NULL, o texto não poderá ser inserido na posição especificada. Esse valor não pode estar fora do intervalo de documentos.

[out] pacpResultEnd

Retorna a nova posição de caractere de aplicativo final do texto inserido. Se esse parâmetro for NULL, pacpResultStart será definido como NULL e o texto não poderá ser inserido na posição especificada. Esse valor não pode estar fora do intervalo de documentos.

Retornar valor

Esse método pode retornar um desses valores.

Comentários

Os valores de pacpResultStart e pacpResultEnd dependem de como o aplicativo insere texto no documento. Se pacpResultStart e pacpResultEnd forem iguais a acpTextStart, o cursor estará no início do texto inserido após a inserção. Se pacpResultStart e pacpResultEnd forem iguais a acpTextEnd, o cursor estará no final do texto inserido após a inserção. Se a diferença entre pacpResultStart e pacpResultEnd for igual ao comprimento do texto inserido, o texto inserido será realçado após a inserção.

Requisitos