WPF依賴屬性的正確學習方法

来源:https://www.cnblogs.com/kiba/archive/2019/07/24/11149147.html
-Advertisement-
Play Games

前言 我在學習WPF的早期,對依賴屬性理解一直都非常的不到位,其惡果就是,我每次在寫依賴屬性的時候,需要翻過去的代碼來複制黏貼。 相信很多朋友有著和我相同的經歷,所以這篇文章希望能幫助到那些剛剛開始學依賴屬性的朋友。 那些[討厭]的依賴屬性的講解文章 初學者肯定會面臨一件事,就是百度,谷歌,或者MS ...


前言

我在學習WPF的早期,對依賴屬性理解一直都非常的不到位,其惡果就是,我每次在寫依賴屬性的時候,需要翻過去的代碼來複制黏貼。

相信很多朋友有著和我相同的經歷,所以這篇文章希望能幫助到那些剛剛開始學依賴屬性的朋友。

那些[討厭]的依賴屬性的講解文章

初學者肯定會面臨一件事,就是百度,谷歌,或者MSDN來查看依賴屬性的定義和使用,而這些文章雖然都寫的很好,但,那是相對於已經學會使用依賴屬性的朋友而言。

而對於初學者而言,說是誤導都不過分。

比如,官網的這篇文章https://docs.microsoft.com/zh-cn/dotnet/framework/wpf/advanced/dependency-properties-overview

介紹依賴屬性是這樣。

public static readonly DependencyProperty IsSpinningProperty =
    DependencyProperty.Register(
    "IsSpinning", typeof(Boolean),
    typeof(MyCode)
    );
public bool IsSpinning
{
    get { return (bool)GetValue(IsSpinningProperty); }
    set { SetValue(IsSpinningProperty, value); }
}

他做了一個定義,然後告訴你,依賴屬性的定義格式如此。

如果你是個初學者,你想不疑惑都很難。因為沒人能把這種定義給背下來。

其結果就是,你要和我當初一樣,每次定義依賴屬性,都要去複製黏貼。但這並不是最大的惡果,最大的惡果是,因為太過複雜的定義,讓你放棄了對他理解,就記住了依賴屬性要複製黏貼,從而導致了,你喪失了對依賴屬性靈活運用的能力。

正確的理解依賴屬性

如何正確的理解依賴屬性呢?

很簡單,拆分一下就可以理解了。

現在我們來拆分依賴屬性,首先拆分他的定義,將依賴和屬性拆分。

我們先看屬性,如下,我們定義了一個屬性。

private bool _IsSpinning;
public bool IsSpinning
{
    get { return _IsSpinning; }
    set { _IsSpinning = value; }
}

然後我們使用DependencyProperty類定義一個對象,這個對象將作為IsSpinning屬性的依賴,如下:

public static readonly DependencyProperty IsSpinningProperty

然後,我們在將這個依賴對象,註冊到屬性IsSpinning的所在類上,如下:

DependencyProperty.Register( "IsSpinning", typeof(bool),  typeof(你的屬性所在的類的名稱));

從註冊代碼中,我們可以看到,他註冊了三個信息:

1,當前DependencyProperty類定義的對象IsSpinningProperty,依賴於屬性IsSpinning。

2,對象IsSpinningProperty的依賴類型與屬性IsSpinning的類型一樣都是bool。

3,對象IsSpinningProperty註冊的類是聲明屬性IsSpinning的類,即,在其他類里,將看不到該依賴對象。

現在,我們做最後的操作,修改屬性,將依賴對象IsSpinningProperty與屬性IsSpinning綁定。

如何綁定呢?很簡單,將我們屬性定義里的【private bool _IsSpinning】替換為我們剛剛定義的依賴【IsSpinningProperty】即可。

public bool IsSpinning
{
    get { return (bool)GetValue(IsSpinningProperty); }
    set { SetValue(IsSpinningProperty, value); }
}

這裡我們看到了,在給屬性賦值和取值時,用到了GetValue和SetValue,他們倆是哪來的呢?

使用F12,我們跟蹤進去,發現它們是類DependencyProperty里定義的方法,那麼為什麼我們在窗體里也可以用呢?

很簡單,我們跟進一下Window的父類,發現最後的父類Visual繼承了DependencyProperty,所以我們可以直接使用GetValue和SetValue來賦值和獲取依賴對象的值。也就是只要是繼承了類DependencyProperty的子類,都可以使用依賴屬性。

完整版依賴屬性定義代碼:

public static readonly DependencyProperty IsSpinningProperty =
DependencyProperty.Register("IsSpinning", typeof(bool), typeof(DependecyUserControl));
public bool IsSpinning
{
    get { return (bool)GetValue(IsSpinningProperty); }
    set { SetValue(IsSpinningProperty, value); }
}

到這裡,依賴屬性的拆分就完事了,現在,大家應該很清楚依賴屬性到底是什麼了吧。

現在你已經理解這些依賴屬性的概念了,只要熟練一點點,實現手敲依賴屬性已經不是夢了。 

PS:有沒有人曾經告訴你,依賴屬性的命名必須是 屬性名+Property,然後你還信以為真了。哈哈。

依賴屬性的簡單應用

現在讓我們來自定義一個帶依賴屬性的系統控制項來加深記憶。

public class KButton : Button 
{
    public static readonly DependencyProperty ForeImageProperty;
    public static readonly DependencyProperty BackImageProperty;
    public static readonly DependencyProperty MouseOverBackColorProperty;
    public static readonly DependencyProperty StretchProperty; 
    static KButton()
    {
        ForeImageProperty = DependencyProperty.Register("ForeImage", typeof(string), typeof(KButton),null);
        ForeImageProperty = DependencyProperty.Register("BackImage", typeof(string), typeof(KButton),null);
        MouseOverBackColorProperty = DependencyProperty.Register("MouseOverBackColor", typeof(Brush), typeof(KButton), null);
        StretchProperty = DependencyProperty.Register("Stretch", typeof(Stretch), typeof(KButton), null);

        DefaultStyleKeyProperty.OverrideMetadata(typeof(KButton), new FrameworkPropertyMetadata(typeof(KButton)));//使KButton去讀取KButton類型的樣式,而不是去讀取Button的樣式
    }
   
    public string ForeImage
    {
        get { return (string)GetValue(ForeImageProperty); }
        set { SetValue(ForeImageProperty, value); }
    }
    public string BackImage
    {
        get { return (string)GetValue(BackImageProperty); }
        set { SetValue(BackImageProperty, value); }
    }
    public Brush MouseOverBackColor
    {
        get { return (Brush)GetValue(MouseOverBackColorProperty); }
        set { SetValue(MouseOverBackColorProperty, value); }
    }
    public Stretch Stretch
    {
        get { return (Stretch)GetValue(StretchProperty); }
        set { SetValue(StretchProperty, value); }
    } 
}

如上述代碼所示,我們定義了一個繼承至Button的類KButton。

在KButtion中,我們定義了四個依賴屬性:

ForeImageProperty:按鈕的前景圖片。

BackImageProperty:按鈕的背景圖片。

MouseOverBackColorProperty:按鈕在滑鼠經過時的顏色。

StretchProperty:按鈕圖片的拉伸模式。

代碼非常簡潔,除了四個依賴屬性之外,什麼也沒有;現在我們去定義Kbutton類型的樣式。

為了演示方便,我直接將樣式定義在了App.xaml文件內。

        <Style TargetType="{x:Type local:KButton}">
            <Setter Property="Template">
                <Setter.Value>
                    <ControlTemplate>
                        <DockPanel Name="dpCon" Width="{Binding Width, RelativeSource={x:Static RelativeSource.TemplatedParent}}" 
                               Height="{Binding Height, RelativeSource={x:Static RelativeSource.TemplatedParent}}"
                               Background="{Binding Background, RelativeSource={x:Static RelativeSource.TemplatedParent}}"
                               ToolTip="{Binding ToolTip, RelativeSource={x:Static RelativeSource.TemplatedParent}}"
                               >
                            <DockPanel DockPanel.Dock="Top" Name="dpBtn">
                                <DockPanel.Background>
                                    <ImageBrush ImageSource="{Binding ForeImage, RelativeSource={x:Static RelativeSource.TemplatedParent}}" Stretch="{Binding Stretch,RelativeSource={x:Static RelativeSource.TemplatedParent}}"/>
                                </DockPanel.Background>
                                <TextBlock FontSize="15" VerticalAlignment="Center" HorizontalAlignment="Center" Foreground="#f9fcff" Text="{Binding Content, RelativeSource={x:Static RelativeSource.TemplatedParent}}"></TextBlock>
                            </DockPanel>
                        </DockPanel>
                        <ControlTemplate.Triggers>  
                            <DataTrigger Binding="{Binding IsMouseOver,RelativeSource={x:Static RelativeSource.Self}}" Value="True">
                                <Setter Property="Background" TargetName="dpBtn">
                                    <Setter.Value>
                                        <ImageBrush ImageSource="{Binding BackImage, RelativeSource={x:Static RelativeSource.TemplatedParent}}" Stretch="{Binding Stretch,RelativeSource={x:Static RelativeSource.TemplatedParent}}"/>
                                    </Setter.Value>
                                </Setter>
                                <Setter Property="Background" TargetName="dpCon" Value="{Binding MouseOverBackColor, RelativeSource={x:Static RelativeSource.TemplatedParent}}"></Setter>
                            </DataTrigger>
                            <DataTrigger Binding="{Binding BackImage,RelativeSource={x:Static RelativeSource.Self},Mode=TwoWay}" Value="{x:Null}">
                                <Setter Property="Background" TargetName="dpBtn">
                                    <Setter.Value>
                                        <ImageBrush ImageSource="{Binding ForeImage, RelativeSource={x:Static RelativeSource.TemplatedParent}}" Stretch="{Binding Stretch,RelativeSource={x:Static RelativeSource.TemplatedParent}}"/>
                                    </Setter.Value>
                                </Setter> 
                            </DataTrigger>
                            <Trigger Property="IsEnabled" Value="true"/>
                            <Trigger Property="IsEnabled" Value="false">
                                <Setter Property="Foreground" Value="Gray"/>
                            </Trigger>
                        </ControlTemplate.Triggers>
                    </ControlTemplate>
                </Setter.Value>
            </Setter>
        </Style>

樣式代碼如上所示,也非常簡單,就是定義了一個模板,然後在模板里擺放好按鈕背景圖和按鈕文字的位置。然後將我們之前定義好的依賴屬性綁定到對應的值上。

其中需要註意的是,在模板中綁定自定義依賴屬性,是使用RelativeSource.TemplatedParent的,如{Binding ForeImage, RelativeSource={x:Static RelativeSource.TemplatedParent}}。

而在模板的數據事件DataTrigger中,綁定依賴屬性的模式卻是分兩種的。

第一種,綁定數據事件DataTrigger的條件時,使用RelativeSource.Self,如{Binding IsMouseOver,RelativeSource={x:Static RelativeSource.Self}}。

第二種,條件成立,觸發模板變化時,使用RelativeSource.TemplatedParent,如{Binding BackImage, RelativeSource={x:Static RelativeSource.TemplatedParent}}。

----------------------------------------------------------------------------------------------------

現在我們使用下我們製作好的自定義控制項,代碼如下所示:

<DockPanel>
    <StackPanel>
        <local:KButton  Height="50" Width="50" Stretch="None" ForeImage="/Image/關閉.png" BackImage="/Image/關閉退出.png" Background="Gray" MouseOverBackColor="Brown"/>
        <local:KButton  Height="50" Width="50" Margin="0,10,0,0" Stretch="None" ForeImage="/Image/關閉.png" Background="Gray" MouseOverBackColor="Brown"/>
        <local:KButton  Height="100" Width="100" Margin="0,10,0,0" Content="籃子" Stretch="Fill"  ForeImage="/Image/籃子.png" Background="Gray" MouseOverBackColor="Brown"/>
    </StackPanel> 
</DockPanel>

界面效果如下:

自定義用戶控制項中使用依賴屬性

首先我們添加新項,然後選擇用戶控制項。

然後,我們添加一個依賴屬性HeaderTitle,同時設置當前控制項的DataContext為自身—this.DataContext = this。

public string HeaderTitle
{
    get { return (string)GetValue(HeaderTitleProperty); }
    set { SetValue(HeaderTitleProperty, value); }
} 
public static readonly DependencyProperty HeaderTitleProperty = DependencyProperty.Register("HeaderTitle", typeof(string), typeof(DependecyUserControl), null); 
public DependecyUserControl()
{
    this.DataContext = this;
    InitializeComponent();
}

現在,我們在用戶控制項的Xaml頁面添加一個TextBlock,並綁定他的Text為我們剛剛定義的HeaderTitle,代碼如下所示。

<Grid>
    <TextBlock Text = "{Binding HeaderTitle}" TextAlignment="Center"></TextBlock>
</Grid>

接著我們回到主窗體,引用這個用戶控制項,代碼如下所示:

<local:DependecyUserControl Height = "30" HeaderTitle="我是Header"  DockPanel.Dock="Top"></local:DependecyUserControl>

運行結果:

可以看到,我們成功在主頁面設置了用戶控制項的依賴屬性,並讓他成功的綁定到了用戶控制項中的TextBlock的Text屬性。也就是說,我們簡單的實現了Header的Title動態設置。

結語

WPF擁有非常強大的自定義能力,而,正確的學會了依賴屬性是體會到它強大的第一步。

----------------------------------------------------------------------------------------------------

到此WPF依賴屬性的正確學習方法就已經講解完成了。

代碼已經傳到Github上了,歡迎大家下載。

Github地址:https://github.com/kiba518/WpfDependency

----------------------------------------------------------------------------------------------------

註:此文章為原創,歡迎轉載,請在文章頁面明顯位置給出此文鏈接!
若您覺得這篇文章還不錯,請點擊下方的推薦】,非常感謝!

https://www.cnblogs.com/kiba/p/11149147.html


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 高性能TcpServer - 1.網路通信協議 高性能TcpServer - 2.創建高性能Socket伺服器SocketAsyncEventArgs的實現(IOCP) 高性能TcpServer - 3.命令通道(處理:掉包,粘包,垃圾包) 高性能TcpServer - 4.文件通道(處理:文件分包 ...
  • 高性能TcpServer - 1.網路通信協議 高性能TcpServer - 2.創建高性能Socket伺服器SocketAsyncEventArgs的實現(IOCP) 高性能TcpServer - 3.命令通道(處理:掉包,粘包,垃圾包) 高性能TcpServer - 4.文件通道(處理:文件分包 ...
  • 今天在win7上部署一個IIS網站,莫名出現HTTP Error 503,於是對比了一下之前的網站配置,依然無果。 無奈之下,挨個查看IIS配置、查看“事件查看器”,嘗試修改應用程式池 - 高級設置 - 載入用戶配置,將此值修改為 false 問題解決,特此留記。 ...
  • 今天,我們宣佈推出 .NET Core 3.0 Preview 7 。我們的工作已經從創建新功能過渡到打磨版本。預計剩餘的預覽版會聚焦在版本質量上。 ...
  • 問題: 部署在Azure環境Web應用程式的JSON文件,直接通過瀏覽器或Web應用訪問出現 404 的錯誤信息。 以下通過Firfox瀏覽器直接訪問JSON文件返回的提示錯誤信息: “HTML 文檔的字元編碼未聲明。如果該文件包含 US-ASCII 範圍之外的字元,該文件將在某些瀏覽器配置中呈現為 ...
  • 打開UBF,新建項目-》實體項目 輸入名稱後,點擊確定,第二步:修改名稱以在後期作為文件夾區分 第三步:創建實體 第四步:添加U9基礎對象引用 拖動到解決方案的Reference 第五步:右鍵構造 ...
  • 一、前言 項目中需要提供一個視頻介紹,使用戶能夠快速、方便的瞭解如何使用產品以及註意事項。 前臺使用Vue+Element UI中的el-upload組件實現視頻上傳及進度條展示,後臺提供視頻上傳API並返回URL。 二、具體實現 1、效果圖展示 2、HTML代碼 3、JS代碼 4、後臺代碼 三、總 ...
  • TCP/IP四層模型分為: 應用層,傳輸層(只關註起點(發送者)和終點(接收者)),網路層(規划出一條或幾條路線),數據鏈路層(關註兩個相鄰點之間怎麼傳輸) 設備驅動程式及 網路介面負責 一、應用層: 1、HTTP協議(主要協議):HTTP是超文本傳輸協議,是當前最流行也是最典型的應用層協議 HTT ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...