Commands2.AddNamedCommand2 – metoda

Článek
08/11/2011

Vytvoří pojmenované příkaz, který je uložen na životní prostředí a k dispozici při příštím spuštění prostředí i v případě, že doplněk není načten při spuštění prostředí.

Obor názvů: EnvDTE80
Sestavení: EnvDTE80 (v EnvDTE80.dll)

Syntaxe

'Deklarace
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

Parametry

AddInInstance
Typ: EnvDTE.AddIn
Povinné.AddIn Objektu je přidání nového příkazu.

Name
Typ: System.String
Povinné.Krátký formulář název nového příkazu.AddNamedCommand2používá předmluvě Addins.Progid. vytvořit jedinečný název.

ButtonText
Typ: System.String
Povinné.Název použít příkaz je vázán na tlačítko, které se zobrazí název spíše ikonou.

Tooltip
Typ: System.String
Povinné.Text zobrazí, když uživatel ukazatel ukazatel myši všechny ovládací prvky vázané na příkaz Nový.

MSOButton
Typ: System.Boolean
Povinné.Označuje, jak interpretovat parametr bitmapy.
Pokud je hodnota true, Bitmap je ID bitmapy sady Microsoft Office.
Pokud MSOButton je false, pak Bitmap mohou být následující:
-ABitmap
-KIcon
-O IPicture
-Identifikátor prostředku rastrový obrázek 16 x 16 (ale není prostředek ikonu) poskytovaná doplněk.Visual Studio bude nejprve hledají v doplňku jeho satelitní knihovny DLL.Pokud tam není nalezen zdroj, bude prohledán knihovnu DLL doplňku.

Bitmap
Typ: System.Object
Nepovinné.ID bitmapy na tlačítko zobrazit.Viz téma MSOButton.

ContextUIGUIDs
Typ: array<System.Object[]%
Nepovinné.Pole SafeArray z GUID určující příkaz Zobrazit které kontexty prostředí (to znamená režimu ladění, režim návrhu a podobně).Viz téma vsCommandDisabledFlags.

vsCommandStatusValue
Typ: System.Int32
Nepovinné.Určuje, zda zakázána příkazu je šedá nebo neviditelné zadáte ContextUIGUIDs a žádný není nyní aktivní.

CommandStyleFlags
Typ: System.Int32
Nepovinné.Určuje stav příkazu zadáte ContextUIGUIDs a žádná zadané kontextů není nyní aktivní.Tento parametr by měl vždy obsahovat vsCommandStatusSupported.Pokud také zahrnuje vsCommandStatusEnabled, příkaz bude povoleno..

ControlType
Typ: EnvDTE80.vsCommandControlType

Vrácená hodnota

Typ: EnvDTE.Command
Pojmenované příkaz, který byl vytvořen.

Poznámky

Informace o získání hodnoty ID MSO tlačítek bitmapy v Výpis čelí tlačítka na panelu příkazů pro systém Microsoft Office.

Doplňky můžete později změnit ButtonText odpovědi na název QueryStatus metody. Pokud text začíná #, zbytek řetězce je celé číslo představující číslo ID zdroje v doplňku společnosti registrované satelitní knihovny DLL.

ContextUIGUIDs Parametr a vsCommandStatusValue parametr se používají, když doplněk není načten a nemůže tedy reagovat na QueryStatus metody. Pokud ContextUIGUIDs je prázdný, a potom příkaz povolen, dokud doplněk načten a může reagovat na QueryStatus.

Tohoto doplňku můžete obdržet oznámení vyvolání až IDTCommandTarget rozhraní. Můžete přidat pomocí tlačítka OnConnection metodu IDTExtensibility2 rozhraní.

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Odkaz

Commands2 Rozhraní

EnvDTE80 – obor názvů

Sdílet prostřednictvím