什么是區域(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當中, 注冊我們創建好的自定義適配器，如下所示。