Méthode ITfInsertAtSelection::InsertEmbeddedAtSelection (msctf.h)

Article
08/24/2023

La méthode ITfInsertAtSelection::InsertEmbeddedAtSelection insère un objet IDataObject au point de sélection ou d’insertion.

Syntaxe

HRESULT InsertEmbeddedAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  IDataObject  *pDataObject,
  [out] ITfRange     **ppRange
);

Paramètres

[in] ec

Identifie le contexte de modification. Ceci est obtenu à partir de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] dwFlags

Champ bit avec l’une des valeurs suivantes :

TF_IAS_NOQUERY

Le paramètre ppRange est NULL à la sortie.

TF_IAS_QUERYONLY

Le contexte n’est pas modifié, mais le paramètre ppRange est défini comme si l’insertion s’était produite. L’accès en lecture seule est suffisant. Si cet indicateur n’est pas défini, le paramètre ec doit avoir un accès en lecture/écriture.

TF_IAS_NO_DEFAULT_COMPOSITION

Le gestionnaire TSF ne crée pas de composition par défaut si une composition est requise. L’appelant doit créer un objet de composition qui couvre le texte inséré avant de libérer le verrou de contexte.

[in] pDataObject

Pointeur vers l’objet à insérer.

[out] ppRange

Position de l’objet inséré. Optionnel.

Valeur retournée

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

Valeur	Description
S_OK	La méthode a réussi.
TF_E_NOLOCK	Le paramètre ec est un cookie d’édition non valide.
TF_E_DISCONNECTED	L’objet context ne se trouve pas sur une pile de documents.
TS_E_NOSELECTION	Le contexte n’a pas de sélection.
TS_E_READONLY	La sélection est en lecture seule.
TF_E_FORMAT	Le propriétaire du contexte ne peut pas gérer les objets du type fourni par le paramètre pDataObject .

Notes

Les appelants peuvent utiliser la méthode ITfQueryEmbedded::QueryInsertEmbedded pour déterminer si un type d’objet particulier est susceptible d’être accepté par cette méthode.

Pour insérer du texte au lieu d’un objet IDataObject , utilisez la méthode ITfInsertAtSelection::InsertTextAtSelection .

Spécifications


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	msctf.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel