WPF應用開發之控制項動態內容展示

在我們開發一些複雜信息的時候，由於需要動態展示一些相關信息，因此我們需要考慮一些控制項內容的動態展示，可以通過動態構建控制項的方式進行顯示，如動態選項卡展示不同的信息，或者動態展示一個自定義控制項的內容等等，目的就是能夠減少一些硬編碼的處理方式，以及能夠靈活的展示數據。本篇隨筆通過實際案例介紹WPF應用開... ...

在我們開發一些複雜信息的時候，由於需要動態展示一些相關信息，因此我們需要考慮一些控制項內容的動態展示，可以通過動態構建控制項的方式進行顯示，如動態選項卡展示不同的信息，或者動態展示一個自定義控制項的內容等等，目的就是能夠減少一些硬編碼的處理方式，以及能夠靈活的展示數據。本篇隨筆通過實際案例介紹WPF應用開發之控制項動態內容展示。

1、選項卡TabControl的動態內容展示

在我們客戶關係管理模塊中，往往需要展示一個客戶相關的很多數據，我們可以把它們放在多個選項卡中進行統一展示，如下界面所示。

由於客戶的相關模塊信息比較多，因此我們通過選項卡的展示是比較合理的一種界面組織方式，這裡由於不同的客戶信息，他們展示的內容不同（但結構相同），因此可以考慮動態的刷新選項卡項目TabItem的內容數據進行。

因此我們這裡引入一個自定義的控制項AllRelatedListControl，用來承載所有需要展示的模塊一個組合。

因此在主頁面上，我們可以通過一個Divider分隔控制項隔開，展示客戶相關的數據，如下XAML 代碼所示。

<hc:Divider
    Margin="0"
    LineStroke="{DynamicResource DarkPrimaryBrush}"
    LineStrokeThickness="2" />
<Grid Margin="0,5,0,0" Background="{DynamicResource BackgroundBrush}">
    <!--  客戶相關數據  -->
    <local:AllRelatedListControl x:Name="allRelatedList" CustomerId="{Binding SelectedItem.Id, ElementName=grid}" />
</Grid>

這個自定義的控制項，主要的作用是組合多個選項卡項目，減少主界面的代碼，並增加一些共同的屬性和方法來控制數據的更新顯示的。

<UserControl
    x:Class="WHC.SugarProject.CRM.WpfUI.Views.Pages.AllRelatedListControl"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:local="clr-namespace:WHC.SugarProject.CRM.WpfUI.Views.Pages"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    x:Name="allList"
    d:DesignHeight="450"
    d:DesignWidth="800"
    Background="{DynamicResource RegionBrush}"
    mc:Ignorable="d">
    <Grid>
        <!--  客戶相關數據  -->
        <TabControl
            x:Name="tabControl"
            Height="auto"
            HorizontalAlignment="Left"
            HorizontalContentAlignment="Left"
            Background="LightCyan"
            Style="{StaticResource TabControlCapsuleSolid}"
            TabStripPlacement="Top">
            <TabItem Header="客戶跟進" Tag="FollowControl">
                <local:FollowListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>
            <TabItem Header="聯繫人資料" Tag="ContactControl">
                <local:ContactListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>
            <TabItem Header="客戶拜訪" Tag="VisitControl">
                <local:VisitListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>
            <TabItem Header="銷售機會" Tag="ChanceControl">
                <local:ChanceListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>
            <TabItem Header="客戶文檔" Tag="FileDataControl">
                <local:FileDataListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>
            <TabItem Header="合同文檔" Tag="ContractControl">
                <local:ContractListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>
            <TabItem Header="產品報價" Tag="QuotationControl">
                <local:QuotationListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>
            <TabItem Header="客戶來電" Tag="ComingCallControl">
                <local:ComingCallListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>
            <TabItem Header="發票記錄" Tag="InvoiceControl">
                <local:InvoiceListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>
            <TabItem Header="維護記錄" Tag="SupplierControl">
                <local:MaintenaceListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>
            <TabItem Header="售後服務" Tag="MaintenaceControl">
                <local:AfterSellListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>
            <TabItem Header="客戶投訴" Tag="ComplaintControl">
                <local:ComplaintListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>
            <TabItem Header="客戶活動" Tag="ActivityControl">
                <local:ActivityListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>

            <TabItem Header="收貨地址" Tag="">
                <local:ShippingListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
            </TabItem>
        </TabControl>
    </Grid>
</UserControl>

上面的用戶控制項的界面效果如下所示，它的作用就是組合多個不同的頁面。

和其他自定義控制項一樣，我們增加一些自定義的屬性，如這裡是客戶的ID，用於賦值後刷新相關的數據的。

        /// <summary>
        /// 客戶ID
        /// </summary>
        public string? CustomerId
        {
            get { return (string?)GetValue(CustomerIdProperty); }
            set { SetValue(CustomerIdProperty, value); }
        }

        public static readonly DependencyProperty CustomerIdProperty = DependencyProperty.Register(
            nameof(CustomerId), typeof(string), typeof(AllRelatedListControl),
            new FrameworkPropertyMetadata("-1", FrameworkPropertyMetadataOptions.BindsTwoWayByDefault, new PropertyChangedCallback(OnCustomerIdPropertyChanged)));


        private static async void OnCustomerIdPropertyChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
        {
            if (d is not AllRelatedListControl control)
                return;

            if (control != null)
            {
                var oldValue = (string?)e.OldValue;  // 舊的值
                var newValue = (string?)e.NewValue; // 更新的新的值

                //更新數據源
                await control.InitData(newValue);
            }
        }

而我們每個子控制項裡面，其實也是已經根據父控制項的客戶ID進行了綁定屬性了，如下所示。

<TabItem Header="客戶跟進" Tag="FollowControl">
    <local:FollowListControl CustomerId="{Binding CustomerId, ElementName=allList}" />
</TabItem>

如果我們要根據資料庫的配置信息，用來判斷哪個選項卡顯示或者隱藏，那麼可以進一步進行處理每個TabItem的Visibility即可

//判斷是否顯示
foreach (TabItem item in this.tabControl.Items)
{
    if (!item.Tag.IsEmpty())
    {
        item.Visibility = CustomerTabItems.Contains(item.Tag.ToString()!) ? Visibility.Visible : Visibility.Collapsed;
    }
}

在DataGrid的滑鼠鍵按下左鍵的時候，我們刷新對應自定義控制項的屬性CustomerId，就可以刷新相關的客戶數據了。

    /// <summary>
    /// 選中每個客戶記錄的時候，觸發更新客戶相關信息
    /// </summary>
    private async void grid_MouseLeftButtonUp(object sender, System.Windows.Input.MouseButtonEventArgs e)
    {
        if (this.grid.SelectedItem is CustomerInfo selectItem)
        {
            allRelatedList.CustomerId = selectItem.Id;
            await allRelatedList.InitData(selectItem.Id);
        }
    }

以上就是對於複雜的客戶信息內容，使用選項卡動態組合的方式，實現內容的動態展示處理操作。

2、動態自定義表單內容的展示

有時候，我們在工作流表單中，需要展示一些固定的申請單信息，以及根據不同流程的表單數據（結構也不同）進行展示，如工作流中，不同的表單數據結構是不同的。

明細展示效果如下所示。

或者

可以看出不同的流程類型表單，它們的表單結構是不同的，如果我們在一個固定的頁面裡面展示數據，那麼這塊表單的數據展示，就需要用到動態控制項的展示方式。

我們採用Grid佈局排版方式，grid.row=0為固定表單（這裡不再贅述），grid.row=1為動態表單內容，如下所示。

<StackPanel Grid.Row="1" Margin="0,20,0,0">
    <TextBlock
        HorizontalAlignment="Center"
        Style="{StaticResource TextBlockSubTitleBold}"
        Text="表單信息" />
    <Frame x:Name="formContent" />
</StackPanel>

其中裡面<Frame x:Name="formContent" /> 就是我們根據實際表單的內容進行動態展示的地方。

/// <summary>
/// 該事件在loaded之後執行，也是在所有元素渲染結束之後執行
/// </summary>
/// <param name="e"></param>
protected override async void OnContentRendered(EventArgs e)
{
    base.OnContentRendered(e);

    //動態構建表單內容展示 formContent
    var formId = this.ViewModel.Item.FormId;
    if(!formId.IsNullOrEmpty())
    {
        var formInfo = await BLLFactory<IFormService>.Instance.GetAsync(formId);
        if(formInfo != null && !formInfo.ApplyWpfview.IsNullOrEmpty())
        {
            var control = ReflectionUtil.CreateInstance(formInfo.ApplyWpfview);
            var data = control as IApplyInit;
            if(data != null)
            {
                await data.InitData(this.ViewModel.Item.Id);
            }
            formContent.Content = control;
        }
    }

    //初始化工具欄
    await InitToolBar();
}

我們根據表單ID獲取對應的formInfo.ApplyWpfview 屬性配置，他就是一個具體的控制項的名稱路徑，因此我們根據這個來進行反射構建一個實例，並把它轉換為 IApplyInit 的介面實例，進行調用控制項初始化即可。

生成的控制項當做Frame控制項的Content，從而實現動態內容的展示了。

我們以第一個表單【故障維修】的自定義控制項定義來看看

public partial class MaintenanceViewControl : INavigableView<MaintenanceEditViewModel>, IApplyInit

它實現了 IApplyInit 介面，因此我們可以在動態控制項的時候，把它轉換為介面實例進行調用，這也是我們約束動態控制項實例的一個規則。

不同的控制項，他們的數據模型肯定不同，因此由它們自己本身實現具體的獲取數據即可。

/// <summary>
/// 初始化相關業務表單數據
/// </summary>
/// <param name="applyId">申請單Id</param>
/// <returns></returns>
public async Task InitData(string applyId)
{
    this.ViewModel.Item = await BLLFactory<IMaintenanceService>.Instance.FindByApplyId(applyId);
    this.ViewModel.NotifyChanged();
}

這樣我們自定義控制項的XAML就可以順利綁定對應的數據展示了，這些控制項的內容，可以根據資料庫介面，使用我們的代碼生成工具進行快速生成，然後進行一定的裁剪調整即可，不必要一個個來編寫代碼。

<StackPanel hc:TitleElement.TitleWidth="100">
    <hc:Row>
        <hc:Col Span="12">
            <TextBox
                x:Name="txtDeviceName"
                Margin="5"
                hc:TitleElement.Title="故障設備名稱"
                hc:TitleElement.TitlePlacement="Left"
                IsReadOnly="True"
                Text="{Binding ViewModel.Item.DeviceName}" />
        </hc:Col>
        <hc:Col Span="12">
            <DatePicker
                x:Name="txtRepairDate"
                Margin="5"
                hc:InfoElement.Title="報修日期"
                hc:InfoElement.TitlePlacement="Left"
                IsEnabled="False"
                SelectedDate="{Binding ViewModel.Item.RepairDate, StringFormat='yyyy-MM-dd'}"
                Style="{StaticResource DatePickerExtend}" />

        </hc:Col>
    </hc:Row>
    <hc:Row>
        <hc:Col>
            <TextBox
                x:Name="txtFaultDescription"
                Margin="5"
                hc:TitleElement.Title="故障描述"
                hc:TitleElement.TitlePlacement="Left"
                IsReadOnly="True"
                Text="{Binding ViewModel.Item.FaultDescription}" />
        </hc:Col>
    </hc:Row>
    <hc:Row>
        <hc:Col Span="12">
            <TextBox
                x:Name="txtRepairFee"
                Margin="5"
                hc:TitleElement.Title="預計維修費用"
                hc:TitleElement.TitlePlacement="Left"
                IsReadOnly="True"
                Text="{Binding ViewModel.Item.RepairFee}" />
        </hc:Col>
        <hc:Col Span="12" />
    </hc:Row>

    <hc:Row>
        <hc:Col Span="24">
            <TextBox
                x:Name="txtNote"
                Height="50"
                Margin="5"
                VerticalAlignment="Top"
                VerticalContentAlignment="Top"
                hc:TitleElement.Title="備註信息"
                hc:TitleElement.TitlePlacement="Left"
                AcceptsReturn="True"
                IsReadOnly="True"
                Text="{Binding ViewModel.Item.Note}" />
        </hc:Col>
    </hc:Row>
    <hc:Row>
        <hc:Col>
            <control:AttachmentControl AttachmentGUID="{Binding ViewModel.Item.AttachGUID}" Text="相關附件" />
        </hc:Col>
    </hc:Row>
</StackPanel>

可以看到這部分的代碼，和我們生成的編輯界面的內容是相似的，只是進行了適量的裁剪處理，以及增加一些自定義控制項，統一界面效果（如附件控制項的展示）。

以上就是兩種不同方式，動態構建不同的內容展示的處理，動態內容可以帶來很好的處理便利，不過也不要濫用，比較反射太多還是會犧牲一些UI的性能，不過總體來說肯定是值得的，而且這也是一種UI的處理模式。

專註於代碼生成工具、.Net/.NetCore 框架架構及軟體開發，以及各種Vue.js的前端技術應用。著有Winform開發框架/混合式開發框架、微信開發框架、Bootstrap開發框架、ABP開發框架、SqlSugar開發框架等框架產品。
轉載請註明出處：撰寫人：伍華聰 http://www.iqidi.com