Commands2.AddNamedCommand2 – metoda

Článek
10/27/2012

Vytvoří pojmenované příkaz, který je uložen v prostředí a k dispozici při příštím spuštění prostředí, i když 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 pro nový příkaz. AddNamedCommand2 používá předmluvě Addins.Progid. vytvořit jedinečný název.

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

Tooltip
Typ: System.String
Povinné.Text zobrazený při nastavení ukazatele myši ukazatel všechny ovládací prvky vázané na nový příkaz.

MSOButton
Typ: System.Boolean
Povinné.Označuje, jak je interpretováno parametr bitmapy.
Pokud je hodnota true, Bitmap je ID bitmapy sady Microsoft Office.
Pokud MSOButton je false, pak Bitmap může být jeden z následujících:
-ABitmap
-KIcon
-IPicture
-ID zdroje rastrový obrázek 16 x 16 (ale není prostředek ikonu) uvedenou v doplňku.Visual Studio bude nejprve hledají v doplňku jeho satelitní knihovny DLL.Pokud prostředek nejsou nalezena, 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í, které kontexty prostředí (je režim ladění, režim návrhu a podobně) příkaz zobrazit.Viz téma vsCommandDisabledFlags.

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

CommandStyleFlags
Typ: System.Int32
Nepovinné.Určuje stav příkazu zadáte ContextUIGUIDs a žádný zadané kontexty jsou právě 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 rastr, Výpis čelí tlačítka na panelu příkazů pro systém Microsoft Office.

Doplňky můžete později změnit ButtonText podle reagovat na název QueryStatus metoda.Pokud text začíná #, zbytek řetězce je celé číslo, které představuje čí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 metoda.Pokud ContextUIGUIDs je prázdný, a potom příkaz povolen, dokud doplněk je načten a může reagovat na QueryStatus.

Tohoto doplňku můžete obdržet oznámení vyvolání až IDTCommandTarget rozhraní.Tlačítko můžete přidat pomocí 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é

Referenční dokumentace

Commands2 Rozhraní

EnvDTE80 – obor názvů

Sdílet prostřednictvím