Folders.item property

[ 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. ]

Gets a System.MessageStore.Folder object from the Folders collection.

This property is read-only.

Syntax

objitem = Folders.item

Property value

An Object that receives a System.MessageStore.Folder object from the specified index.

Examples

The following example demonstrates how to access properties for folders in the Folders collection.

// Member variables.
var collFolders = null;
var oFolder = null;

// --------------------------------------------------------------------
// Initialize the gadget.
// --------------------------------------------------------------------
function Init()
{
    var sMailInfo = ""; 
    
    // Get the collection of folders from Windows Mail.
    collFolders = System.MessageStore.Folders; 

    // Report the folder details.
    for (var loop = 0; loop < collFolders.count; loop++)
    {
        oFolder = collFolders.item(loop);
        sMailInfo += oFolder.name + "<br/>";
        sMailInfo += "Total messages: " + oFolder.messageCount;
        sMailInfo += " (" + oFolder.unreadMessageCount + " unread)<br/>";
    }    
    
    return sMailInfo;
}

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	Sidebar.idl
DLL	Sidebar.Exe (version 1.00 or later)

See also

Reference

count

Folders

System.MessageStore

System.MessageStore.Folder

Messages

System.MessageStore.Message