ITextStoreACP2 ::QueryInsert, méthode (textstor.h)

Article
03/02/2024

Détermine si les positions des caractères de début et de fin spécifiées sont valides. Utilisez cette méthode pour ajuster une modification à un document avant d’exécuter la modification. La méthode ne doit pas retourner de valeurs en dehors de la plage du document.

Syntaxe

HRESULT QueryInsert(
  [in]  LONG  acpTestStart,
  [in]  LONG  acpTestEnd,
  [in]  ULONG cch,
  [out] LONG  *pacpResultStart,
  [out] LONG  *pacpResultEnd
);

Paramètres

[in] acpTestStart

Position du caractère de démarrage de l’application pour le texte inséré.

[in] acpTestEnd

Position du caractère d’application de fin pour le texte inséré. Cette valeur est égale à acpTextStart si le texte est inséré à un point au lieu de remplacer le texte sélectionné.

[in] cch

Longueur du texte de remplacement.

[out] pacpResultStart

Retourne la nouvelle position du caractère d’application de départ du texte inséré. Si ce paramètre a la valeur NULL, le texte ne peut pas être inséré à la position spécifiée. Cette valeur ne peut pas être en dehors de la plage de documents.

[out] pacpResultEnd

Retourne la nouvelle position du caractère d’application de fin du texte inséré. Si ce paramètre a la valeur NULL, pacpResultStart est défini sur NULL et le texte ne peut pas être inséré à la position spécifiée. Cette valeur ne peut pas être en dehors de la plage de documents.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a réussi.
E_FAIL	Une erreur non spécifiée s'est produite.
E_INVALIDARG	Les paramètres acpTestStart ou acpTestEnd ne sont pas valides.

Remarques

Les valeurs de pacpResultStart et pacpResultEnd dépendent de la façon dont l’application insère du texte dans le document. Si pacpResultStart et pacpResultEnd sont identiques à acpTextStart, le curseur se trouve au début du texte inséré après l’insertion. Si pacpResultStart et pacpResultEnd sont identiques à acpTextEnd, le curseur se trouve à la fin du texte inséré après l’insertion. Si la différence entre pacpResultStart et pacpResultEnd est égale à la longueur du texte inséré, le texte inséré est mis en surbrillance après l’insertion.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	textstor.h
DLL	Msctf.dll

Voir aussi

ITextStoreACP2

Partager via