NearestSelection Property

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

public int NearestSelection {get;}

'Declaration
 
Public ReadOnly Property NearestSelection As Integer

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

public int NearestSelection {get;}

 get_NearestSelection();

public:
property int NearestSelection {
   int get();
}

Property Value

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

If the Selection is -1, despite the fact there is a selected input, then the selected video capture input does not match the selected audio input. In this case, check the value of the NearestSelection property to retrieve the index of the last selected capture input. Set the Selection property to the value in the NearestSelection property to fix the problem. Please note that if an audio-video pair are mismatched intentionally, it may be best to keep the pair mismatched. For more information on unmatched pairs of video and audio inputs, refer to the CaptureInputs object.

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 NearestSelectionExample()
   ' reference the capture control and it's video inputs
   Dim capturectrl As CaptureCtrl = _form.CaptureCtrl

   ' set a video device first, you should use your video device name here
   If capturectrl.VideoDevices("Analog") Is Nothing Then
      Throw New Exception("No Analog video tuner device available")
   End If

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

   ' set a video device first, you should use your video device name here
   If capturectrl.AudioDevices("Analog") Is Nothing Then
      Throw New Exception("No matching Analog audio device available")
   End If

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

   Try
      ' get the video inputs collection
      Dim videoInputs As CaptureInputs = capturectrl.VideoInputs

      ' select the video tuner input
      videoInputs("Video Tuner").Selected = True

      ' select the nearest selection to the last selection
      videoInputs.Selection = videoInputs.NearestSelection

      ' set the result to what we expect
      _result = True
   Catch e1 As Exception
      _result = False
   End Try
End Sub

public bool _result = false;
public CaptureCtrlForm _form = new CaptureCtrlForm();
public void NearestSelectionExample()
{
   // reference the capture control and its video inputs
   CaptureCtrl capturectrl = _form.CaptureCtrl;

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

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

   // set a video device first.  use your video device's name here
   if (capturectrl.AudioDevices["Analog"] == null)
      throw new Exception("No matching Analog audio device available");

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

   try
   {
      // get the video inputs collection
      CaptureInputs videoInputs = capturectrl.VideoInputs;

      // select the video tuner input
      videoInputs["Video Tuner"].Selected = true;

      // select the nearest selection to the last selection
      videoInputs.Selection = videoInputs.NearestSelection;

      // set the result to what we expect
      _result = true;
   }            
   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