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