Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
[ The Windows Gadget Platform/Sidebar is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. ]
Deletes an item from the system by moving it to the Recycle Bin.
Syntax
strRetVal = System.Shell.RecycleBin.deleteItem(
strItemToDelete
)
Parameters
-
strItemToDelete [in]
-
String that specifies the item to delete.
Remarks
The Recycle Bin Properties settings determine how file deletion is handled. For example, whether files are deleted immediately or stored until the Recycle Bin is emptied, whether the Recycle Bin is system-wide or operates on a per-drive basis, and whether confirmation dialogs are displayed.
Examples
The following example demonstrates how to delete objects from the system.
// --------------------------------------------------------------------
// Display the names of objects dropped on the gadget.
// Objects are deleted as required.
// --------------------------------------------------------------------
function GetItemFromDrop()
{
spFeedback.innerHTML = "Item(s) dropped.<br/>";
var intIndex = 0;
var oItem;
var sItem = "Other:";
while(oItem = System.Shell.itemFromFileDrop(event.dataTransfer, intIndex))
{
// Display object properties and increment the index.
if (oItem.isFileSystem == true)
{
sItem = "File: ";
}
if (oItem.isFolder == true)
{
sItem = "Folder: ";
}
if (oItem.isLink == true)
{
sItem = "Link: ";
}
spFeedback.innerHTML += sItem;
spFeedback.innerHTML += oItem.name + "<br/>";
// Delete object as required.
if (deleteDrop.checked == true)
{
System.Shell.RecycleBin.deleteItem(oItem.path);
spFeedback.innerHTML += "Item deleted.<br/>";
}
intIndex++;
}
System.Shell.refreshDesktop();
}
Requirements
| Minimum supported client |
Windows Vista [desktop apps only] |
| Minimum supported server |
Windows Server 2008 [desktop apps only] |
| End of client support |
Windows 7 |
| End of server support |
Windows Server 2008 |
| IDL |
|
| DLL |
|