充分使用 .NET 框架的 PropertyGrid 控件(微軟)之8
發(fā)表時(shí)間:2023-07-17 來源:明輝站整理相關(guān)軟件相關(guān)文章人氣:
[摘要]添加域列表和簡單的下拉列表屬性支持對于基于 Enum 類型返回枚舉的屬性,PropertyGrid 會自動在下拉列表中顯示枚舉值。EnumConverter 也提供了這一功能。對于自己的屬性,您可能...
添加域列表和簡單的下拉列表屬性支持
對于基于 Enum 類型返回枚舉的屬性,PropertyGrid 會自動在下拉列表中顯示枚舉值。EnumConverter 也提供了這一功能。對于自己的屬性,您可能希望為用戶提供一個(gè)有效值列表(有時(shí)也稱為選取列表或域列表),而其類型并不是基于 Enum。如果域值在運(yùn)行時(shí)之前未知,或者值可以更改,則屬于這種情況。
修改選項(xiàng)窗口,提供一個(gè)用戶可從中選擇的默認(rèn)文件名的域列表。您已經(jīng)將 DefaultFileName 屬性添加到 AppSettings 類。下一步是在 PropertyGrid 中顯示屬性的下拉列表,以提供域列表。
提供簡單的下拉列表屬性支持
創(chuàng)建一個(gè)從類型轉(zhuǎn)換器類繼承而來的類。由于 DefaultFileName 屬性屬于 String 類型,因此可以從 StringConverter 中繼承。如果屬性類型的類型轉(zhuǎn)換器不存在,則可以從 TypeConverter 繼承;這里并不需要。
' Visual Basic
Public Class FileNameConverter
Inherits StringConverter
End Class
覆蓋 GetStandardValuesSupported 方法并返回 true,表示此對象支持可以從列表中選取的一組標(biāo)準(zhǔn)值。
' Visual Basic
Public Overloads Overrides Function GetStandardValuesSupported( _
ByVal context As ITypeDescriptorContext) As Boolean
Return True
End Function
覆蓋 GetStandardValues 方法并返回填充了標(biāo)準(zhǔn)值的 StandardValuesCollection。創(chuàng)建 StandardValuesCollection 的方法之一是在構(gòu)造函數(shù)中提供一個(gè)值數(shù)組。對于選項(xiàng)窗口應(yīng)用程序,您可以使用填充了建議的默認(rèn)文件名的 String 數(shù)組。
' Visual Basic
Public Overloads Overrides Function GetStandardValues( _
ByVal context As ITypeDescriptorContext) _
As StandardValuesCollection
Return New StandardValuesCollection(New String() {"新文件", _
"文件1", _
"文檔1"})
End Function
(可選)如果希望用戶能夠鍵入下拉列表中沒有包含的值,請覆蓋 GetStandardValuesExclusive 方法并返回 false。這從根本上將下拉列表樣式變成了組合框樣式。
' Visual Basic
Public Overloads Overrides Function GetStandardValuesExclusive( _
ByVal context As ITypeDescriptorContext) As Boolean
Return False
End Function
擁有自己的用于顯示下拉列表的類型轉(zhuǎn)換器類后,您需要確定使用該類的目標(biāo)。在本示例中,目標(biāo)為 DefaultFileName 屬性,因?yàn)轭愋娃D(zhuǎn)換器是針對該屬性的。將 TypeConverterAttribute 應(yīng)用到目標(biāo)屬性中。
' Visual Basic
' 應(yīng)用到 DefaultFileName 屬性的 TypeConverter 特性。
<TypeConverter(GetType(FileNameConverter)), _
CategoryAttribute("文檔設(shè)置")> _
Public Property DefaultFileName() As String
Get
Return _defaultFileName
End Get
Set(ByVal Value As String)
_defaultFileName = Value
End Set
End Property
再次編譯并運(yùn)行選項(xiàng)窗口應(yīng)用程序。下面的屏幕快照顯示了選項(xiàng)窗口目前的外觀。請注意 DefaultFileName 屬性的外觀。
圖 7:在 PropertyGrid 中顯示下拉域列表
為屬性提供自定義 UI
如上所述,.NET 框架類型使用 TypeConverter 和 UITypeEditor 類(以及其他類)來提供 PropertyGrid 編輯支持。有關(guān)如何使用 TypeConverter,請參閱對自定義類型的支持一節(jié);您也可以使用 UITypeEditor 類來自定義 PropertyGrid。
您可以在 PropertyGrid 中提供小圖形表示和屬性值,類似于為 Image 和 Color 類提供的內(nèi)容。要在自定義中執(zhí)行此操作,請從 UITypeEditor 繼承,覆蓋 GetPaintValueSupported 并返回 true。然后,覆蓋 UITypeEditor.PaintValue 方法,并在自己的方法中使用 PaintValueEventArgs.Graphics 參數(shù)繪制圖形。最后,將 Editor 特性應(yīng)用到使用 UITypeEditor 類的類或?qū)傩浴?br>
下面的屏幕快照顯示了結(jié)果外觀。
圖 8:在 PropertyGrid 中顯示屬性的自定義圖形
您也可以提供自己的下拉列表控件,這與 Control.Dock 屬性用來為用戶提供靠接選擇的控件類似。要執(zhí)行此操作,請從 UITypeEditor 繼承,覆蓋 GetEditStyle,然后返回一個(gè) UITypeEditorEditStyle 枚舉值,例如 DropDown。您的自定義下拉列表控件必須從 Control 或 Control 的派生類(例如 UserControl)繼承而來。然后,覆蓋 UITypeEditor.EditValue 方法。使用 IServiceProvider 參數(shù)調(diào)用 IServiceProvider.GetService 方法,以獲取一個(gè) IWindowsFormsEditorService 實(shí)例。最后,調(diào)用 IWindowsFormsEditorService.DropDownControl 方法來顯示您的自定義下拉列表控件。請記住將 Editor 特性應(yīng)用到使用 UITypeEditor 類的類或?qū)傩灾小?br>
下面的屏幕快照顯示了結(jié)果外觀。
圖 9:在 PropertyGrid 中顯示屬性的自定義下拉列表控件
除了使用 TypeEditor 和 UITypeEditor 類外,還可以自定義 PropertyGrid 以顯示其他屬性選項(xiàng)卡。屬性選項(xiàng)卡從 PropertyTab 類繼承而來。如果您使用過 Microsoft Visual C#™ .NET 中的屬性瀏覽器,那么就可能看到過自定義的 PropertyTab。Events 選項(xiàng)卡(帶有閃電圖形的按鈕)就是一個(gè)自定義的 PropertyTab。下面的屏幕快照顯示了自定義 PropertyTab 的另一個(gè)示例?梢允褂 PropertyTab 編輯按鈕的邊界點(diǎn),以創(chuàng)建自定義的按鈕形狀。
圖 10:在 PropertyGrid 中顯示自定義選項(xiàng)卡
有關(guān)使用 UITypeEditor 類自定義 PropertyGrid 的詳細(xì)信息,以及上述自定義用戶界面代碼示例,請參閱 Shawn Burke 的文章 Make Your Components Really RAD with Visual Studio .NET Property Browser(英文)。
小結(jié)
.NET 框架提供的 ProperyGrid 控件具有豐富的編輯功能,您可以使用這些編輯功能來改善您的用戶界面。PropertyGrid 的自定義非常簡單,您可以在任何應(yīng)用程序中使用這一控件。此外,由于 Visual Studio .NET 屬性瀏覽器是建立在 PropertyGrid 的基礎(chǔ)之上的,因此您可以使用這些技術(shù)提供更豐富的設(shè)計(jì)時(shí)體驗(yàn)。