Commands2.AddNamedCommand2 메서드

  • 아티클

환경에 저장되어 다음에 환경을 시작하면 사용할 수 있는 명명된 명령을 만듭니다. 이 명령은 환경을 시작할 때 추가 기능을 로드하지 않아도 사용할 수 있습니다.

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

구문

‘선언
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

매개 변수

  • AddInInstance
    형식: AddIn

    필수 요소. AddIn 에 새 명령을 추가 합니다.

  • Name
    형식: String

    필수 요소. 새 명령의 약식 이름입니다. AddNamedCommand2는 이 이름 앞에 **Addins.Progid.**를 추가하여 고유한 이름을 만듭니다.

  • ButtonText
    형식: String

    필수 요소. 이 명령에 대 한 UI에 표시할 이름입니다.

  • Tooltip
    형식: String

    필수 요소. 새 명령에 연결된 컨트롤 위에 마우스 포인터를 두는 경우 표시되는 텍스트입니다.

  • MSOButton
    형식: Boolean

    필수 요소. false여야 합니다.

  • Bitmap
    형식: Object

    선택적 요소. 단추에 표시되는 비트맵의 ID입니다.

    Bitmap은 다음 중 하나일 수 있습니다.

    - Bitmap

    - Icon

    - IPicture

    - 추가 기능에서 제공하는 16x16 비트맵 리소스의 ID(아이콘 리소스가 아님)입니다. Visual Studio 추가 기능 위성 DLL에서에서 첫 번째 찾습니다. 해당 위치에서 리소스를 찾지 못하면 추가 기능 DLL이 검색됩니다.

  • ContextUIGUIDs
    형식: array<Object[]%

    선택적 요소. 있는 환경 컨텍스트 (디버그 모드, 디자인 모드 및 등) 표시 명령을 결정 하는 Guid입니다.

  • vsCommandStatusValue
    형식: Int32

    선택적 요소. 보이지 않거나 사용할 수 없는 명령 비활성화 상태 인지 여부를 확인 제공 하는 ContextUIGUIDs 매개 변수 및 없음 현재 활성화 되어 있습니다. 자세한 내용은 vsCommandDisabledFlags를 참조하십시오.

반환 값

형식: Command
작성하여 이름을 지정한 명령입니다.

설명

추가 기능으로 QueryStatus 메서드에 응답하여 나중에 ButtonText 이름을 변경할 수 있습니다. 텍스트가 #으로 시작한다면 나머지 문자열은 추가 기능의 등록된 위성 DLL 리소스 ID를 나타내는 정수입니다.

두 가지 기본 명령 상태: 기본 및 기본 가시성 상태를 사용 합니다. 이러한 기본 상태는 중요 한 명령 처리기를 찾을 수 없는 경우 (구성 요소가 로드 되지 않습니다 또는 구현 하지 않습니다 때문에 IDTCommandTarget). 구현 하는 구성 요소에 로드 되는 경우 IDTCommandTarget, 기본 값을 적용 하지 않습니다.

기본 상태는 사용 하는 두 가지 재미 있는 경우에는

  1. UI 컨텍스트 Guid를 통해 제공 하는 ContextUIGUIDs 매개 변수입니다. 이 경우 표시 하 여 제공된 된 컨텍스트 guid가 전적으로 결정 됩니다. 표시 되는 명령 컨텍스트를 활성 상태 이면 그렇지 않으면 숨겨집니다. 완전히 활성된 상태가 기본값이 결정 됩니다. 기본적으로 Visual Studio 기본 상태에서 사용할 수 없습니다 vsCommandDisabledFlagsGrey 전달 명령은 항상 사용 됩니다. VsCommandDisabledFlagsEnabled를 전달 하면, 간단 하 게 입력 하지 않으면이 매개 변수를 기본 상태로 활성화 됩니다.

  2. 통해 UI 컨텍스트 Guid를 제공 하지 않으면 해당 ContextUIGUIDs 매개 변수. 가시성에 전달할 플래그에 따라이 경우 vsCommandStatusValue 또는 기본 상태입니다. VS의 기본 명령을 표시 표시 될 것입니다. 여기 vsCommandDisabledFlagsHidden를 전달 하면 기본 표시 되지 않습니다. 사용 가능 상태가 경우 1 위 (VS 기본 동작 및/또는 플래그에 의해 결정 됨)은 동일 합니다.

추가 기능은 IDTCommandTarget 인터페이스를 통해 호출 알림을 수신할 수 있습니다. IDTExtensibility2 인터페이스의 OnConnection 메서드를 사용하여 단추를 추가할 수 있습니다.

.NET Framework 보안

참고 항목

참조

Commands2 인터페이스

EnvDTE80 네임스페이스