LEADTOOLS Multimedia (Leadtools.Multimedia assembly) Send comments on this topic. | Back to Introduction | Help Version 17.0.3.22
Selection Property
See Also 
Leadtools.Multimedia Namespace > CaptureInputs Class : Selection Property



Gets or sets the zero-based index of the currently selected CaptureInput item.

Syntax

Visual Basic (Declaration) 
Public Property Selection As Integer
Visual Basic (Usage)Copy Code
Dim instance As CaptureInputs
Dim value As Integer
 
instance.Selection = value
 
value = instance.Selection
C# 
public int Selection {get; set;}
C++/CLI 
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.

Example

Visual BasicCopy 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
C#Copy Code
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 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;
   }
}

Remarks

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.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

See Also