System.Shell.Folder.newFolder Method

Creates a new folder.

Syntax

System.Shell.Folder.newFolder(
  strNewFolder,
  [ intOptions ]
)

Parameters

• strNewFolder [in]
  BSTR Sets String that specifies the name of the new folder.
• intOptions [in, optional]
  int Sets This value is not defined.

Return Value

This method does not return a value.

Examples

The following example demonstrates how to select a location and create a new folder.

var oShellFolderItem;
var oShellFolder;

// --------------------------------------------------------------------
// Display the folder picker dialog and get a Shell.Item object 
// from the selection. A Shell folder object is also obtained.
// --------------------------------------------------------------------
function ChooseAFolder()
{
    oShellFolderItem = System.Shell.chooseFolder("SDK Choose Folder Example", 0);
    if (oShellFolderItem)
    {
        spFeedback.innerHTML = oShellFolderItem.name + "<br/>";
        // Get a folder object from the System.Shell.Item.
        oShellFolder = oShellFolderItem.SHFolder;
    }
}

// --------------------------------------------------------------------
// Create a new folder.
// --------------------------------------------------------------------
function CreateFolder(folderName)
{
    try
    {
        if (oShellFolder)
        {
            oShellFolder.newFolder(folderName, 0);
            spFolderFeedback.innerHTML = folderName + " folder created.<br/>";
        }
        else
        {
            spFolderFeedback.innerHTML = "Unable to create folder. No location specified.<br/>Please select a parent folder.<br/>";
        }
    }
    catch (e)
    {
        // Error handling.
    }
}

Requirements

See Also

System.Shell.Folder

Send comments about this topic to Microsoft

Build date: 2/24/2010

Build type: SDK