ICreateFileListHelper Interface

Enables users to gather lists of items from the media libraries (pictures, music, videos, and recorded TV) and provide them to an application. Such applications include, but are not limited to, CD/DVD burning applications.

Windows Media Center uses this interface to provide list items to the application, and to retrieve information from the application about the recording medium. In particular, Windows Media Center gets the total capacity of the medium and the amount of unused space remaining on the medium. The application can communicate this information to the user during the file selection process.

This interface also provides strings that Windows Media Center uses to customize the list-making part of the user interface, allowing your application to establish your brand's identity inside Windows Media Center.

public interface ICreateFileListHelper

Members

Public Instance Methods

MethodDescription
OnClosedInforms the list application that the user has closed a list of items.
OnItemAddedInforms the list application that the user has added a new file to the list.
OnItemRemovedInforms the list application that the user has removed a file from the list.
OnItemsClearedInforms the list application that the user has clicked the Remove All button to remove all previously selected items from the list.

Public Instance Properties

PropertyDescription
ByteCapacityIndicates the capacity of the CD or DVD, in bytes.
BytesUsedIndicates the amount of CD or DVD space, in bytes, that has been used so far.
CancelDialogMessageGets the string that Windows Media Center uses as the message for the dialog box that is displayed when the user cancels the process.
CancelDialogTitleGets the string that Windows Media Center uses as the title of the dialog box that is displayed when the user cancels the process.
CapacityFormatIndicates the format in which a CD/DVD recording application provides status information.
CreatePageTitleGets the string that Windows Media Center uses as the title of the page that is displayed when the user creates a list.
IsOrderImportantIndicates whether the user is allowed to control the order of the files in the list.
ItemCapacityIndicates the capacity of the CD or DVD, in items.
ItemsUsedIndicates the amount of CD or DVD space, in items, that has been used so far.
SaveListButtonTitleGets the string that Windows Media Center uses as the button label in the dialog box that is displayed when the user saves the list.
ShowCapacityAsPercentageIndicates whether the status is expressed as a percentage.
ShowRemainingCapacityIndicates whether the status message should reflect the total capacity or the remaining space on the CD or DVD.
SupportedMediaTypesIndicates the types of media supported by a CD/DVD recording application.
TimeCapacityGets a value that indicates the total amount of available recording time on the CD or DVD.
TimeUsedIndicates the amount of recording time that has been used on the CD or DVD.
ViewListPageTitleGets the string for the title of the page that displays the list.

Requirements

Reference: Microsoft.MediaCenter

Namespace: Microsoft.MediaCenter.ListMaker

Assembly: Microsoft.MediaCenter.dll

Platform: Windows Vista

See Also

Show: