Selection Property (CaptureInputs)

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

public int Selection {get; set;}

'Declaration
 
Public Property Selection As Integer

'Usage
 
Dim instance As CaptureInputs
Dim value As Integer
 
instance.Selection = value
 
value = instance.Selection

public int Selection {get; set;}

 get_Selection();
 set_Selection(value);

public:
property int Selection {
   int get();
   void set (    int value);
}

Property Value

The zero-based index of the selected item; or -1 if no item is selected.

If this property is -1, then check the number of capture inputs in the Count Property. If the Count property is non-zero then the Video and Audio inputs do not match. This is only a warning and not an error. The inputs may be left the way they are, or this situation may be corrected using the NearestSelection property.

For more information on unmatched pairs of video and audio inputs, refer to CaptureInputs Object.

Assignment can raise an error exception. For more information, refer to the Error Codes.

Visual Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Copy Code

Public _result As Boolean = False
Public _form As CaptureCtrlForm = New CaptureCtrlForm()
Public Sub CaptureInputsExample()
  Dim inputName, inputFriendlyName As String
  Dim selection As Integer

  ' reference the capture control
  Dim capturectrl As CaptureCtrl = _form.CaptureCtrl

  ' select a video device, use your device name here instead of Analog
  If capturectrl.VideoDevices("Analog") Is Nothing Then
     Throw New Exception("No Analog video tuner device available")
  End If

  capturectrl.VideoDevices("Analog").Selected = True

  ' get the audio inputs object
  Dim inputs As CaptureInputs = capturectrl.VideoInputs

  Try
     ' select an input by name if possible
     If Not inputs("Video Composite") Is Nothing Then
       inputs("Video Composite").Selected = True
     End If

     ' get the current selected input
     selection = inputs.Selection

     For Each ci As CaptureInput In inputs
       ' get the inputs properties
       inputName = ci.Name
       inputFriendlyName = ci.FriendlyName

       ' if we found the video tuner input
       If inputFriendlyName = "Video Tuner" Then
         ' select it and break
         ci.Selected = True
         Exit For
       End If
     Next ci

     ' set the result to what we expect
     _result = (selection <> inputs.Selection)

  Catch e1 As Exception
     _result = False
  End Try
End Sub

public bool _result = false;
public CaptureCtrlForm _form = new CaptureCtrlForm();
public void CaptureInputsExample()
{
   string inputName, inputFriendlyName;
   int selection;

   // reference the capture control
   CaptureCtrl capturectrl = _form.CaptureCtrl;

   // select a video device, use your device's name here instead of Analog
   if (capturectrl.VideoDevices["Analog"] == null)
      throw new Exception("No Analog video tuner device available");

   capturectrl.VideoDevices["Analog"].Selected = true;

   // get the audio inputs object
   CaptureInputs inputs = capturectrl.VideoInputs;

   try
   {
      // select an input by name if possible
      if (inputs["Video Composite"] != null)
         inputs["Video Composite"].Selected = true;

      // get the current selected input
      selection = inputs.Selection;

      foreach (CaptureInput ci in inputs)
      {
         // get the inputs properties
         inputName = ci.Name;
         inputFriendlyName = ci.FriendlyName;

         // if we found the video tuner input
         if (inputFriendlyName == "Video Tuner")
         {
            // select it and break
            ci.Selected = true;
            break;
         }
      }

      // set the result to what we expect
      _result = (selection != inputs.Selection);

   }
   catch (Exception)
   {
      _result = false;
   }
}

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

CaptureInputs Class
CaptureInputs Members