Compartilhar via


ItemsRepeaterScrollHost Classe

Definição

Um auxiliar para coordenar a interação entre itemsRepeater e ScrollViewer. Use o ItemsRepeaterScrollHost se seu aplicativo for executado em versões do Windows anteriores Windows 10 1809 (Build 17763). Se o aplicativo só for executado em versões do Windows 1809 ou superior, não será necessário usar esse controle.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

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
Herança
ItemsRepeaterScrollHost
Atributos

Exemplos

Dica

Para obter mais informações, diretrizes de design e exemplos de código, consulte ItemsRepeater.

Os aplicativos da Galeria do WinUI 3 e da Galeria do WinUI 2 incluem exemplos interativos da maioria dos controles, recursos e funcionalidade do WinUI 3 e do WinUI 2.

Se já estiverem instalado, abra-os clicando nos seguintes links: Galeria do WinUI 3 ou Galeria do WinUI 2.

Se eles não estiverem instalados, você poderá baixar a Galeria do WinUI 3 e a Galeria do WinUI 2 da Microsoft Store.

Você também pode obter o código-fonte para ambos do GitHub (use o branch main para WinUI 3 e o branch winui2 para WinUI 2).

Este exemplo mostra uma lista rolável de pessoas.

<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

Comentários

ItemsRepeaterScrollHost é uma classe auxiliar que você pode usar para encapsular um ScrollViewer e fornecer funcionalidade de novas APIs em versões anteriores do Windows 10.

Começando no Windows 10, versão 1809 (SDK 17763), o ScrollViewer tem propriedades que coordenam a interação entre um ItemsRepeater e o ScrollViewer. Se seu aplicativo destinar versões de Windows 10 anteriores à versão 1809 (SDK 17763), embrulhe seu ScrollViewer em um ItemsRepeaterScrollHost para fornecer a funcionalidade dessas APIs. As propriedades em ItemsRepeaterScrollHost replicam a mesma funcionalidade e comportamento que as de nome semelhante encontradas no ScrollViewer.

Se a versão mínima de destino do seu aplicativo for Windows 10, versão 1809 (SDK 17763) ou posterior, não será necessário usar esse controle.

Construtores

ItemsRepeaterScrollHost()

Inicializa uma nova instância da classe ItemsRepeaterScrollHost .

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Propriedades

CurrentAnchor

O elemento de âncora atualmente escolhido a ser usado para ancoragem de rolagem.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

HorizontalAnchorRatio

Determina a posição horizontal do ponto de âncora do ScrollViewer em relação ao visor. Por padrão, o ScrollViewer seleciona um elemento como seu CurrentAnchor identificando o elemento em seu visor mais próximo do ponto de âncora.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

ScrollViewer

Obtém ou define o ScrollViewer como host.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

VerticalAnchorRatio

Determina a posição vertical do ponto de âncora do ScrollViewer em relação ao visor. Por padrão, o ScrollViewer seleciona um elemento como seu CurrentAnchor identificando o elemento em seu visor mais próximo do ponto de âncora.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Aplica-se a