Menu-item

Het MenuItem controle-element vertegenwoordigt afzonderlijke selecteerbare items binnen een Menu of ContextMenu. MenuItem is de fundamentele bouwsteen van menusystemen in WPF-toepassingen, die de interactieve elementen bieden waarop gebruikers klikken of selecteren om acties uit te voeren.

Schermopname van een menubesturingselement met meerdere MenuItem-besturingselementen.

Zie Menu: Exmaples voor voorbeelden van het gebruik van menu's.

Een Menu fungeert als een container voor MenuItem objecten, waarbij een ouder-kindrelatie wordt tot stand gebracht, zoals:

  • Het menubesturingselement biedt de algehele structuur en indeling voor het ordenen van menu-items.
  • Elke MenuItem vertegenwoordigt een specifieke opdracht, optie of submenu binnen die structuur.
  • Menu-items kunnen andere menu-items als onderliggende items bevatten, waardoor ze hiërarchisch kunnen zijn en een onbeperkte diepte kunnen bereiken.
  • MenuItems nemen de stijl- en gedragseigenschappen over van hun bovenliggende menu, tenzij deze expliciet worden overschreven.

Met deze hiërarchische relatie kunt u complexe navigatiestructuren maken, van eenvoudige platte menu's tot diep geneste submenusystemen.

MenuItems ondersteunen verschillende soorten gedrag:

Opdrachtitems: MenuItems die specifieke opdrachten uitvoeren wanneer erop wordt geklikt. Deze worden meestal gebruikt voor acties zoals Bestand > openen of Kopiëren bewerken>.

Controleerbare items: MenuItems die kunnen worden in- en uitgeschakeld, vergelijkbaar met selectievakjes. Stel de IsCheckable eigenschap in op true om dit gedrag in te schakelen.

Scheidingstekens: Gebruik Separator-besturingselementen binnen een menu om gerelateerde MenuItems visueel te groeperen.

Submenu-items: Menu-items die andere menu-items als subitems bevatten. Wanneer erop wordt geklikt of erover wordt gehoverd, geven ze een submenu weer met extra opties.

Belangrijke eigenschappen van MenuItem zijn onder andere:

  • Header: De inhoud die wordt weergegeven in het menu-item.
  • Command: de opdracht die moet worden uitgevoerd wanneer het item is geselecteerd.
  • IsCheckable: Of het item kan worden aangevinkt of uitgevinkt.
  • IsChecked: De huidige status van een controleerbaar item.
  • InputGestureText: Tekst die de sneltoets voor het item vertegenwoordigt.
  • Icon: Een pictogram dat naast de tekst van het menu-item moet worden weergegeven.

Belangrijke gebeurtenissen zijn onder andere Click, Checkeden Unchecked.

Stijlen en sjablonen

U kunt de standaardinstelling ControlTemplate wijzigen om het MenuItem besturingselement een uniek uiterlijk te geven. Zie Wat zijn stijlen en sjablonen voor meer informatie en hoe u een sjabloon voor een besturingselement maakt.

Inhoudseigenschap

Met dit besturingselement wordt geen inhoudseigenschap gedefinieerd.

Onderdelen

De volgende tabel bevat de benoemde onderdelen voor het MenuItem besturingselement.

Onderdeel Typologie Description
PART_Popup Popup Het pop-upvenster met de submenu-items.

Wanneer u een ControlTemplate voor een MenuItem maakt, bevat uw sjabloon mogelijk een ItemsPresenter in een ScrollViewer. Het ItemsPresenter toont elk item in de MenuItem; de ScrollViewer maakt scrollen binnen het besturingselement mogelijk. Als het ItemsPresenter niet het directe kind van de ScrollVieweris, moet u de ItemsPresenter naam opgeven. ItemsPresenter

Visuele statussen

De volgende tabel bevat de visuele statussen voor het MenuItem besturingselement.

VisualState-naam VisualStateGroup-naam Description
Geldig Validatiestatussen Het besturingselement is geldig en heeft geen validatiefouten.
Ongeldige focus Validatiestatussen Het besturingselement heeft een validatiefout en heeft de focus op het toetsenbord.
Ongeldige ongeconcentreerdheid Validatiestatussen Het besturingselement heeft een validatiefout maar heeft geen toetsenbordfocus.

Zie ook

  • Last updated on