MenuAction 클래스

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

상속 계층 구조

System.Object
  Microsoft.Windows.Design.Interaction.MenuBase
    Microsoft.Windows.Design.Interaction.MenuAction

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

구문

‘선언
Public Class MenuAction _
    Inherits MenuBase

public class MenuAction : MenuBase

public ref class MenuAction : public MenuBase

type MenuAction =  
    class
        inherit MenuBase
    end

public class MenuAction extends MenuBase

MenuAction 형식에서는 다음과 같은 멤버를 노출합니다.

생성자

	이름	설명
	MenuAction	MenuAction 클래스의 새 인스턴스를 초기화합니다.

위쪽

속성

	이름	설명
	Checkable	메뉴 항목에 확인란을 표시하는 UI(사용자 인터페이스)가 필요한지 여부를 나타내는 값을 가져오거나 설정합니다.
	Checked	메뉴 항목이 선택되어 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
	Command	메뉴 작업을 나타내는 명령을 가져옵니다.
	Context	현재 편집 컨텍스트를 가져옵니다. (MenuBase에서 상속됨)
	DisplayName	메뉴 항목에 대해 표시할 지역화된 텍스트를 가져오거나 설정합니다. (MenuBase에서 상속됨)
	Enabled	사용자가 메뉴 작업 항목을 사용할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
	ImageUri	MenuAction 에 연결된 이미지에 대한 경로를 가져오거나 설정합니다.
	Name	메뉴 항목의 고유 식별자를 가져오거나 설정합니다. (MenuBase에서 상속됨)
	Visible	항목이 메뉴에 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.

위쪽

메서드

	이름	설명
	Equals	지정한 Object가 현재 Object와 같은지 여부를 확인합니다. (Object에서 상속됨)
	Finalize	가비지 수집에서 회수하기 전에 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
	GetHashCode	특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
	GetType	현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
	MemberwiseClone	현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
	OnPropertyChanged	PropertyChanged 이벤트를 발생시킵니다. (MenuBase에서 상속됨)
	ToString	현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)

위쪽

이벤트

	이름	설명
	Execute	메뉴 항목이 실행될 때 발생합니다.
	PropertyChanged	속성이 변경되면 발생합니다. (MenuBase에서 상속됨)

위쪽

설명

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

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

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

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

예제

다음 코드 예제에서는 디자인 타임에 컨트롤의 Background 속성을 설정하는 두 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);
}

스레드로부터의 안전성

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

참고 항목

참조

Microsoft.Windows.Design.Interaction 네임스페이스

PrimarySelectionContextMenuProvider

MenuGroup

기타 리소스

연습: 메뉴 공급자 만들기