fragment Element

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The fragment element specifies one condition of the query that selects items from the library. Conditions are specified by condition strings. A condition string typically has a name portion, a condition portion, and a value portion.

<fragment
    name = "string"
>
</fragment>

Attributes

name (required)

A portion of a condition string. See Remarks.

Parent/Child Elements

Remarks

Certain condition strings have a metadata attribute portion, a condition portion, and a value portion. For example, in the condition string "Album Artist Is Joe", the metadata attribute portion is "Album Artist", the condition portion is "Is", and the value portion is "Joe".

Example:

<fragment name = "Album Artist">
    <argument name = "condition">Is</argument>
    <argument name = "value">Joe</argument>
</fragment>

For condition strings of this type, the following table shows the possible metadata attributes, possible conditions and possible values:

Certain condition strings have a limiter portion, a number portion and a format portion. For example in the condition string "Limit Total Size To 3 Megabytes", the limiter portion is "Limit Total Size To", the number portion is "3" and the format portion is "Megabytes".

Example:

<fragment name = "Limit Total Size To">
  <argument name = "number">3</argument>
  <argument name = "format">Megabytes</argument>
</fragment>

For condition strings of this type the following table shows the possible limiters and formats.

Certain condition strings have a limiter portion and a number portion. For example in the condition string "Limit Number of Items to 25", the limiter portion is "Limit Number of Items" and the number portion is "25".

Example:

<fragment name = "Limit Number of Items">
    <argument name = "number">25</argument>
</fragment>

For condition strings of this type the following table shows the only possible limiter.

Certain condition strings have a protection portion and a condition portion. For example in the condition string "Protection Is present", the protection portion is "Protection" and the condition portion is "Is".

Example:

<fragment name = "Protection">
    <argument name = "condition">Is</argument>
</fragment>

For condition strings of this type the following table shows the possible conditions.

There is one type of fragment element that does not contain a condition string. If the name attribute of a fragment element is "Randomize Playback Order" the fragment element contains no argument elements. This fragment element instructs the player to play the list in random order.

Example:

<fragment name = "Randomize Playback Order">
</fragment>

Certain condition strings have a sort portion, a value portion and a condition portion. For example, in the condition string "Sort By Title Ascending order", the sort portion is "Sort By", the value portion is "Title", and the condition portion is "Ascending". Note that in this case the value portion is a metadata attribute.

Example:

<fragment name = "Sort By">
    <argument name = "value">Title</argument>
    <argument name = "condition">Ascending</argument>
</fragment>

For condition strings of this type the following table shows the possible values and conditions.

When you use a fragment element to sort a playlist, you must sort on a metadata attribute that applies to the type of media items you are sorting. For example, if you are sorting music items you cannot sort on Actor. The following table shows which metadata attributes you can use to sort which media types.

Requirements

See also

argument Element

filter Element

sourceFilter Element

Windows Media Playlist Elements Reference