> For the complete documentation index, see [llms.txt](https://docs.dbnetsoft.com/dbnetsoft/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dbnetsoft.com/dbnetsoft/screenspro/controls/listelement.md).

# ListElement

This element will display a list of items.

## Properties

<table data-full-width="true"><thead><tr><th width="229">Name</th><th width="155.66666666666669">Type</th><th>Description</th></tr></thead><tbody><tr><td>Data</td><td>object[]</td><td>An array of objects coming from a <a href="/dbnetsoft/screenspro/sources.md">source</a></td></tr><tr><td>RowsVisible</td><td>int</td><td>Number of items visible at the same time</td></tr><tr><td>RowIncrementPerChange</td><td>int</td><td>Number of rows shifted per change. If same as RowsVisible, then whole page is chjanged.</td></tr><tr><td>ChangeInterval</td><td>TimeSpan</td><td>Interval of when a change is done</td></tr><tr><td>RowBackground</td><td>Brush</td><td>Background behind a row, drawn behind the <code>ItemTemplate</code>. Not set by default, which leaves the rows transparent.</td></tr><tr><td>AlternateRowBackground</td><td>Brush</td><td>Background behind every second row, for a striped list. Falls back to <code>RowBackground</code> while it is not set.</td></tr><tr><td>DataChangedMode</td><td>Enum</td><td><p>Whenever data is set, this value defines what happens:</p><p><code>KeepPosition</code> will keep the current scroll position<br><code>StartFromBeginning</code> will revert to the start</p></td></tr><tr><td>DataContentChangedMode</td><td>Enum</td><td><p>Whenever data is set and the content is different than before, this value defines what happens:</p><p><code>KeepPosition</code> will keep the current scroll position<br><code>StartFromBeginning</code> will revert to the start</p></td></tr><tr><td>DataChangedDelayMode</td><td>Enum</td><td>Defines when a data change occurs when new data is set:<br><code>Now</code> changes the data source instantly<br><code>AfterCurrentPage</code> changes after the current page<br><code>AfterLastPage</code> waits until the end before changing</td></tr></tbody></table>

## Row backgrounds

`RowBackground` and `AlternateRowBackground` paint the area a row is drawn in, behind the `ItemTemplate`. They alternate by the position on screen, not by the row, so the stripes stay where they are while the rows scroll through them.

As long as neither is set, the rows keep no background at all, which is what an overlay on top of a video usually wants. Setting only `RowBackground` gives every row the same background.

```xml
<controls:ListElement Data="{Binding Sources.Results.Value}"
                      RowsVisible="5"
                      RowBackground="#CC000000"
                      AlternateRowBackground="#CC202020" />
```

The same pair of properties exists on ItemsElement as `ItemBackground` and `AlternateItemBackground`.