Udostępnij za pośrednictwem

Metoda Commands2.AddNamedCommand2 —

  • Artykuł

Tworzy nazwane polecenie, które jest zapisywane przez środowisko naturalne oraz dostępne przy następnym uruchomieniu środowiska, nawet jeśli dodatek nie jest ładowany podczas uruchamiania środowiska.

Przestrzeń nazw:  EnvDTE80
Zestaw:  EnvDTE80 (w EnvDTE80.dll)

Składnia

'Deklaracja
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
    Wymagane.AddIn Obiektu jest dodanie nowego polecenia.
  • Name
    Typ: System.String
    Wymagane.Krótka forma nazwy dla nowego polecenia. AddNamedCommand2 używa "Wstępu" Addins.Progid. do tworzenia unikatowych nazw.
  • ButtonText
    Typ: System.String
    Wymagane.Nazwa, aby użyć, jeżeli polecenie jest związany przycisk, który jest wyświetlany przez nazwę zamiast ikony.
  • Tooltip
    Typ: System.String
    Wymagane.Tekst wyświetlany, gdy użytkownik nakieruje wskaźnik myszy na każdy formant powiązany z nowego polecenia.
  • MSOButton
    Typ: System.Boolean
    Wymagane.Wskazuje, jaki parametr mapy bitowej jest interpretowany.
    Jeśli wartość jest true, Bitmap jest Identyfikatorem bitmapę pakietu Microsoft Office.
    Jeśli MSOButton jest false, następnie Bitmap może być jedną z następujących czynności:
    -ABitmap
    -Icon
    -IPicture
    -Identyfikator zasobu mapa bitowa 16 x 16 (ale nie zasób ikony) dostarczonego przez dodatek.Visual Studio będzie najpierw szukać w dodatku 's satelitarnej biblioteki DLL.Jeśli zasób nie zostaną znalezione, DLL dodatku będzie przeszukiwana.
  • Bitmap
    Typ: System.Object
    Opcjonalne.Identyfikator mapy bitowej do wyświetlenia na przycisku.See MSOButton.
  • ContextUIGUIDs
    Typ: array<System.Object[]%
    Opcjonalne.Element SafeArray z GUID, który określa, które kontekstów środowiska (to znaczy tryb debugowania, tryb projektowania i tak dalej) Pokaż polecenie.See vsCommandDisabledFlags.
  • vsCommandStatusValue
    Typ: System.Int32
    Opcjonalne.Określa, czy wyłączone Państwo polecenia jest niewidoczne lub szary, gdy można dostarczyć ContextUIGUIDs i none są aktualnie aktywne.
  • CommandStyleFlags
    Typ: System.Int32
    Opcjonalne.Określa stan polecenia, gdy można dostarczyć ContextUIGUIDs i żaden z określonych kontekstach są aktualnie aktywne.Ten parametr zawsze powinien zawierać vsCommandStatusSupported.Jeśli również obejmuje vsCommandStatusEnabled, polecenie będzie włączona.

Wartość zwracana

Typ: EnvDTE.Command
Nazwane polecenie, który został utworzony.

Uwagi

Aby uzyskać informacje dotyczące uzyskiwania mapy bitowej wartości Identyfikatora MSO przycisków, zobacz Aukcji napotyka przycisk paska poleceń dla pakietu Microsoft Office System.

Dodatki można później zmienić ButtonText nazwa odpowiadając na QueryStatus metody.Jeśli tekst rozpoczyna się znakiem #, reszta ciąg jest liczba całkowita, która reprezentuje identyfikator zasobu w dodatku 's satelitarnej zarejestrowanych biblioteki DLL.

ContextUIGUIDs Parametr i vsCommandStatusValue parametr są używane, gdy dodatek nie jest załadowany i dlatego nie może odpowiedzieć na QueryStatus metody.Jeśli ContextUIGUIDs jest pusta, a następnie polecenie jest włączone, dopóki nie jest ładowany i można odpowiedzieć na dodatek QueryStatus.

Dodatek można otrzymywać powiadomienia wywołania przez IDTCommandTarget interfejsu.Przycisk mogą być dodawane za pomocą OnConnection metoda IDTExtensibility2 interfejsu.

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

Commands2 Interfejs

Przestrzeń nazw EnvDTE80