首頁 > 軟體

WPF框架Prism中區域Region用法介紹

2022-02-10 13:00:12

什麼是區域(Region)?

在理解這個之前, 首先需要了解一下, 在最常見的開發模式當中, 我們去設計某個頁面的時候, 實際上介面元素在設計的時候已經被固定。

舉個簡單的例子,當我們去設計如下頁面, 它包含Header、Menu、Content內容。

因此我們可以為這個頁面設計一些元素, 例如:

1.Menu 可以放置ListBox

2.Content 可以放置一個ContentControl

3.Header 可以放置一些ToolBar

注:為了演示需要, 對應區域的控制元件均採用TextBlock演示, 實際開發中, 往往我們會採用的各類控制元件。

<Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="auto" />
            <RowDefinition />
        </Grid.RowDefinitions>

        <Grid.ColumnDefinitions>
            <ColumnDefinition Width="auto" />
            <ColumnDefinition />
        </Grid.ColumnDefinitions>

        <Border Grid.ColumnSpan="2" Background="#0063B1">
            <TextBlock  Padding="10"  FontSize="30" Text="Header" />
        </Border>

        <Border Grid.Row="1" Background="#F08B6A">
            <TextBlock Padding="10" FontSize="30" Text="Menu" />
        </Border>

        <Border  Grid.Row="1" Grid.Column="1" Background="#948CC0">
            <TextBlock Padding="10" FontSize="30" Text="Content" />
        </Border>
    </Grid>

那麼, 回到Region主題, 在Prism當中, 一個頁面我們可以不再為其固定顯示的內容, 而這種概念變成了區域(Region)劃分的概念。

將頁面顯示的區域劃分稱N個Region, 此時, 每個Region將變成了動態分配區域。它將負責承擔我們的UI元件或者控制元件。

定義Region

可以使用XAML或程式碼建立定義Region

RegionManager.RegionName（XAML）
RegionManager.SetRegionName（Code）

RegionManager功能

維護區域集合
提供對區域的存取
合成檢視
區域導航
定義區域

定義Region步驟

Region 範例

當我們為介面的元素指定了區域名稱(XAML或者程式碼的方式), 下一步則是通過IRegionManager介面範例設定對應的區域顯示內容。

在該範例當中, 我們建立了3個模組, 然後註冊在當前的頁面當中, 分別為Header、Menu、Content。如下所示:

執行之後, 介面將顯示具有3個模組組成的頁面, 如下所示:

注意事項

細心的網友可能已經看到了, 上面的程式碼中, 為3個ContentControl註冊了對應的區域, 然後顯示3個自定義的控制元件。

那麼, 是不是同樣可以在其它控制元件元素上註冊Region?

是的, 在Prism中, 控制元件都支援註冊Region, 只是有些控制元件需要自己實現一個RegionAdapters(區域介面卡)

什麼是RegionAdapters?

假設在應用程式的某個區域, 需要顯示我們定義的檢視,這個時候實際上利用了RegionAdapter。

該類負責將傳入我們定義的檢視到指定的Region當中。

Prism提供了許多內建得RegionAdapter

ContentControlRegionAdapter

ItemsControlRegionAdapter

SelectorRegionAdapter

- ComboBox
- ListBox
- Ribbon
- TabControl

注:除此之外, 如果想要實現控制元件作用域Region, 則必須建立自己的自定義Region, 因為一旦你不這麼做, 則會引發異常。

建立Custom RegionAdapter

首先, 我們在這裡建立一個類, 然後繼承於RegionAdapterBase, 下面我們建立了一個基於StackPanel的自定義介面卡。

下面, 我們需要重寫其中的CreateRegion方法。

CreateRegion方法返回一個IRegion介面, 這裡我們可以建立基於一下三種型別的區域型別。

SingleActiveRegion
AllActiveRegion
Region

然後,還需要重寫其中的Adapt方法。

最後一步, 我們需要在PrismApplication當中, 註冊我們建立好的自定義介面卡，如下所示。

到此這篇關於WPF框架Prism中區域Region用法的文章就介紹到這了。希望對大家的學習有所幫助，也希望大家多多支援it145.com。

IT145.com E-mail:sddin#qq.com