Version

Configuring Color Items (xamRadialMenu)

Topic Overview

Purpose

This topic explains the xamRadialMenu ™ color 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.

This topic explains the xamRadialMenu’s button items.

In this topic

This topic contains the following sections:

Color Items Configuration Summary

Color items configuration summary chart

The xamRadialMenu supports color items which allow the user to observe and set color values. Further details are available after the table.

Color items Description Represented by type
  • Displays a header text

  • Displays an icon

  • Displays the associated color

  • Displays the associated color in both the item area and outer ring

Color Item

Overview

Represented by the RadialMenuColorItem class, the xamRadialMenu’s color item extends from the RadialMenuItem class. In addition to the header text and icon provided by the button items, the color item has an associated color rectangle.

The following screenshot shows a rectangle associated with the color green:

xamRadialMenu 07.png

Property settings

The following table maps main configuration to the property settings that manage it.

In order to: Use this property/event: And:

Set/obtain item’s associated color value

Sets or reads its value

Get notified when the associated color value changes

Attaches event handler to it

Color Well

Overview

The xamRadialMenu’s color well is represented by the RadialMenuColorWell class and displays the associated color in both the item area and the outer ring. When the user navigates to the Sub-Items of a color well, the parent color well and its siblings are displayed between the center button and the items area.

Note
Note

Clicking on a color well updates the direct parent color well or color item setting such that their Color property is set to the color of the color well that was clicked.

The following screenshot shows color wells with Sub-Items rendered in different colors:

xamRadialMenu 08.png
  1. Color wells in different colors (on the current level)

  2. Arrows indicating that there are sub-items, below these color wells

The following screenshot shows navigating to the Sub-Items of the parent green color well. The parent green color well and its siblings are shown between the center button and the items area:

xamRadialMenu 09.png
  1. Color wells on the current level

  2. Parent color wells

Property settings

The following table maps main configurations to the property settings that manage it.

In order to: Use this property/event: And:

Set/obtain item’s associated color value

Sets or reads its value

Get notified when the associated color value changes

Attaches event handler to it

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 list items.