System.Shell.Item.name Property

Article
03/12/2010

Gets the name of the System.Shell.Item.

This property is read-only.

Syntax

propVal = System.Shell.Item.name()

Parameters

strItemNameResult [out]
Retrieves the name.

Remarks

Honors the "Hide extensions for known file types" setting in Windows Explorer.

Examples

The following example demonstrates how to get the name for an object dropped on the gadget.

// --------------------------------------------------------------------
// Display the names of objects dropped on the gadget.
// --------------------------------------------------------------------
function GetItemFromDrop()
{    
    spFeedback.innerHTML = "Item(s) dropped.<br/>";
    var intIndex = 0;
    var oItem;
    var sItem;
    while(oItem = System.Shell.itemFromFileDrop(event.dataTransfer, intIndex))
    {
        // Display object properties and increment the index.
        sItem = "Other: ";
        if (oItem.isFileSystem == true)
        {
            sItem = "File: ";
        }
        if (oItem.isFolder == true)
        {
            sItem = "Folder: ";
        }
        if (oItem.isLink == true)
        {
            oLinkItem = oItem.link;
            sItem = "Link (" + oLinkItem.path + "): ";
        }
        spFeedback.innerHTML += sItem;
        spFeedback.innerHTML += oItem.name + "<br/>"; 
                
        intIndex++;
    }
}

Requirements

Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
DLL	Sidebar.Exe version 1.00 or later