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



name
The string name of the item to get.
Gets the CaptureSubType item with the specified name.

Syntax

Visual Basic (Declaration) 
Overloads Public ReadOnly Property Item( _
   ByVal name As String _
) As CaptureSubType
Visual Basic (Usage)Copy Code
Dim instance As CaptureSubTypes
Dim name As String
Dim value As CaptureSubType
 
value = instance.Item(name)
C# 
public CaptureSubType Item( 
   string name
) {get;}
C++/CLI 
public:
property CaptureSubType^ Item {
   CaptureSubType^ get(String^ name);
}

Parameters

name
The string name of the item to get.

Property Value

The CaptureSubType item with the specified name.

Exceptions

ExceptionDescription
System.ArgumentOutOfRangeException 

Example

Visual BasicCopy Code
Public _result As Boolean = False
Public _form As CaptureCtrlForm = New CaptureCtrlForm()
Public Sub IndexContainsExample()
   Try
      ' reference the form capture control
      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 device available")
      End If

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

      ' reference the video capture subtypes collection
      Dim stypes As CaptureSubTypes = capturectrl.VideoCaptureSubTypes

      ' check for RGB24 subtype
      Dim i As Integer = stypes.IndexOf(Leadtools.Multimedia.Constants.MEDIASUBTYPE_YUY2)

      ' access the input via the collection indexer
      Dim cs As CaptureSubType = stypes(i)

      ' check if the collection contains this subtype 
      ' (it should we just got it with IndexOf above!)
      If stypes.Contains(cs) Then
         ' set the result to what we expect
         _result = True
      End If
   Catch e1 As Exception
      _result = False
   End Try
End Sub
C#Copy Code
public bool _result = false;
public CaptureCtrlForm _form = new CaptureCtrlForm();
public void IndexContainsExample()
{
   try
   {
      // reference the form capture control
      CaptureCtrl capturectrl = _form.CaptureCtrl;

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

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

      // reference the video capture subtypes collection
      CaptureSubTypes stypes = capturectrl.VideoCaptureSubTypes;

      // check for RGB24 subtype
      int i = stypes.IndexOf(Constants.MEDIASUBTYPE_YUY2);

      // access the input via the collection indexer
      CaptureSubType cs = stypes[i];

      // check if the collection contains this subtype 
      // (it should we just got it with IndexOf above!)
      if (stypes.Contains(cs))
      {
         // set the result to what we expect
         _result = true;
      }
   }
   catch (Exception)
   {
      _result = false;
   }
}

Remarks

This property provides the ability to access a specific item in the collection by using the following syntax: myCollection[index]. The C# language uses the this keyword to define the indexers instead of implementing the Item property. Visual Basic implements Item as a default property, which provides the same indexing functionality. Capture SubType names are unique. An application can use this method to find a specific capture subtype. If the method fails, an error is raised.

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