NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

DomainUpDown.SelectedItem

Gets or sets the selected item based on the index value of the selected item in the collection.

[Visual Basic]
Public Property SelectedItem As Object
[C#]
public object SelectedItem {get; set;}
[C++]
public: __property Object* get_SelectedItem();
public: __property void set_SelectedItem(Object*);
[JScript]
public function get SelectedItem() : Object;
public function set SelectedItem(Object);

Property Value

The selected item based on the SelectedIndex value. The default value is TBD.

Remarks

When this property is set, the value is validated to be one of the items in the collection and the SelectedIndex property is set to the appropriate index value.

Example [Visual Basic]

The following example instantiates and initializes a DomainUpDown control. The example allows you to set some of its properties and create a collection of strings for display in the up-down control. The code assumes that a Label, TextBox, CheckBox and a Button have been instantiated on a form. You can enter a string in the text box and add it to the System.WinForms.DomainUpDownItems.Items collection when the button is clicked. By clicking the check box, you can toggle the Sorted property and observe the the difference in the collection of items in the up-down control.

[Visual Basic]

' Instantiate the DomainUpDown control.
Private DomainUpDown1 As System.WinForms.DomainUpDown
Private myCounter as Integer

Private Sub MySub()
   ' Initialize the DomainUpDown control.
   Form1.DomainUpDown1 = New System.WinForms.DomainUpDown
End Sub

Private Sub Button1_Click(ByVal sender As System.Object, 
  ByVal e As System.EventArgs)
   
   ' Add the text box contents to the DomainUpDown control and
   ' and its initial location in the collection.
   DomainUpDown1.Items.Add(Trim(TextBox1.Text) & " - " & myCounter)
   
   ' Increment the counter variable.
   myCounter = myCounter + 1

   'Clear the TextBox.
   TextBox1.Text = ""
End Sub

Private Sub CheckBox1_Click(ByVal sender As System.Object, 
    ByVal e As System.EventArgs)
   ' If Sorted is set to true, set it to false; otherwise set it to true.
   If DomainUpDown1.Sorted = True Then
      DomainUpDown1.Sorted = False
   Else
      DomainUpDown1.Sorted = True
   End If
End Sub

Private Sub DomainUpDown1_SelectedItemChanged(ByVal sender As System.Object, 
          ByVal e As System.EventArgs)
   ' Display the SelectedIndex & SelectedItem property values in the label.
   Label1.Text = "SelectedIndex: " & DomainUpDown1.SelectedIndex & vbcrlf & _
     "SelectedItem: " & DomainUpDown1.SelectedItem
End Sub

See Also

DomainUpDown Class | DomainUpDown Members | System.WinForms Namespace | SelectedIndex