Condividi tramite

Metodo Commands2.AddNamedCommand2

  • Articolo

Crea un comando denominato che viene salvato dall'ambiente e reso disponibile la volta successiva che l'ambiente verrà avviata, anche se il componente aggiuntivo non viene caricato all'avvio dell'ambiente.

Spazio dei nomi:  EnvDTE80
Assembly:  EnvDTE80 (in EnvDTE80.dll)

Sintassi

'Dichiarazione
Function AddNamedCommand2 ( _
    AddInInstance As AddIn, _
    Name As String, _
    ButtonText As String, _
    Tooltip As String, _
    MSOButton As Boolean, _
    Bitmap As Object, _
    ByRef ContextUIGUIDs As Object(), _
    vsCommandStatusValue As Integer, _
    CommandStyleFlags As Integer, _
    ControlType As vsCommandControlType _
) As Command

Command AddNamedCommand2(
    AddIn AddInInstance,
    string Name,
    string ButtonText,
    string Tooltip,
    bool MSOButton,
    Object Bitmap,
    ref Object[] ContextUIGUIDs,
    int vsCommandStatusValue,
    int CommandStyleFlags,
    vsCommandControlType ControlType
)

Command^ AddNamedCommand2(
    [InAttribute] AddIn^ AddInInstance, 
    [InAttribute] String^ Name, 
    [InAttribute] String^ ButtonText, 
    [InAttribute] String^ Tooltip, 
    [InAttribute] bool MSOButton, 
    [InAttribute] Object^ Bitmap, 
    [InAttribute] array<Object^>^% ContextUIGUIDs, 
    [InAttribute] int vsCommandStatusValue, 
    [InAttribute] int CommandStyleFlags, 
    [InAttribute] vsCommandControlType ControlType
)

abstract AddNamedCommand2 : 
        AddInInstance:AddIn * 
        Name:string * 
        ButtonText:string * 
        Tooltip:string * 
        MSOButton:bool * 
        Bitmap:Object * 
        ContextUIGUIDs:Object[] byref * 
        vsCommandStatusValue:int * 
        CommandStyleFlags:int * 
        ControlType:vsCommandControlType -> Command 

function AddNamedCommand2(
    AddInInstance : AddIn, 
    Name : String, 
    ButtonText : String, 
    Tooltip : String, 
    MSOButton : boolean, 
    Bitmap : Object, 
    ContextUIGUIDs : Object[], 
    vsCommandStatusValue : int, 
    CommandStyleFlags : int, 
    ControlType : vsCommandControlType
) : Command

Parametri

  • AddInInstance
    Tipo: EnvDTE.AddIn
    obbligatorio.AddIn L'oggetto sta aggiungendo del nuovo comando.
  • Name
    Tipo: System.String
    obbligatorio.La forma breve del nome per il nuovo comando. AddNamedCommand2 utilizza la prefazione Addins.Progid. per creare un nome univoco.
  • ButtonText
    Tipo: System.String
    obbligatorio.Il nome da utilizzare se il comando è associato a un pulsante che consente di visualizzare per nome anziché dall'icona.
  • Tooltip
    Tipo: System.String
    obbligatorio.Il testo visualizzato quando l'utente posiziona il puntatore del mouse su qualsiasi limite del controllo al nuovo comando.
  • MSOButton
    Tipo: System.Boolean
    obbligatorio.Indica come parametro bitmap viene interpretato.
    se il valore è true, Bitmap è l'ID di una bitmap di Microsoft Office.
    se MSOButton viene false, quindi Bitmap può essere:
    Da A Bitmap
    - Icon
    - Un IPicture
    - L'ID di una risorsa bitmap di 16x16 (ma non di una risorsa icona) fornita dal componente aggiuntivo.Visual Studio innanzitutto cerca nella DLL satellite aggiuntivo.Se la risorsa non viene trovata caso, la DLL del componente aggiuntivo verrà trovato.
  • Bitmap
    Tipo: System.Object
    facoltativo.L'ID di una bitmap da visualizzare sul pulsante.vedere MSOButton.
  • ContextUIGUIDs
    Tipo: array<System.Object[]%
    facoltativo.SafeArray di GUID che determina quali contesti dell'ambiente (ovvero modalità di debug, modalità progettazione, e così via) per indicare al comando.vedere vsCommandDisabledFlags.
  • vsCommandStatusValue
    Tipo: System.Int32
    facoltativo.Determina se lo stato disabilitato comando è invisibile o grigio quando si immette un oggetto ContextUIGUIDs e non sono attualmente attiva.
  • CommandStyleFlags
    Tipo: System.Int32
    facoltativo.Determina lo stato di comando quando si immette un oggetto ContextUIGUIDs ma nessuno dei contesti specificati sono attualmente attiva.Questo parametro è necessario includere sempre vsCommandStatusSupported.Se include inoltre vsCommandStatusEnabled, il comando viene attivato.

Valore restituito

Tipo: EnvDTE.Command
il comando denominato che è stato creato.

Note

Per informazioni su come ottenere i valori della bitmap ID dei pulsanti di MSO, vedere Superfici pulsanti dell'elenco nella barra dei comandi per Microsoft Office System.

i componenti aggiuntivi essere modificate in un secondo momento ButtonText nome rispondere a QueryStatus metodo.Se il testo inizia con #, il resto della stringa è un Integer che rappresenta un ID di risorsa nella DLL satellite registrato aggiuntivo.

ContextUIGUIDs parametro e vsCommandStatusValue il parametro viene utilizzato quando il componente aggiuntivo non viene caricato e non può rispondere quindi a QueryStatus metodo.se ContextUIGUIDs è vuoto, il comando viene attivato fino a caricare e possa rispondere il componente aggiuntivo a QueryStatus.

il componente aggiuntivo può ricevere la notifica di chiamata con IDTCommandTarget interfaccia.Un pulsante può essere aggiunti tramite OnConnection metodo di IDTExtensibility2 interfaccia.

Sicurezza di .NET Framework

Vedere anche

Riferimenti

Commands2 Interfaccia

Spazio dei nomi EnvDTE80