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
| Method | Description |
| OnClosed | Informs the list application that the user has closed a list of items. |
| OnItemAdded | Informs the list application that the user has added a new file to the list. |
| OnItemRemoved | Informs the list application that the user has removed a file from the list. |
| OnItemsCleared | Informs the list application that the user has clicked the Remove All button to remove all previously selected items from the list. |
Public Instance Properties
| Property | Description |
| ByteCapacity | Indicates the capacity of the CD or DVD, in bytes. |
| BytesUsed | Indicates the amount of CD or DVD space, in bytes, that has been used so far. |
| CancelDialogMessage | Gets the string that Windows Media Center uses as the message for the dialog box that is displayed when the user cancels the process. |
| CancelDialogTitle | Gets the string that Windows Media Center uses as the title of the dialog box that is displayed when the user cancels the process. |
| CapacityFormat | 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 page that is displayed when the user creates a list. |
| IsOrderImportant | Indicates whether the user is allowed to control the order of the files in the list. |
| ItemCapacity | Indicates the capacity of the CD or DVD, in items. |
| ItemsUsed | Indicates the amount of CD or DVD space, in items, that has been used so far. |
| SaveListButtonTitle | Gets the string that Windows Media Center uses as the button label in the dialog box that is displayed when the user saves the list. |
| ShowCapacityAsPercentage | Indicates whether the status is expressed as a percentage. |
| ShowRemainingCapacity | Indicates whether the status message should reflect the total capacity or the remaining space on the CD or DVD. |
| SupportedMediaTypes | Indicates the types of media supported by a CD/DVD recording application. |
| TimeCapacity | Gets a value that indicates the total amount of available recording time on the CD or DVD. |
| TimeUsed | Indicates the amount of recording time that has been used on the CD or DVD. |
| ViewListPageTitle | Gets 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