MenuAction 클래스

아티클
08/22/2008

업데이트: 2007년 11월

디자이너에서 수행할 작업을 나타내는 상황에 맞는 메뉴 항목입니다.

네임스페이스: Microsoft.Windows.Design.Interaction
어셈블리: Microsoft.Windows.Design.Extensibility(Microsoft.Windows.Design.Extensibility.dll)

구문

Public Class MenuAction _
    Inherits MenuBase

Dim instance As MenuAction

public class MenuAction : MenuBase

public ref class MenuAction : public MenuBase

public class MenuAction extends MenuBase

설명

MenuAction 클래스를 사용하여 WPF Designer의 상황에 맞는 메뉴 항목을 정의합니다.

상황에 맞는 메뉴 항목을 표시하려면 ContextMenuProvider 클래스에서 상속하고 MenuAction 항목 및 관련 MenuGroup을 만듭니다. 이러한 메뉴 개체는 일반적으로 기본 선택 내용에 대한 상황에 맞는 메뉴를 표시하는 PrimarySelectionContextMenuProvider에서 파생된 클래스의 생성자에서 만들어집니다.

Execute 이벤트 처리기에서 MenuAction의 논리를 구현합니다.

MenuAction 클래스는 WPF 명령 시스템과 호환됩니다. Command 속성을 사용하면 사용자 인터페이스를 사용하는 대신 프로그래밍 방식으로 MenuAction을 호출할 수 있습니다.

예제

다음 코드 예제에서는 디자인 타임에 컨트롤의 Background 속성을 설정하는 두 MenuAction 항목을 설정하는 방법을 보여 줍니다. 자세한 내용은 연습: MenuAction 만들기를 참조하십시오.

Private setBackgroundToBlueMenuAction As MenuAction
Private clearBackgroundMenuAction As MenuAction


...


' The provider's constructor sets up the MenuAction objects 
' and the the MenuGroup which holds them.
Public Sub New()

    ' Set up the MenuAction which sets the control's 
    ' background to Blue.
    setBackgroundToBlueMenuAction = New MenuAction("Blue")
    setBackgroundToBlueMenuAction.Checkable = True
    AddHandler setBackgroundToBlueMenuAction.Execute, AddressOf SetBackgroundToBlue_Execute

    ' Set up the MenuAction which sets the control's 
    ' background to its default value.
    clearBackgroundMenuAction = New MenuAction("Cleared")
    clearBackgroundMenuAction.Checkable = True
    AddHandler clearBackgroundMenuAction.Execute, AddressOf ClearBackground_Execute

    ' Set up the MenuGroup which holds the MenuAction items.
    Dim backgroundFlyoutGroup As New MenuGroup("SetBackgroundsGroup", "Set Background")

    ' If HasDropDown is false, the group appears inline, 
    ' instead of as a flyout. Set to true.
    backgroundFlyoutGroup.HasDropDown = True
    backgroundFlyoutGroup.Items.Add(setBackgroundToBlueMenuAction)
    backgroundFlyoutGroup.Items.Add(clearBackgroundMenuAction)
    Me.Items.Add(backgroundFlyoutGroup)

    ' The UpdateItemStatus event is raised immediately before 
    ' this provider shows its tabs, which provides the opportunity 
    ' to set states.
    AddHandler UpdateItemStatus, AddressOf CustomContextMenuProvider_UpdateItemStatus

End Sub

private MenuAction setBackgroundToBlueMenuAction;
private MenuAction clearBackgroundMenuAction;


...


// The provider's constructor sets up the MenuAction objects 
// and the the MenuGroup which holds them.
public CustomContextMenuProvider()
{   
    // Set up the MenuAction which sets the control's 
    // background to Blue.
    setBackgroundToBlueMenuAction = new MenuAction("Blue");
    setBackgroundToBlueMenuAction.Checkable = true;
    setBackgroundToBlueMenuAction.Execute += 
        new EventHandler<MenuActionEventArgs>(SetBackgroundToBlue_Execute);

    // Set up the MenuAction which sets the control's 
    // background to its default value.
    clearBackgroundMenuAction = new MenuAction("Cleared");
    clearBackgroundMenuAction.Checkable = true;
    clearBackgroundMenuAction.Execute += 
        new EventHandler<MenuActionEventArgs>(ClearBackground_Execute);

    // Set up the MenuGroup which holds the MenuAction items.
    MenuGroup backgroundFlyoutGroup = 
        new MenuGroup("SetBackgroundsGroup", "Set Background");

    // If HasDropDown is false, the group appears inline, 
    // instead of as a flyout. Set to true.
    backgroundFlyoutGroup.HasDropDown = true;
    backgroundFlyoutGroup.Items.Add(setBackgroundToBlueMenuAction);
    backgroundFlyoutGroup.Items.Add(clearBackgroundMenuAction);
    this.Items.Add(backgroundFlyoutGroup);

    // The UpdateItemStatus event is raised immediately before 
    // this provider shows its tabs, which provides the opportunity 
    // to set states.
    UpdateItemStatus += 
        new EventHandler<MenuActionEventArgs>(
            CustomContextMenuProvider_UpdateItemStatus);
}