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

Article
03/04/2024

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.

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 paTestStart ou paTestEnd ne sont pas valides.
E_OUTOFMEMORY	La tentative d’instancier les ancres ppaResultStart et/ou ppaResultEnd a échoué.

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

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	textstor.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Partager via