Share via


Choice Class

Defines a list of exclusive options that the application can work with. The application can use an index or access options by advancing through them in either direction.

  public class Choice : ModelItem, IValueRange, IModelItem, IPropertyObject, IModelItemOwner

Public Instance Constructors

Constructor Description
Choice()

Choice(IModelItemOwner)

Initializes a new instance of the Choice class.
Choice(IModelItemOwner, string) Initializes a new instance of the Choice class.
Choice(IModelItemOwner, string, IList) Initializes a new instance of the Choice class.

Public Instance Methods

Method Description
DefaultValue Changes the selected option to the default item.
NextValue Changes the selected option to the next one in the Options list.
PreviousValue Changes the selected option to the previous one in the Options list.

Protected Instance Methods

Method Description
GetIndexOfOption Gets the index of the selected option in the Options array.
OnChosenChanged Notifies derived classes when the selected option has changed.
ValidateOptionList Verifies that the given Options list is acceptable for this Choice object.

Public Instance Properties

Property Description
Chosen Gets or sets the object that is selected from the Options list.
ChosenIndex Gets or sets the index of the object that is selected from the Options list.
Default Gets or sets the default object within the Options list.
DefaultIndex Gets or sets the index of the default object within the Options list.
HasNextValue Determines whether a call to the NextValue method will succeed.
HasPreviousValue Determines whether a call to the PreviousValue method will succeed.
Options Gets or sets the list of Options.
Wrap Gets or sets a value that indicates whether the list should wrap when the PreviousValue or NextValue methods are called at the beginning or end of the list.

Public Instance Events

Event Description
ChosenChanged Raised when the chosen item has changed.

Remarks

Only one item can be chosen at a time. A typical user interface element for this object is a radio group or a spinner control.

Requirements

Reference: Microsoft.MediaCenter.UI

Namespace: Microsoft.MediaCenter.UI

Assembly: Microsoft.MediaCenter.UI.dll

Platform: Windows Vista Ultimate, Windows Vista Home Premium, and later

See Also