ShowCacheDialog Method

Summary
Shows the specified property dialog for the caching filter.
Syntax
C#
VB
C++
public void ShowCacheDialog( 
   TargetFormatDlg Dialog, 
   IWin32Window hWnd 
) 
Public Sub ShowCacheDialog( _ 
   ByVal Dialog As TargetFormatDlg, _ 
   ByVal hWnd As IWin32Window _ 
)  
public: 
void ShowCacheDialog(  
   TargetFormatDlg Dialog, 
   IWin32Window^ hWnd 
)  

Parameters

Dialog
Value that specifies which dialog to display. Must be one of the TargetFormatDlg enumeration values.

hWnd
Value that specifies the dialog owner's window handle.

Remarks

Use the TargetFormat.UseFilterCache property to get a value that indicates whether the toolkit is currently caching filters; or set a value that indicates whether to enable or disable the caching of filters. Use the TargetFormat.GetCacheObject method to retrieve the caching filter object. Use the TargetFormat.HasCacheDialog method to query whether the specified property dialog for the caching filter is available.

Example
C#
VB
using Leadtools; 
using Leadtools.Multimedia; 
using LeadtoolsMultimediaExamples.Fixtures; 
 
public bool _result = false; 
public CaptureCtrlForm _form = new CaptureCtrlForm(); 
 
public void HasCacheDialogExample() 
{ 
   // reference the capture control 
   CaptureCtrl capturectrl = _form.CaptureCtrl; 
 
   try 
   { 
      // set a video device first.  use your video device's name here 
      if (capturectrl.VideoDevices["Analog"] == null) 
         throw new Exception("No Analog audio device available"); 
 
      capturectrl.VideoDevices["Analog"].Selected = true; 
 
      // set the video compressor 
      capturectrl.VideoCompressors.Mpeg2.Selected = true; 
 
      // reference the target formats collection 
      TargetFormat fmt = capturectrl.TargetFormats.MPEG2Program; 
 
      // enumerate through the list of formats 
      foreach (TargetFormat af in capturectrl.TargetFormats) 
      { 
         // check the formats valid compressor and stream type 
         bool isValid = (af.IsValidCompressor(capturectrl.VideoCompressors.Mpeg2.Name) == TargetFormatCompressor.Valid); 
         StreamFormatType types = af.Streams; 
 
         // if valid, select it 
         if (isValid && ((types & StreamFormatType.Video) == StreamFormatType.Video)) 
         { 
            fmt = af; 
            fmt.Selected = true; 
            break; 
         } 
      } 
 
      // check to see if the current target format has a cache dialog 
      if (fmt != null && fmt.HasCacheDialog(TargetFormatDlg.VideoCompressor)) 
      { 
         // show the dialog 
         fmt.ShowCacheDialog(TargetFormatDlg.VideoCompressor, _form); 
 
         // set the result 
         _result = true; 
      } 
   } 
   catch (Exception) 
   { 
      _result = false; 
   } 
} 
Imports Leadtools 
Imports Leadtools.Multimedia 
Imports LeadtoolsMultimediaExamples.Fixtures 
 
Public _result As Boolean = False 
Public _form As CaptureCtrlForm = New CaptureCtrlForm() 
 
Public Sub HasCacheDialogExample() 
   ' reference the capture control 
   Dim capturectrl As CaptureCtrl = _form.CaptureCtrl 
 
   Try 
      ' 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 audio device available") 
      End If 
 
      capturectrl.VideoDevices("Analog").Selected = True 
 
      ' set the video compressor 
      capturectrl.VideoCompressors.Mpeg2.Selected = True 
 
      ' reference the target formats collection 
      Dim fmt As TargetFormat = capturectrl.TargetFormats.MPEG2Program 
 
      ' enumerate through the list of formats 
      For Each af As TargetFormat In capturectrl.TargetFormats 
         ' check the formats valid compressor and stream type 
         Dim isValid As Boolean = (af.IsValidCompressor(capturectrl.VideoCompressors.Mpeg2.Name) = TargetFormatCompressor.Valid) 
         Dim types As StreamFormatType = af.Streams 
 
         ' if valid, select it 
         If isValid AndAlso ((types And StreamFormatType.Video) = StreamFormatType.Video) Then 
            fmt = af 
            fmt.Selected = True 
            Exit For 
         End If 
      Next af 
 
      ' check to see if the current target format has a cache dialog 
      If Not fmt Is Nothing AndAlso fmt.HasCacheDialog(TargetFormatDlg.VideoCompressor) Then 
         ' show the dialog 
         fmt.ShowCacheDialog(TargetFormatDlg.VideoCompressor, _form) 
 
         ' set the result 
         _result = True 
      End If 
   Catch e1 As Exception 
      _result = False 
   End Try 
End Sub 
Requirements

Target Platforms

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

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