How do I set ListView's `ScrollViewer.HorizontalScrollMode` in codebehind?

Question

I want to customize a ListView's ScrollViewer.HorizontalScrollMode from codebehind. How can I do this?

It is easy in XAML:

<ListView
    x:Name="MyListView"
    ScrollViewer.VerticalScrollMode="Disabled"
    ScrollViewer.VerticalScrollBarVisibility="Hidden"
    ScrollViewer.HorizontalScrollMode="Disabled"
    ScrollViewer.HorizontalScrollBarVisibility="Auto">
    <!-- ...-->
</ListView>

But how could I do this in C# or C++/CX codebehind?

Disclaimer: I work for Microsoft.

score 1 · Accepted Answer · answered Mar 09 '21 at 21:27

The ScrollViewer properties (like VerticalScrollMode, VerticalScrollBarVisibility, etc) are attached properties (just like AutomationProperties are).

XAML actually provides two methods of setting these properties:

The property system (SetValue and GetValue)
The XAML accessor pattern

I find the SetValue pattern super straightforward:

// C++/CX
this->MyListView->SetValue(ScrollViewer::VerticalScrollModeProperty, ScrollMode::Disabled);
this->MyListView->SetValue(ScrollViewer::VerticalScrollBarVisibilityProperty, ScrollBarVisibility::Hidden);
this->MyListView->SetValue(ScrollViewer::HorizontalScrollModeProperty, ScrollMode::Disabled);
this->MyListView->SetValue(ScrollViewer::HorizontalScrollBarVisibilityProperty, ScrollBarVisibility::Hidden);

(I have not used the other pattern).

This method works for all AttachedProperties (see this similar StackOverflow question).

This works because attached properties are, at their core, DependencyProperties, which provide the SetValue and GetValue APIs. From the documentation of attached properties:

Attached properties for the Windows Runtime are implemented as dependency properties, so that the values can be stored in the shared dependency-property store by the property system. Therefore attached properties expose a dependency property identifier on the owning class.

How do I set ListView's `ScrollViewer.HorizontalScrollMode` in codebehind?

1 Answers1