MenuGroup.HasDropDown 속성

아티클
08/10/2011

Items 컬렉션의 메뉴 항목이 하위 메뉴에 추가되는지 여부를 나타내는 값을 가져오거나 설정합니다.

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

구문

‘선언
Public Property HasDropDown As Boolean
    Get
    Set

public bool HasDropDown { get; set; }

public:
property bool HasDropDown {
    bool get ();
    void set (bool value);
}

member HasDropDown : bool with get, set

function get HasDropDown () : boolean
function set HasDropDown (value : boolean)

속성 값

형식: System.Boolean
항목 컬렉션의 메뉴 항목이 하위 메뉴에 추가되면 true이고, 컬렉션의 항목이 현재 메뉴에 직접 추가되어 양쪽 끝에 구분 기호와 함께 렌더링되면 false입니다.

설명

HasDropDown이 true이면 항목 컬렉션의 메뉴 항목이 하위 메뉴에 추가됩니다. DisplayName 속성이 MenuGroup으로 설정된 메뉴 항목은 현재 메뉴에 추가되고 해당 메뉴 항목이 하위 메뉴에 추가됩니다. HasDropDown이 false이면 컬렉션의 메뉴 항목이 현재 메뉴에 직접 추가되고 양쪽 끝에 구분 기호와 함께 렌더링됩니다. 예를 들어 레이아웃이라는 메뉴 그룹이 있고 메뉴 항목이 왼쪽 맞춤과 오른쪽 맞춤이라고 가정해 봅니다. HasDropDown이 true이면 현재 메뉴에 레이아웃 메뉴가 추가되고 왼쪽 맞춤 및 오른쪽 맞춤이 하위 메뉴 항목으로 추가됩니다. HasDropDown이 false이면 왼쪽 맞춤 및 오른쪽 맞춤이 현재 메뉴에 추가되고 왼쪽 맞춤 앞과 오른쪽 맞춤 뒤에 구분 기호가 표시됩니다.

예제

다음 코드 예제에서는 두 MenuAction 항목을 설정하고 MenuGroup에 할당하는 방법을 보여 줍니다. HasDropDown 속성을 true로 설정하여 플라이아웃 동작을 사용합니다. 자세한 내용은 연습: 메뉴 공급자 만들기을 참조하십시오.

' 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

// 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);
}