Version

Configuring Button Items (xamRadialMenu)

Topic Overview

Purpose

This topic explains the xamRadialMenu ™ button items.

Required background

The following topics are prerequisites to understanding this topic:

Topic Purpose

This topic explains the features supported by the control from developer perspective.

This topic provides an overview of the visual elements of the control.

This topic explains in general the menu items and their common configuration properties.

In this topic

This topic contains the following sections:

Introduction

Button items summary

The xamRadialMenu’s button items are ordinary items, represented by the RadialMenuItem class which may be clicked to perform an action. The button items can include text and/or icons. Additionally, button items can have Sub-Items, and in this case the parent item will have an arrow button on the outer ring allowing the user to navigate the Sub-Items group.

You may configure button items as checkbox items, in which case an arc indicates their checked state is within the items area just inside the outer ring.

Button items can be configured as radio button items and there are two modes in which they can operate:

  • Radio button group with at least one checked item

  • Radio button group with no checked items

The following screenshot shows different button item types:

xamRadialMenu 04.png
  1. Plain button items

  2. Checkbox button item in checked state

  3. Arrows showing that these color items have Sub-Items

  4. Radio buttons group with the second choice checked

Button Items Configuration Summary

Button items configuration summary chart

The following table briefly explains the main configurable aspects of the button items control and maps them to properties that configure them.

Configurable aspect Details Properties

Header

Add, edit or delete text in the item

Icon

Add, edit or delete an icon in the item

Adding unbound sub-items

Add, edit or delete unbound sub-items

Binding sub-items

Bind a collection of Sub-Items

Check Box

Configure the button item as a checkbox by setting the CheckBehavior property to CheckBox and using the IsChecked property to set or obtain its state

Radio Button

Configure the button item as a radio button by setting the CheckBehavior property to RadioButton (for a group with one checked item) or RadioButtonAllowAllUp (for a group which allows no checked items) and set a group name using the GroupName property to an equal value for all group members

Events

You may configure the Click event to attach event handlers and perform actions when the user clicks on a particular button item

There are also events notifying you when a button has been checked or unchecked.

Related Topics

The following topics provide additional information related to this topic.

Topic Purpose

This topic explains the xamRadialMenu’s numeric items.

This topic explains the xamRadialMenu’s color items.

This topic explains the xamRadialMenu’s list items.