WPF Prism框架合集(3.Region)

本文轉載自查看原文 2020-12-04 16:59 3017 Prism合集

視頻教程地址

上一章回顧

WPF中集成Prism
Prism初始化過程
如何創建Shell
安裝VisualStudio Template Pack
這一章, 我們將講解如何在我們的頁面當中定義區域,並且使用它。

什么是區域(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接口, 這里我們可以創建基於一下三種類型的區域類型。