UniformGridLayout Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Posiciona os elementos sequencialmente da esquerda para a direita ou de cima para baixo em um layout de disposição.
/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class UniformGridLayout : VirtualizingLayout/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class UniformGridLayout : VirtualizingLayout[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public class UniformGridLayout : VirtualizingLayout[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class UniformGridLayout : VirtualizingLayoutPublic Class UniformGridLayout
Inherits VirtualizingLayout- Herança
- Atributos
-
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute
Exemplos
Tip
Para obter mais informações, diretrizes de design e exemplos de código, consulte ItemsRepeater.
O aplicativo Galeria da WinUI 3 inclui exemplos interativos da maioria dos controles, recursos e funcionalidades da WinUI 3. Obtenha o aplicativo na Microsoft Store ou obtenha o código-fonte no GitHub.
O exemplo a seguir mostra como definir a propriedade ItemsRepeater.Layout para um UniformGridLayout.
<ItemsRepeater ItemsSource="{x:Bind Items}"
ItemTemplate="{StaticResource MyTemplate}">
<ItemsRepeater.Layout>
<UniformGridLayout MinItemWidth="200"
MinColumnSpacing="28"
ItemsJustification="SpaceAround"/>
</ItemsRepeater.Layout>
</ItemsRepeater>
Comentários
Os itens são colocados em ordem da esquerda para a direita quando a Orientação é Horizontal, e colocados de cima para baixo quando a Orientação é Vertical.
Cada item em um UniformGridLayout é dimensionado igualmente.
UniformGridLayout dá suporte à virtualização quando anexado a um host que dá suporte à virtualização.
Construtores
| Nome | Description |
|---|---|
| UniformGridLayout() |
Inicializa uma nova instância da classe UniformGridLayout . |
Propriedades
| Nome | Description |
|---|---|
| Dispatcher |
Sempre retorna |
| DispatcherQueue |
Obtém o |
| IndexBasedLayoutOrientation |
Obtém a orientação, se houver, na qual os itens são dispostos com base em seu índice na coleção de origem. (Herdado de Layout) |
| ItemsJustification |
Obtém ou define um valor que indica como os itens são alinhados no eixo não rolagem ou não virtualização. |
| ItemsJustificationProperty |
Identifica a propriedade de dependência ItemsJustification . |
| ItemsStretch |
Obtém ou define um valor que indica como os itens são dimensionados para preencher o espaço disponível. |
| ItemsStretchProperty |
Identifica a propriedade de dependência ItemsStretch . |
| MaximumRowsOrColumns |
Obtém ou define o número máximo de itens renderizados por linha ou coluna, com base na orientação do UniformGridLayout. |
| MaximumRowsOrColumnsProperty |
Identifica a propriedade de dependência MaximumRowsOrColumns . |
| MinColumnSpacing |
Obtém ou define o espaço mínimo entre os itens no eixo horizontal. |
| MinColumnSpacingProperty |
Identifica a propriedade de dependência MinColumnSpacing . |
| MinItemHeight |
Obtém ou define a altura mínima de cada item. |
| MinItemHeightProperty |
Identifica a propriedade de dependência MinItemHeight . |
| MinItemWidth |
Obtém ou define a largura mínima de cada item. |
| MinItemWidthProperty |
Identifica a propriedade de dependência MinItemWidth . |
| MinRowSpacing |
Obtém ou define o espaço mínimo entre os itens no eixo vertical. |
| MinRowSpacingProperty |
Identifica a propriedade de dependência MinRowSpacing . |
| Orientation |
Obtém ou define o eixo ao longo do qual os itens são dispostos. |
| OrientationProperty |
Identifica a propriedade de dependência De orientação . |
Métodos
| Nome | Description |
|---|---|
| Arrange(LayoutContext, Size) |
Posiciona elementos filho e determina um tamanho para um UIElement de contêiner. Os elementos de contêiner que dão suporte a layouts anexados devem chamar esse método de implementações de substituição de layout para formar uma atualização de layout recursivo. (Herdado de Layout) |
| ArrangeOverride(VirtualizingLayoutContext, Size) |
Quando implementado em uma classe derivada, fornece o comportamento para a passagem "Organizar" do layout. As classes podem substituir esse método para definir seu próprio comportamento de passagem "Organizar". (Herdado de VirtualizingLayout) |
| ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject) |
| CreateDefaultItemTransitionProvider() |
Posiciona os elementos sequencialmente da esquerda para a direita ou de cima para baixo em um layout de disposição. (Herdado de Layout) |
| GetAnimationBaseValue(DependencyProperty) |
Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria em casos em que uma animação não está ativa. (Herdado de DependencyObject) |
| GetValue(DependencyProperty) |
Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject) |
| InitializeForContext(LayoutContext) |
Inicializa qualquer estado por contêiner que o layout requer quando ele é anexado a um contêiner UIElement. (Herdado de Layout) |
| InitializeForContextCore(VirtualizingLayoutContext) |
Quando substituído em uma classe derivada, inicializa qualquer estado por contêiner que o layout requer quando é anexado a um contêiner UIElement. (Herdado de VirtualizingLayout) |
| InvalidateArrange() |
Invalida o estado de organização (layout) para todos os contêineres UIElement que fazem referência a esse layout. Após a invalidação, o UIElement terá seu layout atualizado, o que ocorre de forma assíncrona. (Herdado de Layout) |
| InvalidateMeasure() |
Invalida o estado de medida (layout) para todos os contêineres UIElement que fazem referência a esse layout. (Herdado de Layout) |
| Measure(LayoutContext, Size) |
Sugere um DesiredSize para um elemento de contêiner. Um elemento de contêiner que dá suporte a layouts anexados deve chamar esse método de suas próprias implementações measureOverride para formar uma atualização de layout recursivo. Espera-se que o layout anexado chame a Medida para cada um dos filhos UIElement do contêiner. (Herdado de Layout) |
| MeasureOverride(VirtualizingLayoutContext, Size) |
Fornece o comportamento da passagem "Medida" do ciclo de layout. As classes podem substituir esse método para definir seu próprio comportamento de aprovação "Medida". (Herdado de VirtualizingLayout) |
| OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs) |
Notifica o layout quando a coleta de dados atribuída ao elemento de contêiner (ItemsSource) é alterada. (Herdado de VirtualizingLayout) |
| ReadLocalValue(DependencyProperty) |
Retorna o valor local de uma propriedade de dependência, se um valor local for definido. (Herdado de DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registra uma função de notificação para escutar alterações em um DependencyProperty específico nesta instância dependencyObject . (Herdado de DependencyObject) |
| SetIndexBasedLayoutOrientation(IndexBasedLayoutOrientation) |
Define o valor da |
| SetValue(DependencyProperty, Object) |
Define o valor local de uma propriedade de dependência em um DependencyObject. (Herdado de DependencyObject) |
| UninitializeForContext(LayoutContext) |
Remove qualquer estado que o layout armazenado anteriormente no contêiner UIElement. (Herdado de Layout) |
| UninitializeForContextCore(VirtualizingLayoutContext) |
Quando substituído em uma classe derivada, remove qualquer estado do layout armazenado anteriormente no contêiner UIElement. (Herdado de VirtualizingLayout) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback. (Herdado de DependencyObject) |
Eventos
| Nome | Description |
|---|---|
| ArrangeInvalidated |
Ocorre quando o estado de organização (layout) foi invalidado. (Herdado de Layout) |
| MeasureInvalidated |
Ocorre quando o estado de medida (layout) foi invalidado. (Herdado de Layout) |