UniformGridLayout Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Позиции элементов последовательно слева направо или сверху вниз в макете упаковки.
Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен).
/// [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- Наследование
- Атрибуты
-
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContractVersionAttribute
Примеры
Совет
Дополнительные сведения, рекомендации по проектированию и примеры кода см. в разделе 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).
В следующем примере показано, как задать для свойства ItemsRepeater.Layout значение UniformGridLayout.
<!--
xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
-->
...
<muxc:ItemsRepeater ItemsSource="{x:Bind Items}"
ItemTemplate="{StaticResource MyTemplate}">
<muxc:ItemsRepeater.Layout>
<muxc:UniformGridLayout MinItemWidth="200"
MinColumnSpacing="28"
ItemsJustification="SpaceAround"/>
</muxc:ItemsRepeater.Layout>
</muxc:ItemsRepeater>
Комментарии
Элементы выкладываются в порядке слева направо, если ориентация находится Horizontal, и размещается сверху вниз, если ориентация имеет значение Vertical.
Каждый элемент в UniformGridLayout имеет одинаковый размер.
UniformGridLayout поддерживает виртуализацию при присоединении к узлу, поддерживающем виртуализацию.
Конструкторы
| UniformGridLayout() |
Инициализирует новый экземпляр класса UniformGridLayout . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
Свойства
| ItemsJustification |
Возвращает или задает значение, указывающее, как элементы выравниваются по оси, отличной от прокрутки или не виртуализации. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| ItemsJustificationProperty |
Определяет свойство зависимостей ItemsJustification . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| ItemsStretch |
Возвращает или задает значение, показывающее размер элементов для заполнения доступного пространства. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| ItemsStretchProperty |
Определяет свойство зависимостей ItemsStretch . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| MaximumRowsOrColumns |
Возвращает или задает максимальное количество элементов, отображаемых для каждой строки или столбца, на основе ориентации UniformGridLayout. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| MaximumRowsOrColumnsProperty |
Определяет свойство зависимостей MaximumRowsOrColumns . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| MinColumnSpacing |
Возвращает или задает минимальное пространство между элементами на горизонтальной оси. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| MinColumnSpacingProperty |
Определяет свойство зависимостей MinColumnSpacing . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| MinItemHeight |
Возвращает или задает минимальную высоту каждого элемента. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| MinItemHeightProperty |
Определяет свойство зависимостей MinItemHeight . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| MinItemWidth |
Возвращает или задает минимальную ширину каждого элемента. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| MinItemWidthProperty |
Определяет свойство зависимостей MinItemWidth . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| MinRowSpacing |
Возвращает или задает минимальное пространство между элементами на вертикальной оси. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| MinRowSpacingProperty |
Определяет свойство зависимостей MinRowSpacing . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| Orientation |
Получает или задает ось, по которой размещаются элементы. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
| OrientationProperty |
Определяет свойство зависимости Orientation . Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). |
Методы
| Arrange(LayoutContext, Size) |
Позиционирует дочерние элементы и определяет размер контейнера UIElement. Элементы контейнера, поддерживающие присоединенные макеты, должны вызывать этот метод из их реализаций переопределения макета для формирования рекурсивного обновления макета. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). (Унаследовано от Layout) |
| ArrangeOverride(VirtualizingLayoutContext, Size) |
При реализации в производном классе обеспечивает поведение для прохода "Упорядочить" макета. Классы могут переопределить этот метод, чтобы определить собственное поведение передачи Arrange. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). (Унаследовано от VirtualizingLayout) |
| InitializeForContext(LayoutContext) |
Инициализирует любое состояние каждого контейнера, необходимое для макета при присоединении к контейнеру UIElement. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). (Унаследовано от Layout) |
| InitializeForContextCore(VirtualizingLayoutContext) |
При переопределении в производном классе инициализирует любое состояние каждого контейнера, необходимое при присоединении к контейнеру UIElement. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). (Унаследовано от VirtualizingLayout) |
| InvalidateArrange() |
Делает недействительным состояние упорядочения (макет) для всех контейнеров UIElement, ссылающихся на этот макет. После недействительности uiElement обновится его макет, который происходит асинхронно. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). (Унаследовано от Layout) |
| InvalidateMeasure() |
Делает недействительным состояние измерения (макет) для всех контейнеров UIElement, ссылающихся на этот макет. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). (Унаследовано от Layout) |
| Measure(LayoutContext, Size) |
Предлагает DesiredSize для элемента контейнера. Элемент контейнера, поддерживающий присоединенные макеты, должен вызывать этот метод из собственных реализаций MeasureOverride для формирования рекурсивного обновления макета. Ожидается, что присоединенный макет вызовет Measure для каждого дочернего элемента пользовательского интерфейса контейнера. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). (Унаследовано от Layout) |
| MeasureOverride(VirtualizingLayoutContext, Size) |
Предоставляет поведение для прохода "Measure" цикла макета. Классы могут переопределить этот метод, чтобы определить собственное поведение передачи Measure. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). (Унаследовано от VirtualizingLayout) |
| OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs) |
Уведомляет макет о том, когда коллекция данных, назначенная элементу контейнера (ItemsSource), изменилась. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). (Унаследовано от VirtualizingLayout) |
| UninitializeForContext(LayoutContext) |
Удаляет любое состояние макета, ранее хранящегося в контейнере UIElement. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). (Унаследовано от Layout) |
| UninitializeForContextCore(VirtualizingLayoutContext) |
При переопределении в производном классе удаляет любое состояние макета, ранее хранящегося в контейнере UIElement. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). (Унаследовано от VirtualizingLayout) |
События
| ArrangeInvalidated |
Происходит, когда состояние упорядочения (макет) было признано недействительным. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). (Унаследовано от Layout) |
| MeasureInvalidated |
Происходит, когда состояние измерения (макет) было признано недействительным. Эта документация относится к WinUI 2 для UWP (для WinUI в Windows App SDK см. Windows App SDK пространства имен). (Унаследовано от Layout) |
Применяется к
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по