ExpandableObjectConverter 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供在可扩展对象与其他各种表示形式之间实现转换的类型转换器。
public ref class ExpandableObjectConverter : System::ComponentModel::TypeConverterpublic class ExpandableObjectConverter : System.ComponentModel.TypeConvertertype ExpandableObjectConverter = class
inherit TypeConverterPublic Class ExpandableObjectConverter
Inherits TypeConverter- 继承
- 派生
示例
下面的代码示例将 类型的 Margins 变量转换为字符串变量。
String^ strM = "1,2,3,4";
System::Drawing::Printing::Margins^ m = gcnew System::Drawing::Printing::Margins( 1,2,3,4 );
Console::WriteLine( TypeDescriptor::GetConverter( strM )->CanConvertTo( System::Drawing::Printing::Margins::typeid ) );
Console::WriteLine( TypeDescriptor::GetConverter( m )->ConvertToString( m ) );
string strM="1,2,3,4";
System.Drawing.Printing.Margins m= new System.Drawing.Printing.Margins(1,2,3,4);
Console.WriteLine(TypeDescriptor.GetConverter(strM).CanConvertTo(typeof(System.Drawing.Printing.Margins)));
Console.WriteLine(TypeDescriptor.GetConverter(m).ConvertToString(m));
Dim strM As String
strM = "1,2,3,4"
Dim m As New System.Drawing.Printing.Margins(1, 2, 3, 4)
Console.WriteLine(TypeDescriptor.GetConverter(strM).CanConvertTo(GetType(System.Drawing.Printing.Margins)))
Console.WriteLine(TypeDescriptor.GetConverter(m).ConvertToString(m))
下面的代码示例演示如何使用 NotifyParentPropertyAttribute 和 ExpandableObjectConverter 类在自定义控件上创建可展开属性。 此代码示例是为 NotifyParentPropertyAttribute 类提供的一个更大示例的一部分。
[TypeConverter(typeof(BorderAppearanceConverter))]
public class BorderAppearance
{
private int borderSizeValue = 1;
private Color borderColorValue = Color.Empty;
[Browsable(true),
NotifyParentProperty(true),
EditorBrowsable(EditorBrowsableState.Always),
DefaultValue(1)]
public int BorderSize
{
get
{
return borderSizeValue;
}
set
{
if (value < 0)
{
throw new ArgumentOutOfRangeException(
"BorderSize",
value,
"must be >= 0");
}
if (borderSizeValue != value)
{
borderSizeValue = value;
}
}
}
[Browsable(true)]
[NotifyParentProperty(true)]
[EditorBrowsable(EditorBrowsableState.Always)]
[DefaultValue(typeof(Color), "")]
public Color BorderColor
{
get
{
return borderColorValue;
}
set
{
if (value.Equals(Color.Transparent))
{
throw new NotSupportedException("Transparent colors are not supported.");
}
if (borderColorValue != value)
{
borderColorValue = value;
}
}
}
}
<TypeConverter(GetType(BorderAppearanceConverter))> _
Public Class BorderAppearance
Private borderSizeValue As Integer = 1
Private borderColorValue As Color = Color.Empty
<Browsable(True), NotifyParentProperty(True), EditorBrowsable(EditorBrowsableState.Always), DefaultValue(1)> _
Public Property BorderSize() As Integer
Get
Return borderSizeValue
End Get
Set
If value < 0 Then
Throw New ArgumentOutOfRangeException("BorderSize", value, "must be >= 0")
End If
If borderSizeValue <> value Then
borderSizeValue = value
End If
End Set
End Property
<Browsable(True), NotifyParentProperty(True), EditorBrowsable(EditorBrowsableState.Always), DefaultValue(GetType(Color), "")> _
Public Property BorderColor() As Color
Get
Return borderColorValue
End Get
Set
If value.Equals(Color.Transparent) Then
Throw New NotSupportedException("Transparent colors are not supported.")
End If
If borderColorValue <> value Then
borderColorValue = value
End If
End Set
End Property
End Class
注解
此类向 提供的方法和属性添加了对 对象上属性的支持 TypeConverter。 若要在 中PropertyGrid使某个类型的属性可展开，请为 和 GetProperties的标准实现GetPropertiesSupported指定此属性TypeConverter。 使用 NotifyParentPropertyAttribute 标记子属性，以确保控件中 PropertyGrid 的行为正确。
注意
永远不要直接访问类型转换器。 请改为使用 TypeDescriptor调用相应的转换器。 有关详细信息，请参阅基类中的 TypeConverter 示例。
有关类型转换器的详细信息，请参阅 TypeConverter 基类和 如何：实现类型转换器。
构造函数
| ExpandableObjectConverter() |
初始化 ExpandableObjectConverter 类的新实例。 |
