CreateFileListHelper Class
Enables users to gather lists of items from the media libraries (pictures, music, videos, and recorded TV) and provide them to an MCML-based application. Such applications include, but are not limited to, CD/DVD burning applications. Applications can add and remove items from these lists, and open lists that were previously created.
This class 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. And, depending on the properties set for your application, the UI automatically displays the appropriate choices to the user (such as the media types that your application supports, or the ability to reorder items in the list).
This class provides additional properties that can be used by a CD/DVD recording application to specify information about the recording medium, such as 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.
public sealed class CreateFileListHelper : MarshalByRefObject, Microsoft.MediaCenter.UI.IPropertyObject, ICreateFileListHelper
Members
Public Instance Methods
| Method | Description |
| CreateFileListHelper | Initializes an instance of a CreateFileListHelper object. |
| 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. |
| Reset | Informs the list application that the user has reset the list of items. |
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 and sets the string that Windows Media Center uses as the message in the dialog box that is displayed when the user cancels the process. |
| CancelDialogTitle | Gets and sets 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. |
| ClosedReason | Indicates the action that was taken by the user to close the list application. |
| CreatePageTitle | Gets and sets the string for the title of the page that is displayed when the user creates a list. |
| FileList | Gets the list of items. |
| 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 and sets 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 or sets 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 and sets the string for the title of the page that displays the list. |
Public Instance Events
| Event | Description |
| Closed | Raised when the user closes the list of items. |
| ItemAdded | Raised when the user adds a new item to the list. |
| ItemRemoved | Raised when the user removes an item from the list. |
| ItemsCleared | Raised when the user clears all items from the list. |
Requirements
Reference: Microsoft.MediaCenter
Namespace: Microsoft.MediaCenter.ListMaker
Assembly: Microsoft.MediaCenter.dll
Platform: Windows 7
See Also