Gets or sets the time limit for capturing a still image, in milliseconds. 
         
             
            
Syntax
| Visual Basic (Declaration) |   | 
|---|
Public Overridable Property StillCaptureLimit As Integer  | 
 
| Visual Basic (Usage) |  Copy Code | 
|---|
Dim instance As ConvertCtrl
Dim value As Integer
 
instance.StillCaptureLimit = value
 
value = instance.StillCaptureLimit  | 
 
| C# |   | 
|---|
public virtual int StillCaptureLimit {get; set;} | 
 
| C++/CLI |   | 
|---|
public:
virtual property int StillCaptureLimit {
   int get();
   void set (    int value);
} | 
 
             
             
            Property Value
A value representing the time limit for still capture, in milliseconds.
  
             
             
            
Example
 
             | Visual Basic |  Copy Code | 
|---|
Public _result As Boolean = False
      Public _form As ConvertCtrlForm = New ConvertCtrlForm()
      Public _convertctrl As ConvertCtrl = Nothing
      Public _bmpFile As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_SaveStillBitmap.bmp")
      Public Sub SaveStillBitmapExample()
         ' input and output file names
         Dim inFile As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_Source.avi")
         Dim outFile As String = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_SaveStillBitmapExample.mpg")
         Try
            ' reference the convert control
            _convertctrl = _form.ConvertCtrl
            ' set a timer on the form to make the still bitmap
            _form.TestTimer.Interval = 5000
            AddHandler _form.TestTimer.Tick, AddressOf SaveStillBitmap_Helper
            ' enable still capture
            _convertctrl.EnableStillCapture = True
            ' set the time window limit for capture of stills (ms)
            _convertctrl.StillCaptureLimit = 100000
            ' set the compressor to DVVideo
            _convertctrl.VideoCompressors.DVVideo.Selected = True
            ' set the source and target files
            _convertctrl.SourceFile = inFile
            _convertctrl.TargetFile = outFile
            ' convert it now!
            _convertctrl.StartConvert()
            ' now start the test timer for the still capture
            _form.TestTimer.Start()
         Catch e1 As Exception
            _result = False
         End Try
         ' we'll loop on the state and pump messages for this example.
         ' but you should not need to if running from a Windows Forms application.
         Do While _convertctrl.State = ConvertState.Running
            Application.DoEvents()
         Loop
      End Sub
      Public Sub SaveStillBitmap_Helper(ByVal sender As Object, ByVal e As EventArgs)
         ' cancel the timer
         _form.TestTimer.Stop()
         ' try to simulate an error condition
         _convertctrl.SaveStillBitmap(_bmpFile, StillFormatType.BMP, 0, 0, -1)
         ' check for the capture file and set the result
         If File.Exists(Path.Combine(Directory.GetCurrentDirectory(), _bmpFile)) Then
            _result = True
         End If
      End Sub
Public NotInheritable Class LEAD_VARS
   Public Const MediaDir As String = "C:\Program Files (x86)\LEAD Technologies\LEADTOOLS 17\Media"
End Class | 
 
| C# |  Copy Code | 
|---|
public bool _result = false;
      public ConvertCtrlForm _form = new ConvertCtrlForm();
      public ConvertCtrl _convertctrl = null;
      public string _bmpFile = Path.Combine(LEAD_VARS.MediaDir,"ConvertCtrl_SaveStillBitmap.bmp");
      public void SaveStillBitmapExample()
      {
         // input and output file names
         string inFile = Path.Combine(LEAD_VARS.MediaDir,"ConvertCtrl_Source.avi");
         string outFile = Path.Combine(LEAD_VARS.MediaDir,"ConvertCtrl_SaveStillBitmapExample.mpg");
         try
         {
            // reference the convert control
            _convertctrl = _form.ConvertCtrl;
            // set a timer on the form to make the still bitmap
            _form.TestTimer.Interval = 5000;
            _form.TestTimer.Tick += new EventHandler(SaveStillBitmap_Helper);
            // enable still capture
            _convertctrl.EnableStillCapture = true;
            // set the time window limit for capture of stills (ms)
            _convertctrl.StillCaptureLimit = 100000;
            // set the compressor to DVVideo
            _convertctrl.VideoCompressors.DVVideo.Selected = true;
            // set the source and target files
            _convertctrl.SourceFile = inFile;
            _convertctrl.TargetFile = outFile;
            // convert it now!
            _convertctrl.StartConvert();
            // now start the test timer for the still capture
            _form.TestTimer.Start();
         }
         catch (Exception)
         {
            _result = false;
         }
         // we'll loop on the state and pump messages for this example.
         // but you should not need to if running from a Windows Forms application.
         while (_convertctrl.State == ConvertState.Running)
            Application.DoEvents();
      }
      public void SaveStillBitmap_Helper(object sender, EventArgs e)
      {
         // cancel the timer
         _form.TestTimer.Stop();
         // try to simulate an error condition
         _convertctrl.SaveStillBitmap(_bmpFile, StillFormatType.BMP, 0, 0, -1);
         // check for the capture file and set the result
         if (File.Exists(Path.Combine(Directory.GetCurrentDirectory(), _bmpFile)))
            _result = true;
      }
static class LEAD_VARS
{
   public const string MediaDir = @"C:\Program Files (x86)\LEAD Technologies\LEADTOOLS 17\Media";
} | 
 
  
            
            Remarks
            
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