FontConverter 類別

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

來源:

FontConverter.cs

將 Font 物件從一個資料型別轉換為另一個資料型別。

public ref class FontConverter : System::ComponentModel::TypeConverter

public class FontConverter : System.ComponentModel.TypeConverter

type FontConverter = class
    inherit TypeConverter

Public Class FontConverter
Inherits TypeConverter

繼承

Object

TypeConverter

FontConverter

範例

下列程式代碼範例示範如何使用 FontConverter 來回轉換 Font 字串。 此範例的設計目的是要與 Windows Forms 搭配使用。 將此程式代碼貼到表單中，並在處理表單的事件時呼叫 ShowFontStringConversion 方法，並將 e 傳遞為 PaintEventArgs。Paint

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

備註

類型轉換器可用來轉換數據類型之間的值。 類型轉換器也支援設計時間的屬性組態，方法是提供文字到值轉換或使用者可以選取的值清單。 FontConverter藉由呼叫 GetConverter 方法，TypeDescriptor透過類別存取 類別。

注意

在 .NET 6 和更新版本中，只有 Windows 作業系統才支援包含此類型的 System.Drawing.Common 套件。 在跨平臺應用程式中使用此類型會導致編譯時間警告和運行時間例外狀況。 如需詳細資訊，請參閱 僅限 Windows 上支援的 System.Drawing.Common。

建構函式

FontConverter()

初始化新的 FontConverter 物件。

方法

CanConvertFrom(ITypeDescriptorContext, Type)	判斷這個轉換子是否可以將指定來源型別的物件轉換成轉換子的原生 (Native) 型別。
CanConvertFrom(Type)	傳回值，指出這個轉換子是否可將指定之型別的物件轉換為這個轉換子的型別。 (繼承來源 TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	取得值，表示這個轉換子是否可以使用內容將物件轉換成指定的目的型別。
CanConvertTo(Type)	傳回值，指出這個轉換子是否可以將物件轉換成指定的型別。 (繼承來源 TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	將指定的物件轉換成轉換子的原生型別。
ConvertFrom(Object)	會將指定值轉換為這個轉換子的型別。 (繼承來源 TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	會使用不區分的文化特性和指定的內容，將指定的字串轉換為這個轉換子的型別。 (繼承來源 TypeConverter)
ConvertFromInvariantString(String)	會使用不因文化特性而異，將指定字串轉換為這個轉換子的型別。 (繼承來源 TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	會使用指定內容和文化特性資訊，將指定文字轉換為物件。 (繼承來源 TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	會使用指定的內容，將指定文字轉換為物件。 (繼承來源 TypeConverter)
ConvertFromString(String)	會將指定的文字轉換成物件。 (繼承來源 TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	將指定的物件轉換為另一個型別。
ConvertTo(Object, Type)	會使用引數，將指定值物件轉換成指定型別。 (繼承來源 TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	會使用指定的內容，將指定值轉換成不因文化特性而異的字串表示。 (繼承來源 TypeConverter)
ConvertToInvariantString(Object)	會將指定值轉換成不因文化特性而異的字串表示。 (繼承來源 TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	會使用指定的內容和文化特性資訊，將指定值轉換為字串表示。 (繼承來源 TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	會使用指定的內容，將指定值轉換為字串表示。 (繼承來源 TypeConverter)
ConvertToString(Object)	會將指定值轉換成字串表示。 (繼承來源 TypeConverter)
CreateInstance(IDictionary)	重新建立 Object，需為物件提供一組屬性值。 (繼承來源 TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	藉由使用指定的物件屬性值組，來建立這個型別的物件。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetConvertFromException(Object)	傳回要在無法執行轉換時擲回的例外狀況。 (繼承來源 TypeConverter)
GetConvertToException(Object, Type)	傳回要在無法執行轉換時擲回的例外狀況。 (繼承來源 TypeConverter)
GetCreateInstanceSupported()	傳回值，指出在這個物件上變更值時是否需要呼叫 CreateInstance(IDictionary) 方法來建立新值。 (繼承來源 TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	判斷在這個物件上變更值是否需要呼叫 CreateInstance 方法來建立新的值。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetProperties(ITypeDescriptorContext, Object)	會使用指定的內容，傳回由值參數所指定之陣列型別的屬性集合。 (繼承來源 TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	擷取這個型別的屬性集。 根據預設值，型別不傳回任何屬性。
GetProperties(Object)	傳回由值參數所指定的陣列型別的屬性集合。 (繼承來源 TypeConverter)
GetPropertiesSupported()	傳回值，指出這個物件是否支援屬性。 (繼承來源 TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	判斷這個物件是否支援屬性。 預設為 false。
GetStandardValues()	從為這個型別轉換子所設計的資料型別預設內容中，會傳回標準值的集合。 (繼承來源 TypeConverter)
GetStandardValues(ITypeDescriptorContext)	提供格式內容時，傳回此類型轉換子所針對資料類型的標準值集合。 (繼承來源 TypeConverter)
GetStandardValuesExclusive()	傳回值，指出從 GetStandardValues() 所傳回的標準值集合是否為獨佔清單。 (繼承來源 TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	使用指定的內容，傳回從 GetStandardValues() 所傳回的標準值集合是否為可能值的獨占清單。 (繼承來源 TypeConverter)
GetStandardValuesSupported()	傳回這個物件是否支援可以從清單中選取的標準值集合。 (繼承來源 TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	會使用指定的內容傳回，這個物件是否支援可從清單中挑選的標準值集合。 (繼承來源 TypeConverter)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsValid(ITypeDescriptorContext, Object)	傳回指定值物件對這個類型和指定的內容是否有效。 (繼承來源 TypeConverter)
IsValid(Object)	會傳回指定值物件是否對這個型別有效。 (繼承來源 TypeConverter)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
SortProperties(PropertyDescriptorCollection, String[])	排序屬性的集合。 (繼承來源 TypeConverter)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• TypeConverter