Share via


IListMakerApp Interface

Windows Media Center has the ability to gather lists of files from the user and provide them to a CD/DVD recording application. To get file lists from Windows Media Center, an application must implement the IListMakerApp interface. 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. Windows Media Center communicates this information to the user during the file selection process.

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

Syntax

public interface IListMakerApp

Public Instance Methods

Method Description
Cancel Informs a CD/DVD recording application that the user canceled the list-making operation.
ItemAdded Informs a CD/DVD recording application that the user added a new file to the list.
ItemRemoved Informs a CD/DVD recording application that the user removed a file from the list.
Launch Starts a CD/DVD recording application.
RemoveAllItems Informs an application that the user clicked the Remove All button to remove all previously selected items from the list.
Repeat Causes a CD/DVD recording application to repeat the previous recording operation.

Public Instance Properties

Property Description
ByteCapacity Gets a value that indicates the capacity of the CD or DVD, in bytes.
ByteUsed Gets a value that indicates the amount of CD or DVD space, in bytes, that has been used so far.
CanProceed Gets a value that indicates whether a CD/DVD recording application can proceed with a recording operation.
CapacityFormat Gets a value that indicates the format in which a CD/DVD recording application provides status information.
CreatePageTitle Gets the string that Windows Media Center uses as the title of the list creation page.
FailureReason Gets information about an exception raised when an operation failed.
IsPercentCompleteKnown Gets a value that indicates whether the percentage completed is known.
IsTimeRemainingKnown Gets a value that indicates whether the amount of time remaining until completion is known.
ItemCapacity Gets a value that indicates the capacity of the CD or DVD, in items.
ItemUsed Gets a value that indicates the amount of CD or DVD space, in items, that has been used so far.
IsOrderImportant Gets a value that indicates whether the user should be allowed to control the order of the files in the list.
PageTitle Gets the string that Windows Media Center places in the upper-right corner of CD/DVD creation pages.
PercentComplete Gets a value that indicates the progress that a CD/DVD recording application has made in the recording operation.
Repeatable Gets a value that indicates whether to let the user repeat the previous CD or DVD recording operation.
SaveListButtonTitle Gets the string that Windows Media Center places on the button that is used to finish the CD or DVD recording operation.
ShowCapacityAsPercentage Gets a value that indicates whether the status is expressed as a percentage.
ShowRemainingCapacity Gets a value that indicates whether the status message should reflect the capacity of, or space remaining on, the CD or DVD.
Succeeded Gets a value that indicates whether the operation finished successfully.
SupportedMediaTypes Gets a value that indicates the types of media that a CD/DVD recording application supports.
TimeCapacity Gets a value that indicates the capacity of the CD or DVD, in recording time.
TimeRemaining Gets a value that indicates the estimated time remaining before the recording operation is completed.
TimeUsed Gets a value that indicates the amount of recording time that has been used on CD or DVD.
ViewListButtonTitle Gets the string that Windows Media Center places on the button that is used to view the media items to be copied to the CD or DVD.
ViewListPageTitle Gets the string that Windows Media Center uses as the title of the view-list page.

Public Instance Events

Event Description
Completed Raised when the operation has completed.
ProgressChanged Raised when the progress of the operation has changed.

See Also