IVsExpansion.InsertNamedExpansion, méthode
Insère l'extrait de code avec le nom spécifié à la position spécifiée dans la mémoire tampon de texte.
Espace de noms : Microsoft.VisualStudio.TextManager.Interop
Assembly : Microsoft.VisualStudio.TextManager.Interop.8.0 (dans Microsoft.VisualStudio.TextManager.Interop.8.0.dll)
Syntaxe
'Déclaration
Function InsertNamedExpansion ( _
bstrTitle As String, _
bstrPath As String, _
tsInsertPos As TextSpan, _
pExpansionClient As IVsExpansionClient, _
guidLang As Guid, _
fShowDisambiguationUI As Integer, _
<OutAttribute> ByRef pSession As IVsExpansionSession _
) As Integer
int InsertNamedExpansion(
string bstrTitle,
string bstrPath,
TextSpan tsInsertPos,
IVsExpansionClient pExpansionClient,
Guid guidLang,
int fShowDisambiguationUI,
out IVsExpansionSession pSession
)
int InsertNamedExpansion(
[InAttribute] String^ bstrTitle,
[InAttribute] String^ bstrPath,
[InAttribute] TextSpan tsInsertPos,
[InAttribute] IVsExpansionClient^ pExpansionClient,
[InAttribute] Guid guidLang,
[InAttribute] int fShowDisambiguationUI,
[OutAttribute] IVsExpansionSession^% pSession
)
abstract InsertNamedExpansion :
bstrTitle:string *
bstrPath:string *
tsInsertPos:TextSpan *
pExpansionClient:IVsExpansionClient *
guidLang:Guid *
fShowDisambiguationUI:int *
pSession:IVsExpansionSession byref -> int
function InsertNamedExpansion(
bstrTitle : String,
bstrPath : String,
tsInsertPos : TextSpan,
pExpansionClient : IVsExpansionClient,
guidLang : Guid,
fShowDisambiguationUI : int,
pSession : IVsExpansionSession
) : int
Paramètres
bstrTitle
Type : String[in] le nom complet de l'extrait de code.
bstrPath
Type : String[dans le chemin complet au fichier d'extrait de code.
tsInsertPos
Type : Microsoft.VisualStudio.TextManager.Interop.TextSpan[in] spécifie l'emplacement dans la mémoire tampon de texte pour insérer l'extrait de code.
pExpansionClient
Type : Microsoft.VisualStudio.TextManager.Interop.IVsExpansionClient[in] reçoit des notifications sur le processus de mise en place. Cela peut être une valeur d'nullune référence null (Nothing en Visual Basic).
guidLang
Type : Guid[in] GUID du service de langage. Peut être nullune référence null (Nothing en Visual Basic). La valeur par défaut est le service de langage du fichier.
fShowDisambiguationUI
Type : Int32[in] c'est non nul (true) si une « interface utilisateur (UI) de désambiguisation » peut être montrée dans le cas où de plusieurs extraits de code portant le même nom sont recherchés. Si cette valeur est nulle (false) le premier extrait de code qui correspond à le nom est inséré.
pSession
Type : Microsoft.VisualStudio.TextManager.Interop.IVsExpansionSession%[] retourne un objet d'IVsExpansionSession qui est utilisé pendant que l'extrait de code est modifié en place.
Valeur de retour
Type : Int32
Si la méthode réussit, elle retourne S_OK.En cas d'échec, un code d'erreur est retourné.
Notes
Signature de COM
De textmgr2.idl :
HRESULT IVsExpansion::InsertNamedExpansion(
[in]BSTR bstrTitle,
[in] BSTR bstrPath,
[in] TextSpan tsInsertPos,
[in]IVsExpansionClient *pExpansionClient,
[in]GUID guidLang,
[in] bool fShowDisambiguationUI,
[out] IVsExpansionSession **pSession
);
Cette méthode utilisée pour insérer un extrait de code lorsque le nom et le chemin d'accès de l'extrait de code est connu. Le nom et le chemin d'accès peuvent être obtenus du raccourci de l'extrait de code en appelant la méthode d'M:Microsoft.VisualStudio.TextManager.Interop.IVsExpansionManager.GetExpansionByShortcut(Microsoft.VisualStudio.TextManager.Interop.IVsExpansionClient,System.Guid,System.String,Microsoft.VisualStudio.TextManager.Interop.IVsTextView,Microsoft.VisualStudio.TextManager.Interop.TextSpan[],System.Int32,System.String@,System.String@) dans l'interface d'IVsExpansionManager.
Cette méthode est en général appelée d'une implémentation de la méthode d'OnItemChosen dans l'interface d'IVsExpansionClient à mesure que la méthode d'OnItemChosen est donnée le nom et le chemin d'accès de l'extrait de code.
Si un objet d'IVsExpansionClient est fourni, il le reçoit avant (méthode d'OnBeforeInsertion) et après des notifications (de méthode d'OnAfterInsertion) pendant le processus de mise en place. Le client d'expansion est également utilisé pour valider le genre d'extrait de code (méthode d'IsValidKind) pour vérifier l'extrait de code peut être inséré réellement à l'emplacement spécifié.
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.