FontConverter Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Font Konvertiert Objekte von einem Datentyp in einen anderen.
public ref class FontConverter : System::ComponentModel::TypeConverterpublic class FontConverter : System.ComponentModel.TypeConvertertype FontConverter = class
inherit TypeConverterPublic Class FontConverter
Inherits TypeConverter- Vererbung
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie sie zum FontConverter Konvertieren einer Font Zeichenfolge in und aus einer Zeichenfolge verwendet werden. Dieses Beispiel wurde für die Verwendung mit Windows Forms entwickelt. Fügen Sie diesen Code in ein Formular ein, und rufen Sie die ShowFontStringConversion Methode beim Behandeln des Formularereignisses Paint auf, und übergeben Sie e als 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
Hinweise
Ein Typkonverter wird verwendet, um Werte zwischen Datentypen zu konvertieren. Ein Typkonverter unterstützt auch die Eigenschaftenkonfiguration zur Entwurfszeit, indem text-zu-Wert-Konvertierung oder eine Liste von Werten bereitgestellt wird, aus denen Benutzer auswählen können. Greifen Sie über die Klasse auf die FontConverterTypeDescriptor Klasse zu, indem Sie die GetConverter Methode aufrufen.
Note
In .NET 6 und höheren Versionen wird das System.Drawing.Common-Paket, das diesen Typ enthält, nur unter Windows-Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps führt zu Kompilierungszeitwarnungen und Laufzeit-Ausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.
Konstruktoren
| Name | Beschreibung |
|---|---|
| FontConverter() |
Initialisiert ein neues FontConverter Objekt. |
Methoden
| Name | Beschreibung |
|---|---|
| CanConvertFrom(ITypeDescriptorContext, Type) |
Bestimmt, ob dieser Konverter ein Objekt im angegebenen Quelltyp in den systemeigenen Typ des Konverters konvertieren kann. |
| CanConvertFrom(Type) |
Gibt zurück, ob dieser Konverter ein Objekt des angegebenen Typs in den Typ dieses Konverters konvertieren kann. (Geerbt von TypeConverter) |
| CanConvertTo(ITypeDescriptorContext, Type) |
Ruft einen Wert ab, der angibt, ob dieser Konverter ein Objekt mithilfe des Kontexts in den angegebenen Zieltyp konvertieren kann. |
| CanConvertTo(Type) |
Gibt zurück, ob dieser Konverter das Objekt in den angegebenen Typ konvertieren kann. (Geerbt von TypeConverter) |
| ConvertFrom(ITypeDescriptorContext, CultureInfo, Object) |
Konvertiert das angegebene Objekt in den systemeigenen Typ des Konverters. |
| ConvertFrom(Object) |
Konvertiert den angegebenen Wert in den Typ dieses Konverters. (Geerbt von TypeConverter) |
| ConvertFromInvariantString(ITypeDescriptorContext, String) |
Konvertiert die angegebene Zeichenfolge in den Typ dieses Konverters, wobei die invariante Kultur und der angegebene Kontext verwendet werden. (Geerbt von TypeConverter) |
| ConvertFromInvariantString(String) |
Konvertiert die angegebene Zeichenfolge in den Typ dieses Konverters unter Verwendung der invarianten Kultur. (Geerbt von TypeConverter) |
| ConvertFromString(ITypeDescriptorContext, CultureInfo, String) |
Konvertiert den angegebenen Text in ein Objekt mithilfe der angegebenen Kontext- und Kulturinformationen. (Geerbt von TypeConverter) |
| ConvertFromString(ITypeDescriptorContext, String) |
Konvertiert den angegebenen Text mithilfe des angegebenen Kontexts in ein Objekt. (Geerbt von TypeConverter) |
| ConvertFromString(String) |
Konvertiert den angegebenen Text in ein Objekt. (Geerbt von TypeConverter) |
| ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) |
Konvertiert das angegebene Objekt in einen anderen Typ. |
| ConvertTo(Object, Type) |
Konvertiert das angegebene Wertobjekt mithilfe der Argumente in den angegebenen Typ. (Geerbt von TypeConverter) |
| ConvertToInvariantString(ITypeDescriptorContext, Object) |
Wandelt den angegebenen Wert mithilfe des angegebenen Kontexts in eine kulturinvariante Zeichenfolgendarstellung um. (Geerbt von TypeConverter) |
| ConvertToInvariantString(Object) |
Konvertiert den angegebenen Wert in eine kulturinvariante Zeichenfolgendarstellung. (Geerbt von TypeConverter) |
| ConvertToString(ITypeDescriptorContext, CultureInfo, Object) |
Konvertiert den angegebenen Wert in eine Zeichenfolgendarstellung mithilfe der angegebenen Kontext- und Kulturinformationen. (Geerbt von TypeConverter) |
| ConvertToString(ITypeDescriptorContext, Object) |
Wandelt den angegebenen Wert mithilfe des angegebenen Kontexts in eine Zeichenfolgendarstellung um. (Geerbt von TypeConverter) |
| ConvertToString(Object) |
Konvertiert den angegebenen Wert in eine Zeichenfolgendarstellung. (Geerbt von TypeConverter) |
| CreateInstance(IDictionary) |
Erstellt einen Object bestimmten Satz von Eigenschaftswerten für das Objekt erneut. (Geerbt von TypeConverter) |
| CreateInstance(ITypeDescriptorContext, IDictionary) |
Erstellt ein Objekt dieses Typs mithilfe einer angegebenen Gruppe von Eigenschaftswerten für das Objekt. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| Finalize() |
Ermöglicht dem FontConverter Versuch, Ressourcen freizugeben und andere Bereinigungsvorgänge auszuführen, bevor die FontConverter Garbage Collection erneut beansprucht wird. |
| GetConvertFromException(Object) |
Gibt eine Ausnahme zurück, die ausgelöst wird, wenn eine Konvertierung nicht ausgeführt werden kann. (Geerbt von TypeConverter) |
| GetConvertToException(Object, Type) |
Gibt eine Ausnahme zurück, die ausgelöst wird, wenn eine Konvertierung nicht ausgeführt werden kann. (Geerbt von TypeConverter) |
| GetCreateInstanceSupported() |
Gibt zurück, ob das Ändern eines Werts für dieses Objekt einen Aufruf der CreateInstance(IDictionary) Methode erfordert, um einen neuen Wert zu erstellen. (Geerbt von TypeConverter) |
| GetCreateInstanceSupported(ITypeDescriptorContext) |
Bestimmt, ob beim Ändern eines Werts für dieses Objekt ein Aufruf der CreateInstance Methode erforderlich sein soll, um einen neuen Wert zu erstellen. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetProperties(ITypeDescriptorContext, Object, Attribute[]) |
Ruft den Satz von Eigenschaften für diesen Typ ab. Standardmäßig verfügt ein Typ nicht über eigenschaften, die zurückgegeben werden sollen. |
| GetProperties(ITypeDescriptorContext, Object) |
Gibt eine Auflistung von Eigenschaften für den Vom Wertparameter angegebenen Arraytyp mithilfe des angegebenen Kontexts zurück. (Geerbt von TypeConverter) |
| GetProperties(Object) |
Gibt eine Auflistung von Eigenschaften für den Arraytyp zurück, der durch den Wertparameter angegeben wird. (Geerbt von TypeConverter) |
| GetPropertiesSupported() |
Gibt zurück, ob dieses Objekt Eigenschaften unterstützt. (Geerbt von TypeConverter) |
| GetPropertiesSupported(ITypeDescriptorContext) |
Bestimmt, ob dieses Objekt Eigenschaften unterstützt. Der Standardwert lautet |
| GetStandardValues() |
Gibt eine Auflistung von Standardwerten aus dem Standardkontext für den Datentyp zurück, für den dieser Typkonverter entwickelt wurde. (Geerbt von TypeConverter) |
| GetStandardValues(ITypeDescriptorContext) |
Gibt eine Auflistung von Standardwerten für den Datentyp zurück, für den dieser Typkonverter entwickelt wurde, wenn er mit einem Formatkontext bereitgestellt wird. (Geerbt von TypeConverter) |
| GetStandardValuesExclusive() |
Gibt zurück, ob es sich bei der Auflistung der zurückgegebenen GetStandardValues() Standardwerte um eine exklusive Liste handelt. (Geerbt von TypeConverter) |
| GetStandardValuesExclusive(ITypeDescriptorContext) |
Gibt zurück, ob es sich bei der Auflistung der zurückgegebenen GetStandardValues() Standardwerte um eine exklusive Liste möglicher Werte handelt, wobei der angegebene Kontext verwendet wird. (Geerbt von TypeConverter) |
| GetStandardValuesSupported() |
Gibt zurück, ob dieses Objekt einen Standardsatz von Werten unterstützt, der aus einer Liste ausgewählt werden kann. (Geerbt von TypeConverter) |
| GetStandardValuesSupported(ITypeDescriptorContext) |
Gibt zurück, ob dieses Objekt einen Standardsatz von Werten unterstützt, die mithilfe des angegebenen Kontexts aus einer Liste ausgewählt werden können. (Geerbt von TypeConverter) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IsValid(ITypeDescriptorContext, Object) |
Gibt zurück, ob das angegebene Wertobjekt für diesen Typ und für den angegebenen Kontext gültig ist. (Geerbt von TypeConverter) |
| IsValid(Object) |
Gibt zurück, ob das angegebene Wertobjekt für diesen Typ gültig ist. (Geerbt von TypeConverter) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| SortProperties(PropertyDescriptorCollection, String[]) |
Sortiert eine Auflistung von Eigenschaften. (Geerbt von TypeConverter) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |