Partager via


ExpansionProvider.FindExpansionByShortcut, méthode

Obtient le chemin d'accès et le titre d'un extrait de code donné le nom du raccourci de l'extrait de code.

Espace de noms :  Microsoft.VisualStudio.Package
Assemblys :   Microsoft.VisualStudio.Package.LanguageService.10.0 (dans Microsoft.VisualStudio.Package.LanguageService.10.0.dll)
  Microsoft.VisualStudio.Package.LanguageService (dans Microsoft.VisualStudio.Package.LanguageService.dll)
  Microsoft.VisualStudio.Package.LanguageService.9.0 (dans Microsoft.VisualStudio.Package.LanguageService.9.0.dll)
  Microsoft.VisualStudio.Package.LanguageService.11.0 (dans Microsoft.VisualStudio.Package.LanguageService.11.0.dll)

Syntaxe

'Déclaration
Public Overridable Function FindExpansionByShortcut ( _
    view As IVsTextView, _
    shortcut As String, _
    span As TextSpan, _
    showDisambiguationUI As Boolean, _
    <OutAttribute> ByRef title As String, _
    <OutAttribute> ByRef path As String _
) As Integer
public virtual int FindExpansionByShortcut(
    IVsTextView view,
    string shortcut,
    TextSpan span,
    bool showDisambiguationUI,
    out string title,
    out string path
)

Paramètres

  • shortcut
    Type : System.String
    [in] chaîne d'Un contenant le nom de raccourci de l'extrait de code.
  • showDisambiguationUI
    Type : System.Boolean
    [in] c'est true si une interface utilisateur peut être montrée aux noms de doublon de résolution ; sinon, false signifie pour sélectionner la première expansion recherchée qui correspond à le nom de raccourci.
  • title
    Type : System.String%
    [] retourne le titre de l'extrait de code recherché.
  • path
    Type : System.String%
    [] retourne le chemin d'accès au fichier modèle d'extrait de code.

Valeur de retour

Type : System.Int32
Si un modèle d'expansion était recherché, retourne S_OK ; sinon, retours code d'erreur de l'énumération d'VSConstants.

Remarques

Cette méthode d'assistance est appelée par votre code de service de langage.Une expansion peut se produire parce que l'utilisateur a sélectionné un raccourci d'expansion d'une liste (voient la méthode d'DisplayExpansionBrowser) ou on tape un personnage particulier qui déclenche une expansion.Par exemple, tapant un espace après avoir tapé « if » peut déclencher une expansion dans « if () { } » où le curseur est positionné entre parenthèses (c'est également appelé la saisie semi-automatique).Dans ce cas, le mot « if » est le raccourci de l'extrait de code.Si vous gérez des saisies semi-automatiques comme celui-ci, vous appelleriez la méthode d'FindExpansionByShortcut lorsqu'un espace ou un onglet est tapé.Si la méthode d'FindExpansionByShortcut retourne un chemin d'accès, alors l'extrait de code peut être développé par un appel à la méthode d'InsertNamedExpansion.

Voyez l'exemple dans la classe d'ExpansionProvider pour voir comment cette méthode est utilisée.

Lorsqu'un raccourci correspond à le plusieurs extrait de code et showDisambiguationUI condition est vraie, une liste de choix possibles affichant le titre de l'extrait de code peut être affichée pour ce résoudre à l'utilisateur le conflit.

La méthode de base obtient un objet d'IVsTextManager du service d'SVsTextManager et appelle la méthode d'GetExpansionByShortcut sur l'objet d'IVsTextManager.La méthode d'GetExpansionByShortcut exécute tout le travail.La méthode de base true retourne si la méthode d'GetExpansionByShortcut retourne code de réussite.

Sécurité .NET Framework

Voir aussi

Référence

ExpansionProvider Classe

Microsoft.VisualStudio.Package, espace de noms