도구 모음에 메뉴 컨트롤러 추가

아티클
12/15/2023

이 연습은 도구 창에 도구 모음 추가 연습을 기반으로 하며 도구 창 도구 모음에 메뉴 컨트롤러를 추가하는 방법을 보여 줍니다. 여기에 표시된 단계는 도구 모음 추가 연습에서 만든 도구 모음에도 적용할 수 있습니다.

메뉴 컨트롤러는 분할 컨트롤입니다. 메뉴 컨트롤러의 왼쪽에는 마지막으로 사용한 명령이 표시되며 이를 클릭하여 실행할 수 있습니다. 메뉴 컨트롤러의 오른쪽은 클릭할 때 추가 명령 목록을 여는 화살표입니다. 목록에서 명령을 클릭하면 명령이 실행되고 메뉴 컨트롤러의 왼쪽에 있는 명령을 대체합니다. 이 방식으로 메뉴 컨트롤러는 항상 목록에서 마지막으로 사용한 명령을 표시하는 명령 단추처럼 작동합니다.

메뉴 컨트롤러는 메뉴에 표시할 수 있지만 도구 모음에서 가장 자주 사용됩니다.

도구 창에 도구 모음 추가에 설명된 절차에 따라 도구 모음이 있는 도구 창을 만듭니다.

TWTestCommandPackage.vsct에서 Symbols 섹션으로 이동합니다. guidTWTestCommandPackageCmdSet이라는 GuidSymbol 요소에서 메뉴 컨트롤러, 메뉴 컨트롤러 그룹 및 세 개의 메뉴 항목을 선언합니다.

<IDSymbol name="TestMenuController" value="0x1300" /><IDSymbol name="TestMenuControllerGroup" value="0x1060" /><IDSymbol name="cmdidMCItem1" value="0x0130" /><IDSymbol name="cmdidMCItem2" value="0x0131" /><IDSymbol name="cmdidMCItem3" value="0x0132" />

Menus 섹션의 마지막 메뉴 항목 뒤에 메뉴 컨트롤러를 메뉴로 정의합니다.

<Menu guid="guidTWTestCommandPackageCmdSet" id="TestMenuController" priority="0x0100" type="MenuController">
    <Parent guid="guidTWTestCommandPackageCmdSet" id="TWToolbarGroup" />
    <CommandFlag>IconAndText</CommandFlag>
    <CommandFlag>TextChanges</CommandFlag>
    <CommandFlag>TextIsAnchorCommand</CommandFlag>
    <Strings>
        <ButtonText>Test Menu Controller</ButtonText>
        <CommandName>Test Menu Controller</CommandName>
    </Strings>
</Menu>

메뉴 컨트롤러가 마지막으로 선택한 명령을 반영할 수 있도록 하려면 TextChanges 및 TextIsAnchorCommand 플래그를 포함해야 합니다.

Groups 섹션의 마지막 그룹 항목 뒤에 메뉴 컨트롤러 그룹을 추가합니다.
```
<Group guid="guidTWTestCommandPackageCmdSet" id="TestMenuControllerGroup" priority="0x000">
    <Parent guid="guidTWTestCommandPackageCmdSet" id="TestMenuController" />
</Group>
```
메뉴 컨트롤러를 부모로 설정하면 이 그룹에 배치된 모든 명령이 메뉴 컨트롤러에 표시됩니다. priority 특성은 생략되며 메뉴 컨트롤러에서 유일한 그룹이므로 기본값 0으로 설정합니다.

Buttons 섹션에서 마지막 단추 항목 뒤에 각 메뉴 항목에 대한 Button 요소를 추가합니다.

<Button guid="guidTWTestCommandPackageCmdSet" id="cmdidMCItem1" priority="0x0000" type="Button">
    <Parent guid="guidTWTestCommandPackageCmdSet" id="TestMenuControllerGroup" />
    <Icon guid="guidImages" id="bmpPic1" />
    <CommandFlag>IconAndText</CommandFlag>
    <Strings>
        <ButtonText>MC Item 1</ButtonText>
        <CommandName>MC Item 1</CommandName>
    </Strings>
</Button>
<Button guid="guidTWTestCommandPackageCmdSet" id="cmdidMCItem2" priority="0x0100" type="Button">
    <Parent guid="guidTWTestCommandPackageCmdSet" id="TestMenuControllerGroup" />
    <Icon guid="guidImages" id="bmpPic2" />
    <CommandFlag>IconAndText</CommandFlag>
    <Strings>
        <ButtonText>MC Item 2</ButtonText>
        <CommandName>MC Item 2</CommandName>
    </Strings>
</Button>
<Button guid="guidTWTestCommandPackageCmdSet" id="cmdidMCItem3" priority="0x0200" type="Button">
    <Parent guid="guidTWTestCommandPackageCmdSet" id="TestMenuControllerGroup" />
    <Icon guid="guidImages" id="bmpPicSearch" />
    <CommandFlag>IconAndText</CommandFlag>
    <Strings>
        <ButtonText>MC Item 3</ButtonText>
        <CommandName>MC Item 3</CommandName>
    </Strings>
</Button>

이 시점에 메뉴 컨트롤러를 볼 수 있습니다. 프로젝트를 빌드하고 디버깅을 시작합니다. 실험적 인스턴스를 확인합니다.
1. 보기/기타 창 메뉴에서 Test ToolWindow를 엽니다.
2. 메뉴 컨트롤러가 도구 창의 도구 모음에 표시됩니다.
3. 메뉴 컨트롤러의 오른쪽에 있는 화살표를 클릭하여 세 가지 가능한 명령을 확인합니다.
  
  명령을 클릭하면 메뉴 컨트롤러의 제목이 변경되어 해당 명령이 표시됩니다. 다음 섹션에서는 이 명령을 활성화하는 코드를 추가합니다.

TWTestCommandPackageGuids.cs에서 기존 명령 ID 뒤에 세 개의 메뉴 항목에 대한 명령 ID를 추가합니다.

public const int cmdidMCItem1 = 0x130;
public const int cmdidMCItem2 = 0x131;
public const int cmdidMCItem3 = 0x132;

TWTestCommand.cs에서 TWTestCommand 클래스의 맨 위에 다음 코드를 추가합니다.
```
private int currentMCCommand; // The currently selected menu controller command
```

TWTestCommand 생성자에서 AddCommand 메서드에 대한 마지막 호출 뒤에 동일한 처리기를 통해 각 명령에 대한 이벤트를 라우팅하는 코드를 추가합니다.

for (int i = TWTestCommandPackageGuids.cmdidMCItem1; i <=
    TWTestCommandPackageGuids.cmdidMCItem3; i++)
{
    CommandID cmdID = new
    CommandID(new Guid(TWTestCommandPackageGuids.guidTWTestCommandPackageCmdSet), i);
    OleMenuCommand mc = new OleMenuCommand(new
      EventHandler(OnMCItemClicked), cmdID);
    mc.BeforeQueryStatus += new EventHandler(OnMCItemQueryStatus);
    commandService.AddCommand(mc);
    // The first item is, by default, checked. 
    if (TWTestCommandPackageGuids.cmdidMCItem1 == i)
    {
        mc.Checked = true;
        this.currentMCCommand = i;
    }
}

TWTestCommand 클래스에 이벤트 처리기를 추가하여 선택한 명령을 선택된 것으로 표시합니다.

private void OnMCItemQueryStatus(object sender, EventArgs e)
{
    OleMenuCommand mc = sender as OleMenuCommand;
    if (null != mc)
    {
        mc.Checked = (mc.CommandID.ID == this.currentMCCommand);
    }
}

사용자가 메뉴 컨트롤러에서 명령을 선택할 때 MessageBox를 표시하는 이벤트 처리기를 추가합니다.

private void OnMCItemClicked(object sender, EventArgs e)
{
    OleMenuCommand mc = sender as OleMenuCommand;
    if (null != mc)
    {
        string selection;
        switch (mc.CommandID.ID)
        {
            case c.cmdidMCItem1:
                selection = "Menu controller Item 1";
                break;

            case TWTestCommandPackageGuids.cmdidMCItem2:
                selection = "Menu controller Item 2";
                break;

            case TWTestCommandPackageGuids.cmdidMCItem3:
                selection = "Menu controller Item 3";
                break;

            default:
                selection = "Unknown command";
                break;
        }
        this.currentMCCommand = mc.CommandID.ID;

        IVsUIShell uiShell =
          (IVsUIShell) ServiceProvider.GetService(typeof(SVsUIShell));
        Guid clsid = Guid.Empty;
        int result;
        uiShell.ShowMessageBox(
                0,
                ref clsid,
                "Test Tool Window Toolbar Package",
                string.Format(CultureInfo.CurrentCulture,
                             "You selected {0}", selection),
                string.Empty,
                0,
                OLEMSGBUTTON.OLEMSGBUTTON_OK,
                OLEMSGDEFBUTTON.OLEMSGDEFBUTTON_FIRST,
                OLEMSGICON.OLEMSGICON_INFO,
                0,
                out result);
    }
}

프로젝트를 빌드하고 디버깅을 시작합니다. 실험적 인스턴스를 확인합니다.
보기/기타 창 메뉴에서 Test ToolWindow를 엽니다.

메뉴 컨트롤러는 도구 창의 도구 모음에 표시되고 MC Item 1을 표시합니다.
화살표 왼쪽에서 메뉴 컨트롤러 단추를 클릭합니다.

세 개의 항목이 표시되며, 그 중 첫 번째 항목이 선택되고 아이콘 주위에 강조 표시 상자가 있습니다. MC Item 3을 클릭합니다.

You selected Menu controller Item 3이라는 메시지가 있는 대화 상자가 표시됩니다. 메시지는 메뉴 컨트롤러 단추의 텍스트에 해당합니다. 이제 메뉴 컨트롤러 단추에는 MC Item 3이 표시됩니다.

다음을 통해 공유

메뉴 컨트롤러 만들기

메뉴 컨트롤러 명령 구현

메뉴 컨트롤러 테스트

추가 리소스

다음을 통해 공유

메뉴 컨트롤러 만들기

메뉴 컨트롤러 명령 구현

메뉴 컨트롤러 테스트

관련 콘텐츠

추가 리소스