SftDirectoryFolder.Do Method	Softel vdm, Inc.

Performs the specified action.

Syntax       

		VB.NET	object.Do(ByVal Action As String)
		VB	object.Do(ByVal Action As String)
		C#.NET	void object.Do(string Action);
		VC++	HRESULT object->Do(_bstr_t Action);
		C	HRESULT object->raw_Do(BSTR Action);
		Delphi	procedure object.Do(Action : WideString);

object

A SftDirectoryFolder object.

Action

A string defining the action to be executed. The string is case-sensitive and must be entered as shown here, without leading or trailing blanks. Some of the standard Action strings (implemented by Windows and Shell extensions) are:

Action	Description
copy	Copy a file/folder to the clipboard
open	Execute program or open a file/folder
(empty string)	Execute program or open a file/folder (default action for folder type)
explore	Open a file/folder in a new window
cut	Copy a file/folder to the clipboard and remove it
delete	Remove a file/folder
link	Create a shortcut
move	Move a file/folder to another location
rename	Rename a file/folder
droptarget	Tests if a file/folder is a valid target for a drag & drop operation
paste	Copy the clipboard contents to the specified location
properties	Display file/folder properties
NewFolder	Create a new folder.  Edit mode is entered automatically, so the folder name can be renamed.  If the RenameStyle property is set to renameSftDirectoryNone or if the control is a combo box style control (see ControlStyle property), edit mode is not used.

Comments

The Do method performs the specified action.

Strings provided as Action parameter are Windows operating system specific and may be implemented by Shell extensions.  Action parameters are not processed or implemented by SftDirectory, they are simply passed to the Windows Shell or Shell extensions.

The Folder.Can method can be used to test whether the specified action Action is supported by the file/folder. It does not guarantee that the action can be successfully executed. 

The Folder.Do method can be used to perform an action for one particular file/folder only.  The control's Do method performs the specified action for all currently selected files/folders.

Any error messages that may be issued by the Windows Shell or Shell extension as a result of the Do method are controlled using the ShowErrors and ErrorWindow properties.