FontConverter 类

定义

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
继承
FontConverter

示例

下面的代码示例演示如何使用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. 将此代码粘贴到窗体中, ShowFontStringConversion并在处理Paint窗体事件时调用方法, 并PaintEventArgs将 e 作为传递。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

注解

类型转换器用于在数据类型之间转换值。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. 通过调用TypeDescriptor FontConverter 方法,通过GetConverter类访问类。Access the FontConverter class through the TypeDescriptor class by calling the GetConverter method.

构造函数

FontConverter()

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

方法

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.

(继承自 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.

(继承自 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.

(继承自 TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)

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

(继承自 TypeConverter)
ConvertFromInvariantString(String)

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

(继承自 TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)

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

(继承自 TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)

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

(继承自 TypeConverter)
ConvertFromString(String)

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

(继承自 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.

(继承自 TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)

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

(继承自 TypeConverter)
ConvertToInvariantString(Object)

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

(继承自 TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)

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

(继承自 TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)

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

(继承自 TypeConverter)
ConvertToString(Object)

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

(继承自 TypeConverter)
CreateInstance(IDictionary)

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

(继承自 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.

(继承自 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.

(继承自 TypeConverter)
GetConvertToException(Object, Type)

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

(继承自 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.

(继承自 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.

(继承自 Object)
GetProperties(ITypeDescriptorContext, Object)

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

(继承自 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.

(继承自 TypeConverter)
GetPropertiesSupported()

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

(继承自 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.

(继承自 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.

(继承自 TypeConverter)
GetStandardValuesExclusive()

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

(继承自 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.

(继承自 TypeConverter)
GetStandardValuesSupported()

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

(继承自 TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)

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

(继承自 TypeConverter)
GetType()

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

(继承自 Object)
IsValid(ITypeDescriptorContext, Object)

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

(继承自 TypeConverter)
IsValid(Object)

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

(继承自 TypeConverter)
MemberwiseClone()

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

(继承自 Object)
SortProperties(PropertyDescriptorCollection, String[])

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

(继承自 TypeConverter)
ToString()

返回一个表示当前对象的 string。Returns a string that represents the current object.

(继承自 Object)

适用于

另请参阅