MenuGroup.HasDropDown 속성

아티클
08/22/2008

업데이트: 2007년 11월

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

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

구문

Public Property HasDropDown As Boolean

Dim instance As MenuGroup
Dim value As Boolean

value = instance.HasDropDown

instance.HasDropDown = value

public bool HasDropDown { get; set; }

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

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

속성 값

형식: System.Boolean

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

설명

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

예제

다음 코드 예제에서는 두 MenuAction 항목을 설정하고 MenuGroup에 할당하는 방법을 보여 줍니다. HasDropDown 속성을 true로 설정하여 플라이아웃 동작을 사용합니다. 자세한 내용은 연습: 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

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