語言

LinedFlowLayout 類別

定義

表示控件,這個控件會依序從左至右、從上到下、在換行配置中,使用所有元素的相同高度來放置元素。

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LinedFlowLayout : VirtualizingLayout
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class LinedFlowLayout : VirtualizingLayout
Public Class LinedFlowLayout
Inherits VirtualizingLayout
繼承
Object IInspectable DependencyObject Layout VirtualizingLayout LinedFlowLayout
屬性
Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

備註

LinedFlowLayout 在換行版面配置中以從左到右、然後從上到下的順序放置元素。 使用此版面配置可顯示項目集合,其中項目的高度固定,但寬度可變。 建議將其用於以影像為基礎的集合。 此版面配置還具有內建動畫,當物件集合新增或移除項目以及調整檢視大小時,會播放相應的動畫。

要使用 LinedFlowLayout,請將其設為 ItemsView.Layout 或 ItemsRepeater.Layout 屬性的值。

這裡有一個 ItemsView 控制項,可以顯示一組照片以有線條流程排版呈現。

<ItemsView Width="500" Height="400" HorizontalAlignment="Left"
           ItemTemplate="{StaticResource LinedFlowLayoutItemTemplate}">
    <ItemsView.Layout>
        <LinedFlowLayout ItemsStretch="Fill" 
                         LineHeight="160" 
                         LineSpacing="5"
                         MinItemSpacing="5"/>
    </ItemsView.Layout>
</ItemsView>

在線性流佈局中顯示的相片集合,其中每張圖片的高度相同,但寬度會根據相片長寬比的原始大小而有所不同。

LinedFlowLayout 提供了屬性來控制:

建構函式

名稱 Description
LinedFlowLayout()

初始化 LinedFlowLayout 類別的新實例。

屬性

名稱 Description
ActualLineHeight

這會讓線路的有效固定高度。

ActualLineHeightProperty

識別 ActualLineHeight 依賴屬性。

Dispatcher

它總是在 Windows 應用程式 SDK 應用程式中回傳 null 。 改用 DispatcherQueue 。

(繼承來源 DependencyObject)
DispatcherQueue

得到 DispatcherQueue 這個物件所關聯的那個。 代表 DispatcherQueue 一個功能,即使程式碼是由非 UI 執行緒發起,也能存取 UI DependencyObject 執行緒。

(繼承來源 DependencyObject)
IndexBasedLayoutOrientation

取得根據來源集合中項目索引排列的方向(若有的話)。

(繼承來源 Layout)
ItemsJustification

取得或設定一個值,表示物品在水平軸上的排列方式。

ItemsJustificationProperty

識別 ItemsJustification 依賴屬性。

ItemsStretch

取得或設定一個數值,表示物品如何填滿可用空間的大小。

ItemsStretchProperty

識別 ItemsStretch 相依屬性。

LineHeight

設定線條高度固定。

LineHeightProperty

識別 LineHeight 依賴屬性。

LineSpacing

取得或設定物品之間的垂直空間。

LineSpacingProperty

識別 LineSpacing 依賴性屬性。

MinItemSpacing

在水平軸上取得或設定物品間最小間距。

MinItemSpacingProperty

識別 MinItemSpacing 依賴屬性。

RequestedRangeLength

透過 ItemsInfoRequested 事件,取得目前使用尺寸資訊的物品數量。

RequestedRangeStartIndex

透過 ItemsInfoRequested 事件提供的尺寸資訊,取得目前使用尺寸資訊的最小項目索引。 值為 -1 表示未使用該 的 ItemsInfoRequested 尺寸資訊。

方法

名稱 Description
Arrange(LayoutContext, Size)

定位子元素並決定容器 UIElement 的大小。 支援附加版面配置的容器元素,應從其版面覆寫實作中呼叫此方法,形成遞迴版面版面更新。

(繼承來源 Layout)
ArrangeOverride(VirtualizingLayoutContext, Size)

當在衍生類別中實作時,會提供佈局中「排列」通道的行為。 類別可以覆寫此方法,定義自己的「排列」傳遞行為。

(繼承來源 VirtualizingLayout)
ClearValue(DependencyProperty)

清除依賴性財產的局部價值。

(繼承來源 DependencyObject)
CreateDefaultItemTransitionProvider()

表示控件,這個控件會依序從左至右、從上到下、在換行配置中,使用所有元素的相同高度來放置元素。

(繼承來源 Layout)
GetAnimationBaseValue(DependencyProperty)

回傳任何為相依屬性建立的基礎值,適用於動畫未啟用時。

(繼承來源 DependencyObject)
GetValue(DependencyProperty)

回傳 DependencyObject 中相依屬性的當前有效值。

(繼承來源 DependencyObject)
InitializeForContext(LayoutContext)

當配置連接到 UIElement 容器時,初始化所需的任何容器狀態。

(繼承來源 Layout)
InitializeForContextCore(VirtualizingLayoutContext)

當在衍生類別中覆寫時,會初始化該配置在連接 UIElement 容器時所需的任何容器狀態。

(繼承來源 VirtualizingLayout)
InvalidateArrange()

使所有參考此佈局的 UIElement 容器的 arrange 狀態(layout)失效。 失效後,UIElement 的版面會進行非同步更新。

(繼承來源 Layout)
InvalidateItemsInfo()

會讓它 LinedFlowLayout 對其物品進行重排。

InvalidateMeasure()

使所有參考此佈局的 UIElement 容器的測量狀態(佈局)失效。

(繼承來源 Layout)
LockItemToLine(Int32)

取得該項目所屬行的索引,該項目的索引為所提供。 該物品會保證會出現在退回的行中,直到 ItemsUnlocked 事件觸發。

Measure(LayoutContext, Size)

建議容器元素使用 DesiredSize。 支援附加版面配置的容器元素應從其自身的 MeasureOverride 實作中呼叫此方法,形成遞迴版面更新。 附帶的佈局預期會為容器中的每個 UIElement 子節點呼叫 Measure。

(繼承來源 Layout)
MeasureOverride(VirtualizingLayoutContext, Size)

提供佈局週期中「測量」通道的行為。 類別可以覆寫此方法,定義自己的「Measure」通過行為。

(繼承來源 VirtualizingLayout)
OnItemsChangedCore(VirtualizingLayoutContext, Object, NotifyCollectionChangedEventArgs)

當分配給容器元素(ItemsSource)的資料集合變更時,會通知該版面配置。

(繼承來源 VirtualizingLayout)
ReadLocalValue(DependencyProperty)

若設定了本地值,則回傳依賴性質的局部值。

(繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

註冊一個通知函式,用於監聽此 DependencyObject 實例中特定 DependencyProperty 的變更。

(繼承來源 DependencyObject)
SetIndexBasedLayoutOrientation(IndexBasedLayoutOrientation)

設定房產價值 IndexBasedLayoutOrientation 。

(繼承來源 Layout)
SetValue(DependencyProperty, Object)

將相依屬性的局部值設定在 DependencyObject 上。

(繼承來源 DependencyObject)
UninitializeForContext(LayoutContext)

移除 UIElement 容器中先前儲存的 layout 狀態。

(繼承來源 Layout)
UninitializeForContextCore(VirtualizingLayoutContext)

當在衍生類別中覆寫時,會移除 layout 先前儲存在 UIElement 容器中的任何狀態。

(繼承來源 VirtualizingLayout)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

取消先前透過呼叫 RegisterPropertyChangedCallback 註冊的變更通知。

(繼承來源 DependencyObject)

事件

名稱 Description
ArrangeInvalidated

當排列狀態(佈局)被失效時發生。

(繼承來源 Layout)
ItemsInfoRequested

當需要 LinedFlowLayout 當前滾動視窗內外物品的尺寸資訊時,會發生這種情況。

ItemsUnlocked

當透過呼叫 LockItemToLine 方法被鎖定在特定線路的項目再次解鎖時,會發生這種情況。

MeasureInvalidated

當測量狀態(佈局)失效時,會發生這種情況。

(繼承來源 Layout)

適用於

另請參閱