Add(string,int) Method

Summary
Adds a TargetFormat item to the collection.
Syntax
C#
C++/CLI
public void Add( 
   string Name, 
   int Index 
) 
public: 
void Add(  
   String^ Name, 
   int Index 
)  

Parameters

Name
A String value representing the name of the new format.

Index
Zero based index of the position to insert the format. A value of -1 appends to end of the collection.

Remarks

The user should retrieve the item's object to define the individual properties of the format. The user may not insert a format before a predefined (ReadOnly) format. Check the initial Count value to determine the end of the predefined list. If the method fails, an error is raised. For more information, refer to the Error Codes.

Example
C#
using Leadtools; 
using Leadtools.Multimedia; 
using LeadtoolsMultimediaExamples.Fixtures; 
 
 
public bool _result = false; 
public CaptureCtrlForm _form = new CaptureCtrlForm(); 
 
public void AddExample() 
{ 
   // reference the capture control 
   CaptureCtrl capturectrl = _form.CaptureCtrl; 
 
   try 
   { 
      // set an audio device first.  use your audio device's name here 
      if (capturectrl.AudioDevices["USB"] == null) 
         throw new Exception("No USB audio device available"); 
 
      capturectrl.AudioDevices["USB"].Selected = true; 
 
      // reference the target formats collection 
      TargetFormats formats = capturectrl.TargetFormats; 
 
      // formats count before adding new one. 
      int nCount = formats.Count; 
 
      // demonstrating the add property, Add new format at the end of the collection 
      formats.Add("My Format", -1); 
 
      // get the newly added format 
      TargetFormat myFormat = capturectrl.TargetFormats[capturectrl.TargetFormats.Count - 1]; 
 
      // demonstrating the remove property, Remove new format from the end of the collection 
      formats.Remove(myFormat); 
 
      // set the result to what we expect 
      _result = (nCount == formats.Count); 
   } 
   catch (Exception) 
   { 
      _result = false; 
   } 
} 
Requirements

Target Platforms

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Multimedia Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.