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

La méthode ITextStoreAnchor ::QueryInsert détermine si les ancres 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]  IAnchor *paTestStart,
  [in]  IAnchor *paTestEnd,
  [in]  ULONG   cch,
  [out] IAnchor **ppaResultStart,
  [out] IAnchor **ppaResultEnd
);

Paramètres

[in] paTestStart

Reçoit un pointeur vers une ancre de début pour le texte inséré.

[in] paTestEnd

Reçoit un pointeur vers une ancre de fin pour le texte inséré. Il s’agit de la même chose que paTestStart si le texte est inséré à un point au lieu de remplacer le texte sélectionné.

[in] cch

Longueur du texte de remplacement.

[out] ppaResultStart

Pointeur vers le nouvel objet d’ancrage à l’emplacement de départ du texte inséré. Si la valeur de ce paramètre est NULL, le texte ne peut pas être inséré à la position spécifiée. Cette ancre ne peut pas être en dehors du document.

[out] ppaResultEnd

Pointeur vers le nouvel objet d’ancrage à l’emplacement de fin du texte inséré. Si la valeur de ce paramètre est NULL, le texte ne peut pas être inséré à la position spécifiée. Cette ancre ne peut pas être en dehors du document.

Valeur retournée

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

Remarques

Les valeurs de ppaResultStart et ppaResultEnd dépendent de la façon dont l’application insère du texte dans le document. Si ppaResultStart et ppaResultEnd sont identiques à paTestStart, le curseur se trouve au début du texte inséré après l’insertion. Si ppaResultStart et ppaResultEnd sont identiques à paTextEnd, le curseur se trouve à la fin du texte inséré après insertion.

Configuration requise