Partager via


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

La méthode ITextStoreACP ::QueryInsert détermine si les positions de caractère 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 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête textstor.h
DLL Msctf.dll
Composant redistribuable TSF 1.0 sur Windows 2000 Professionnel