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

Posted on by

什麼是區域(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用法的文章就介紹到這瞭。希望對大傢的學習有所幫助，也希望大傢多多支持WalkonNet。

推薦閱讀：