Propriedade MenuGroup.HasDropDown

Artigo
08/01/2011

Obtém ou define um valor indicando se itens de menu no Items coleção são adicionados a um submenu.

Namespace: Microsoft.Windows.Design.Interaction
Assembly: Microsoft.Windows.Design.Interaction (em Microsoft.Windows.Design.Interaction.dll)

Sintaxe

'Declaração
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)

Valor de propriedade

Tipo: System.Boolean
true Se os itens de menu da coleção de itens serão adicionados a um submenu; falseSe os itens na coleção serão adicionados diretamente ao menu atual, processado com um separador em cada extremidade.

Comentários

Se HasDropDown é igual a true, os itens de menu da coleção de itens são adicionados a um submenu. Um item de menu tem o DisplayName propriedade definida como o MenuGroup é adicionado ao menu atual e o menu itens são adicionados ao submenu. Se HasDropDown é igual a false, os itens de menu na coleção são adicionados diretamente ao menu atual, processado com um separador em ambas as extremidades. Por exemplo, considere um grupo de menu chamado Layout, com itens de menu Alinhar à esquerda e Alinhar à direita. Se HasDropDown é igual a true, um Layout será de menu adicionado ao menu atual com itens de submenu Alinhar à esquerda e Alinhar à direita. Se HasDropDown é igual a false, Alinhar à esquerda e Alinhar à direita será adicionado ao menu atual com um separador antes de Alinhar à esquerda e um separador depois Alinhar à direita.

Exemplos

O exemplo de código a seguir mostra como configurar dois MenuAction os itens e atribuí-los para um MenuGroup. O HasDropDown for definida como true para habilitar o comportamento do submenu. For more information, see Passo a passo: Criando um provedor de menu.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.