FontConverter Class

Definition

Font 对象从一种数据类型转换成另一种数据类型。Converts Font objects from one data type to another.

public ref class FontConverter : System::ComponentModel::TypeConverter
public class FontConverter : System.ComponentModel.TypeConverter
type FontConverter = class
    inherit TypeConverter
Public Class FontConverter
Inherits TypeConverter
Inheritance
FontConverter

Examples

下面的代码示例演示如何使用 FontConverterFont 与字符串相互转换。The following code example demonstrates how to use the FontConverter to convert a Font to and from a string. 此示例旨在与 Windows 窗体一起使用。This example is designed to be used with Windows Forms. 将此代码粘贴到窗体中,并在处理窗体的 Paint 事件时调用 ShowFontStringConversion 方法,同时将 e 作为 PaintEventArgs传递。Paste this code into a form and call the ShowFontStringConversion method when handling the form's Paint event, passing e as PaintEventArgs.

void ShowFontStringConversion( PaintEventArgs^ e )
{
   // Create the FontConverter.
   System::ComponentModel::TypeConverter^ converter =
         System::ComponentModel::TypeDescriptor::GetConverter( System::Drawing::Font::typeid );
   System::Drawing::Font^ font1 = dynamic_cast<System::Drawing::Font^>(converter->ConvertFromString( "Arial, 12pt" ));
   String^ fontName1 = converter->ConvertToInvariantString( font1 );
   String^ fontName2 = converter->ConvertToString( font1 );
   e->Graphics->DrawString( fontName1, font1, Brushes::Red, 10, 10 );
   e->Graphics->DrawString( fontName2, font1, Brushes::Blue, 10, 30 );
}
private void ShowFontStringConversion(PaintEventArgs e)
{

    // Create the FontConverter.
    System.ComponentModel.TypeConverter converter = 
        System.ComponentModel.TypeDescriptor.GetConverter(typeof(Font));

    Font font1 = (Font) converter.ConvertFromString("Arial, 12pt");

    string fontName1 = converter.ConvertToInvariantString(font1);
    string fontName2 = converter.ConvertToString(font1);

    e.Graphics.DrawString(fontName1, font1, Brushes.Red, 10, 10);
    e.Graphics.DrawString(fontName2, font1, Brushes.Blue, 10, 30);
}
Private Sub ShowFontStringConversion(ByVal e As PaintEventArgs)

    ' Create the FontConverter.
    Dim converter As System.ComponentModel.TypeConverter = _
        System.ComponentModel.TypeDescriptor.GetConverter(GetType(Font))

    Dim font1 As Font = _
        CType(converter.ConvertFromString("Arial, 12pt"), Font)

    Dim fontName1 As String = _
        converter.ConvertToInvariantString(font1)
    Dim fontName2 As String = converter.ConvertToString(font1)

    e.Graphics.DrawString(fontName1, font1, Brushes.Red, 10, 10)
    e.Graphics.DrawString(fontName2, font1, Brushes.Blue, 10, 30)
End Sub

Remarks

类型转换器用于在数据类型之间转换值。A type converter is used to convert values between data types. 类型转换器还支持在设计时配置属性,方法是提供文本到值的转换或用户可以从中选择的值列表。A type converter also supports property configuration at design time by providing text-to-value conversion or a list of values that users can select from. 通过调用 GetConverter 方法,通过 TypeDescriptor 类访问 FontConverter 类。Access the FontConverter class through the TypeDescriptor class by calling the GetConverter method.

Constructors

FontConverter()

初始化新的 FontConverter 对象。Initializes a new FontConverter object.

Methods

CanConvertFrom(ITypeDescriptorContext, Type)

确定此转换器是否可以将指定源类型的对象转换为转换器的本机类型。Determines whether this converter can convert an object in the specified source type to the native type of the converter.

CanConvertFrom(Type)

返回该转换器是否可以将给定类型的对象转换为此转换器的类型。Returns whether this converter can convert an object of the given type to the type of this converter.

(Inherited from TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)

获取一个值,该值指示此转换器能否使用上下文将对象转换为给定的目标类型。Gets a value indicating whether this converter can convert an object to the given destination type using the context.

CanConvertTo(Type)

返回此转换器是否可将该对象转换为指定的类型。Returns whether this converter can convert the object to the specified type.

(Inherited from TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)

将指定对象转换为转换器的本机类型。Converts the specified object to the native type of the converter.

ConvertFrom(Object)

将给定值转换为此转换器的类型。Converts the given value to the type of this converter.

(Inherited from TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)

使用不变区域性和指定上下文将给定字符串转换为此转换器的类型。Converts the given string to the type of this converter, using the invariant culture and the specified context.

(Inherited from TypeConverter)
ConvertFromInvariantString(String)

使用不变区域性将给定字符串转换为此转换器的类型。Converts the given string to the type of this converter, using the invariant culture.

(Inherited from TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)

使用指定的上下文和区域性信息将给定的文本转换为对象。Converts the given text to an object, using the specified context and culture information.

(Inherited from TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)

使用指定的上下文将给定的文本转换为对象。Converts the given text to an object, using the specified context.

(Inherited from TypeConverter)
ConvertFromString(String)

将指定文本转换为对象。Converts the specified text to an object.

(Inherited from TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

将指定的对象转换为其他类型。Converts the specified object to another type.

ConvertTo(Object, Type)

使用参数将给定的值对象转换为指定的类型。Converts the given value object to the specified type, using the arguments.

(Inherited from TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)

使用指定的上下文将指定的值转换为区域性不变的字符串表示形式。Converts the specified value to a culture-invariant string representation, using the specified context.

(Inherited from TypeConverter)
ConvertToInvariantString(Object)

将指定值转换为区域性不变的字符串表示形式。Converts the specified value to a culture-invariant string representation.

(Inherited from TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)

使用指定的上下文和区域性信息将给定的值转换为字符串表示形式。Converts the given value to a string representation, using the specified context and culture information.

(Inherited from TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)

使用给定的上下文将给定的值转换为字符串表示形式。Converts the given value to a string representation, using the given context.

(Inherited from TypeConverter)
ConvertToString(Object)

将指定值转换为字符串表示形式。Converts the specified value to a string representation.

(Inherited from TypeConverter)
CreateInstance(IDictionary)

在给定 Object 的一组属性值的情况下重新创建该对象。Re-creates an Object given a set of property values for the object.

(Inherited from TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)

通过为对象使用一组指定的属性值来创建此类型的对象。Creates an object of this type by using a specified set of property values for the object.

Equals(Object)

确定指定的对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize()

允许 FontConverter 在垃圾回收功能收回 FontConverter 之前尝试释放资源并执行其他清理操作。Allows the FontConverter to attempt to free resources and perform other cleanup operations before the FontConverter is reclaimed by garbage collection.

GetConvertFromException(Object)

返回当转换无法执行时所引发的异常。Returns an exception to throw when a conversion cannot be performed.

(Inherited from TypeConverter)
GetConvertToException(Object, Type)

返回当转换无法执行时所引发的异常。Returns an exception to throw when a conversion cannot be performed.

(Inherited from TypeConverter)
GetCreateInstanceSupported()

返回更改此对象的值是否求调用 CreateInstance(IDictionary) 方法来创建新值。Returns whether changing a value on this object requires a call to the CreateInstance(IDictionary) method to create a new value.

(Inherited from TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)

确定更改此对象上的值是否需要调用 CreateInstance 方法以创建新值。Determines whether changing a value on this object should require a call to the CreateInstance method to create a new value.

GetHashCode()

作为默认哈希函数。Serves as the default hash function.

(Inherited from Object)
GetProperties(ITypeDescriptorContext, Object)

使用指定的上下文返回值参数指定的数组类型的属性的集合。Returns a collection of properties for the type of array specified by the value parameter, using the specified context.

(Inherited from TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])

检索此类型的属性集。Retrieves the set of properties for this type. 默认情况下,类型没有任何要返回的属性。By default, a type does not have any properties to return.

GetProperties(Object)

返回由值参数指定的数组类型的属性集合。Returns a collection of properties for the type of array specified by the value parameter.

(Inherited from TypeConverter)
GetPropertiesSupported()

返回此对象是否支持属性。Returns whether this object supports properties.

(Inherited from TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)

确定此对象是否支持属性。Determines whether this object supports properties. 默认为 falseThe default is false.

GetStandardValues()

从默认的上下文返回此类型转换器设计用于的数据类型的标准值集合。Returns a collection of standard values from the default context for the data type this type converter is designed for.

(Inherited from TypeConverter)
GetStandardValues(ITypeDescriptorContext)

当与格式上下文一起提供时,返回此类型转换器设计用于的数据类型的标准值集合。Returns a collection of standard values for the data type this type converter is designed for when provided with a format context.

(Inherited from TypeConverter)
GetStandardValuesExclusive()

返回从 GetStandardValues() 返回的标准值的集合是否为独占列表。Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list.

(Inherited from TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)

使用指定的上下文返回从 GetStandardValues() 返回的标准值的集合是否为可能值的独占列表。Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list of possible values, using the specified context.

(Inherited from TypeConverter)
GetStandardValuesSupported()

返回此对象是否支持可以从列表中选取的值的标准集。Returns whether this object supports a standard set of values that can be picked from a list.

(Inherited from TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)

使用指定的上下文返回此对象是否支持可以从列表中选取的标准值集。Returns whether this object supports a standard set of values that can be picked from a list, using the specified context.

(Inherited from TypeConverter)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(Inherited from Object)
IsValid(ITypeDescriptorContext, Object)

返回给定的值对象是否对此类型和对指定的上下文有效。Returns whether the given value object is valid for this type and for the specified context.

(Inherited from TypeConverter)
IsValid(Object)

返回给定值对象对于此类型是否有效。Returns whether the given value object is valid for this type.

(Inherited from TypeConverter)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(Inherited from Object)
SortProperties(PropertyDescriptorCollection, String[])

对属性的集合进行排序。Sorts a collection of properties.

(Inherited from TypeConverter)
ToString()

返回表示当前对象的字符串。Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also