다음을 통해 공유

Commands.AddCommandBar 메서드

  • 아티클

저장되어 다음에 환경을 시작하면 사용할 수 있는 명령 모음을 만듭니다.

네임스페이스:  EnvDTE
어셈블리:  EnvDTE(EnvDTE.dll)

구문

‘선언
Function AddCommandBar ( _
    Name As String, _
    Type As vsCommandBarType, _
    CommandBarParent As Object, _
    Position As Integer _
) As Object

Object AddCommandBar(
    string Name,
    vsCommandBarType Type,
    Object CommandBarParent,
    int Position
)

Object^ AddCommandBar(
    [InAttribute] String^ Name, 
    [InAttribute] vsCommandBarType Type, 
    [InAttribute] Object^ CommandBarParent, 
    [InAttribute] int Position
)

abstract AddCommandBar : 
        Name:string * 
        Type:vsCommandBarType * 
        CommandBarParent:Object * 
        Position:int -> Object 

function AddCommandBar(
    Name : String, 
    Type : vsCommandBarType, 
    CommandBarParent : Object, 
    Position : int
) : Object

매개 변수

  • Name
    형식: System.String
    필수적 요소로서,새 명령 모음의 이름입니다.
  • Position
    형식: System.Int32
    선택적 요소로서,명령 모음에서 새 명령 모음을 배치할 인덱스 위치로 1부터 시작합니다.

반환 값

형식: System.Object
CommandBar 개체입니다.

설명

CommandBar 개체는 Microsoft Office 개체 모델의 멤버입니다.

이 메서드를 사용하여 추가되는 명령 모음은 영구 명령 모음입니다. 이 명령 모음은 추가 기능이 로드되는지 여부에 따라 IDE의 모든 세션에서 사용할 수 있습니다. 영구 명령 모음을 원하는 경우에만 이 메서드를 사용하여 명령 모음을 추가해야 합니다. 추가 기능을 처음 로드할 때 이 메서드를 한 번만 호출해야 합니다. 추가 기능을 실제로 로드하는 경우에만 나타나는 임시 명령 모음을 사용하려는 경우 추가 기능을 로드할 때 DTE.CommandBars.Add 메서드를 사용한 다음 추가 기능을 언로드할 때 DTE.CommandBars.Remove 메서드를 호출해야 합니다.

추가 기능이 로드되어 있지 않은 경우에도 영구 명령 모음이 나타나므로 추가 기능을 제거할 때 명령 모음이 제거되는지 확인해야 합니다. 따라서 MSI를 사용하여 추가 기능을 설치 및 제거하고 사용자 지정 작업을 제거 프로그램에 추가해야 합니다.

영구 및 임시 명령 모음 추가와 제거에 대한 자세한 내용은 HOWTO: Adding buttons, commandbars and toolbars to Visual Studio .NET from an add-in 및 HOWTO: Removing commands and UI elements during Visual Studio .NET add-in uninstallation을 참조하십시오.

예제

' Macro code.
Imports Microsoft.VisualStudio.CommandBars
Sub AddCommandBarExample()
   ' Before running, you must add a reference to the Office 
   ' typelib to gain access to the CommandBar object. Also, for this 
   ' example to work correctly, there should be an add-in available 
   ' in the Visual Studio environment.
   Dim cmds As Commands
   Dim cmdobj As Command
   Dim customin, customout As Object
   Dim cmdbarobj As CommandBar
   Dim colAddins As AddIns

   ' Set references.
   colAddins = DTE.AddIns()
   cmds = DTE.Commands
   cmdobj = cmds.Item("File.NewFile")

   ' Create a toolbar and add the File.NewFile command to it.
   cmdbarobj = cmds.AddCommandBar("Mycmdbar", _
   vsCommandBarType.vsCommandBarTypeToolbar)
   MsgBox("Commandbar name: " & cmdbarobj.Name)
   cmdobj = cmds.AddNamedCommand(colAddins.Item(1), "mycommand", _
   "mycommand", "tooltip for mycommand", True)
End Sub

.NET Framework 보안

  • 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

Commands 인터페이스

EnvDTE 네임스페이스