In This Topic ▼

TargetFile Property

Summary

Gets or sets the media target filename.

Syntax

C++/CLI

[EditorAttribute(System.Type, System.Type)] 
public virtual string TargetFile { get; set; }

public: 
virtual property String^ TargetFile { 
   String^ get(); 
   void set (    String^ ); 
}

Property Value

A string value representing the target filename.

Remarks

This property allows the user to set the output of the conversion process to the specified filename. If the TargetFormat property is TargetFormatType.DVD, then the TargetFile property contains the directory in which the DVD image is located. Otherwise, the TargetFile property contains the name of a media file. If the TargetFile property refers to a directory, it should contain the full path to the directory. A relative path can be used, but it is not recommended because relative paths are somewhat unpredictable. If the target format type is TargetFormatType.DVD and the TargetFile property contains the name of an existing file, that file will be deleted, and a directory or folder will be created with the same name. The filename can be used to indicate a regular file or a stream. For more details on the filename syntax, refer to: TargetFile Syntax. Assignment can raise an error exception. For more information, refer to the Error Codes.

Example

using Leadtools; 
using Leadtools.Multimedia; 
using LeadtoolsMultimediaExamples.Fixtures; 
 
 
public bool _result = false; 
public ConvertCtrlForm _form = new ConvertCtrlForm(); 
 
public void HasDialogExample() 
{ 
   // reference the convert control 
   ConvertCtrl convertctrl = _form.ConvertCtrl; 
 
   // input and output files 
   string inFile = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_Source.avi"); 
   string outFile = Path.Combine(LEAD_VARS.MediaDir, "ConvertCtrl_HasDialogExample.avi"); 
 
   try 
   { 
      // set the source for conversion 
      convertctrl.SourceFile = inFile; 
 
      // set the video and audio compressors 
      convertctrl.VideoCompressors.Mpeg2.Selected = true; 
      convertctrl.AudioCompressors.AC3.Selected = true; 
 
      // set the target output file and format 
      convertctrl.TargetFile = outFile; 
 
      // set the target output format 
      convertctrl.TargetFormat = TargetFormatType.AVI; 
 
      // The HasDialog method tells us that the control 
      // can display the desired settings dialog. 
      // check to see if the convert source dialog is available 
      if (convertctrl.HasDialog(ConvertDlg.TargetFormat)) 
      { 
         // now show it 
         convertctrl.ShowDialog(ConvertDlg.TargetFormat, _form); 
         _result = true; 
      } 
 
      // enable preview 
      convertctrl.Preview = true; 
 
      // set preview visible 
      convertctrl.PreviewVisible = true; 
 
      // start the capture process 
      convertctrl.StartConvert(); 
 
      // 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(); 
 
      // see if there was an error 
      if (convertctrl.ConvertError != 0) 
      { 
         // set the result to false 
         _result = false; 
      } 
   } 
   catch (Exception) 
   { 
      _result = false; 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string MediaDir = @"C:\LEADTOOLS23\Media"; 
}

Requirements

Target Platforms

Reference

ConvertCtrl Class

ConvertCtrl Members

ResetTarget Method

Download our FREE evaluation

Help Version 23.0.2024.2.29

Leadtools.Multimedia Assembly

Introduction

Getting Started

Namespaces

Leadtools.Multimedia Namespace

Leadtools.Multimedia.Common Namespace

Assemblies