Поделиться через


ItemsRepeaterScrollHost Класс

Определение

Вспомогательная функция для координации взаимодействия между ItemsRepeater и ScrollViewer. Используйте ItemsRepeaterScrollHost, если ваше приложение будет работать в версиях Windows до Windows 10 1809 (сборка 17763). Если приложение будет работать только в версиях Windows 1809 или более поздних версий, использовать этот элемент управления не требуется.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

public ref class ItemsRepeaterScrollHost sealed : FrameworkElement
/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.Activatable(1)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="ScrollViewer")]
class ItemsRepeaterScrollHost final : FrameworkElement
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="ScrollViewer")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.XamlContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class ItemsRepeaterScrollHost final : FrameworkElement
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.Activatable(1)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="ScrollViewer")]
public sealed class ItemsRepeaterScrollHost : FrameworkElement
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="ScrollViewer")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.XamlContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public sealed class ItemsRepeaterScrollHost : FrameworkElement
Public NotInheritable Class ItemsRepeaterScrollHost
Inherits FrameworkElement
Наследование
ItemsRepeaterScrollHost
Атрибуты

Примеры

Совет

Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе ItemsRepeater.

Приложения из коллекции WinUI 3 и коллекции WinUI 2 включают интерактивные примеры большинства элементов управления, возможностей и функций WinUI 3 и WinUI 2.

Если они уже установлены, откройте их с помощью следующих ссылок: коллекция WinUI 3 или коллекция WinUI 2.

Если они не установлены, вы можете скачать коллекцию WinUI 3 и коллекцию WinUI 2 из Microsoft Store.

Исходный код можно также получить из GitHub (используйте главную ветвь для WinUI 3 и ветвь winui2 для WinUI 2).

В этом примере показан прокручиваемый список людей.

<Page
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:muxc="using:Microsoft.UI.Xaml.Controls">

    <muxc:ItemsRepeaterScrollHost>
        <ScrollViewer>
            <muxc:ItemsRepeater ItemsSource='{x:Bind PeopleCollection}' />
        </ScrollViewer>
    </muxc:ItemsRepeaterScrollHost> 

</Page

Комментарии

ItemsRepeaterScrollHost — это вспомогательный класс, который можно использовать для переноса ScrollViewer и предоставления функциональных возможностей новых API в более ранних версиях Windows 10.

Начиная с Windows 10, версия 1809 (sdk 17763), ScrollViewer имеет свойства, которые координируют взаимодействие между ItemsRepeater и ScrollViewer. Если ваше приложение предназначено для версий Windows 10 до версии 1809 (SDK 17763), заключите ScrollViewer в ItemsRepeaterScrollHost, чтобы обеспечить функциональность этих API. Свойства ItemsRepeaterScrollHost реплицируют те же функции и поведение, что и аналогичные именованные, которые находятся в ScrollViewer.

Если минимальная целевая версия приложения Windows 10, версия 1809 (пакет SDK 17763) или более поздняя, использовать этот элемент управления не требуется.

Конструкторы

ItemsRepeaterScrollHost()

Инициализирует новый экземпляр класса ItemsRepeaterScrollHost .

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

Свойства

CurrentAnchor

Текущий выбранный элемент привязки для привязки прокрутки.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

HorizontalAnchorRatio

Определяет горизонтальную позицию точки привязки ScrollViewer относительно окна просмотра. По умолчанию ScrollViewer выбирает элемент в качестве объекта CurrentAnchor , определяя элемент в своем порте просмотра, ближайший к точке привязки.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

ScrollViewer

Возвращает или задает ScrollViewer для размещения.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

VerticalAnchorRatio

Определяет вертикальную позицию точки привязки ScrollViewer относительно окна просмотра. По умолчанию ScrollViewer выбирает элемент в качестве объекта CurrentAnchor , определяя элемент в своем порте просмотра, ближайший к точке привязки.

Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).

Применяется к