Partager via


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

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

Voir aussi

Idataobject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfInsertAtSelection

ITfInsertAtSelection::InsertTextAtSelection

ITfQueryEmbedded::QueryInsertEmbedded