RepositoryItemRadioGroup.Items Property

Gets the collection of items displayed by the current radio group editor.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v18.2.dll

Declaration

C#

[DXCategory("Data")]
public RadioGroupItemCollection Items { get; }

VB.NET

<DXCategory("Data")>
Public ReadOnly Property Items As RadioGroupItemCollection

Property Value

Type	Description
RadioGroupItemCollection	The RadioGroupItemCollection object representing the collection of items displayed by the editor.

Remarks

The Items property provides access to the collection of items displayed in a radio group. You can use the methods of the RadioGroupItemCollection class to add, remove and access individual items.

Elements in the collection can be of any type. To add an item to the collection, use the RadioGroupItemCollection.Add, RadioGroupItemCollection.AddRange and RadioGroupItemCollection.Insert methods.

Note: for the editor to function correctly, items in the collection must be unique objects.

The index of the item currently selected can be obtained or set via the RadioGroup.SelectedIndex property.

At design time, you can add items using the standard String Collection Editor which can be invoked in the Properties window.

Example

This example demonstrates how to programmatically create a radio group, add two items to the collection, initialize their properties and assign a handler to the RadioGroup.SelectedIndexChanged event. The created radio group will be used to control the visibility of a standard button control. This example assumes that a button has already been placed on the form.

The image below shows the example application.

C#

using DevExpress.Utils;
using DevExpress.XtraEditors;
using DevExpress.XtraEditors.Repository;
using DevExpress.XtraEditors.Controls;

private void CreateRadioEditors() {
    // creating and initializing the radio group items
    RadioGroupItem item1 = new RadioGroupItem();
    item1.Description = "Hide Button";
    RadioGroupItem item2 = new RadioGroupItem();
    item2.Description = "Show Button";
    // creating and initializing the radio group editor
    RadioGroup radioEdit1 = new RadioGroup();
    radioEdit1.Properties.Items.Add(item1);
    radioEdit1.Properties.Items.Add(item2);
    radioEdit1.Name = "radioEdit1";
    radioEdit1.Location = new System.Drawing.Point(30, 35);
    radioEdit1.Width = 100;
    radioEdit1.Height = 100;
    // setting the editor's selection depending upon the button's visibility
    if (button1.Visible) radioEdit1.SelectedIndex = 1;
    // assigning a handler for the SelectedIndexChanged event of the editor
    radioEdit1.SelectedIndexChanged += new EventHandler(SelectedIndexChanged);
    this.Controls.Add((Control)radioEdit1);
}

private void SelectedIndexChanged(object sender, System.EventArgs e) {
    RadioGroup edit = sender as RadioGroup;
    if (edit.SelectedIndex == 0) button1.Visible = false;
    else button1.Visible = true;
}

VB.NET

Imports DevExpress.XtraEditors.Repository
Imports DevExpress.XtraEditors.Controls
Imports DevExpress.XtraEditors
Imports DevExpress.Utils

Private Sub CreateRadioEditors()
   ' creating and initializing the radio group items
   Dim Item1 As New RadioGroupItem
   Item1.Description = "Hide Button"
   Dim item2 As New RadioGroupItem
   Item2.Description = "Show Button"
   ' creating and initializing the radio group editor
   Dim RadioEdit1 As New RadioGroup
   RadioEdit1.Properties.Items.Add(Item1)
   RadioEdit1.Properties.Items.Add(Item2)
   RadioEdit1.Name = "radioEdit1"
   RadioEdit1.Location = New System.Drawing.Point(30, 35)
   RadioEdit1.Width = 100
   RadioEdit1.Height = 100
   ' setting the editor's selection depending upon the button's visibility
   If Button1.Visible Then RadioEdit1.SelectedIndex = 1
   ' assigning a handler for the SelectedIndexChanged event of the editor
   AddHandler RadioEdit1.SelectedIndexChanged, AddressOf SelectedIndexChanged
   Me.Controls.Add(CType(RadioEdit1, Control))
End Sub

Private Sub SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs)
   Dim Edit As RadioGroup = CType(sender, RadioGroup)
   If (Edit.SelectedIndex = 0) Then
      Button1.Visible = False
   Else : Button1.Visible = True
   End If
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Items property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-create-a-custom-radiogroup-control-whose-items-show-a-tooltip-e3477/CS/TestMyRadioGroup/RepositoryItemMyRadioGroup.cs#L45

{
    get { return base.Items as MyRadioGroupItemCollection; }
}

XDL_how-to-delete-all-criteria-corresponding-to-a-particular-field-from-criteriaoperator-e3396/CS/WindowsApplication3/Main.cs#L30

    foreach (GridColumn col in gridView1.Columns)
        radioGroup1.Properties.Items.Add(new DevExpress.XtraEditors.Controls.RadioGroupItem(col.FieldName, col.GetCaption()));
}

VB.NET

how-to-create-a-custom-radiogroup-control-whose-items-show-a-tooltip-e3477/VB/TestMyRadioGroup/RepositoryItemMyRadioGroup.vb#L38

Get
    Return TryCast(MyBase.Items, MyRadioGroupItemCollection)
End Get

XDL_how-to-delete-all-criteria-corresponding-to-a-particular-field-from-criteriaoperator-e3396/VB/WindowsApplication3/Main.vb#L31

For Each col As GridColumn In gridView1.Columns
    radioGroup1.Properties.Items.Add(New DevExpress.XtraEditors.Controls.RadioGroupItem(col.FieldName, col.GetCaption()))
Next col