InstalledFontCollection 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.
Stellt die auf dem System installierten Schriftarten dar. Diese Klasse kann nicht geerbt werden.
public ref class InstalledFontCollection sealed : System::Drawing::Text::FontCollectionpublic sealed class InstalledFontCollection : System.Drawing.Text.FontCollectiontype InstalledFontCollection = class
inherit FontCollectionPublic NotInheritable Class InstalledFontCollection
Inherits FontCollection- Vererbung
Beispiele
Das folgende Beispiel zeigt, wie Sie eine Liste der Schriftarten abrufen, die die reguläre FontStyleunterstützen.
Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt.
InstalledFontCollection ifc = new InstalledFontCollection();
private void EnumerateInstalledFonts(PaintEventArgs e)
{
FontFamily[] families = ifc.Families;
float x = 0.0F;
float y = 0.0F;
for (int i = 0; i < ifc.Families.Length; i++)
{
if (ifc.Families[i].IsStyleAvailable(FontStyle.Regular))
{
e.Graphics.DrawString(ifc.Families[i].Name, new Font(ifc.Families[i], 12),
Brushes.Black, x, y);
y += 20;
if (y % 700 == 0)
{
x += 140;
y = 0;
}
}
}
}
Private ifc As New InstalledFontCollection()
Private Sub EnumerateInstalledFonts(ByVal e As PaintEventArgs)
Dim families As FontFamily() = ifc.Families
Dim x As Single = 0.0F
Dim y As Single = 0.0F
For i As Integer = 0 To ifc.Families.Length - 1
If ifc.Families(i).IsStyleAvailable(FontStyle.Regular) Then
e.Graphics.DrawString(ifc.Families(i).Name, New Font(ifc.Families(i), 12), _
Brushes.Black, x, y)
y += 20
If y Mod 700 = 0 Then
x += 140
y = 0
End If
End If
Next
End Sub
Hinweise
Mit dem InstalledFontCollection können Sie eine Liste der Schriftartfamilien abrufen, die auf dem Computer installiert sind, auf dem die Anwendung mit der Families-Eigenschaft ausgeführt wird. Weitere Informationen zu Schriftarten und Text, einschließlich Beispielcode, finden Sie unter Verwenden von Schriftarten und Text.
Verwenden Sie die InstalledFontCollection Klasse nicht, um eine Schriftart unter Windows zu installieren. Verwenden Sie stattdessen die GDI-AddFontResource-Funktion. Ein InstalledFontCollection-Objekt sieht nur Schriftarten, die in Windows installiert sind, bevor das Objekt erstellt wird.
Anmerkung
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 nur unter Windowsunterstützt.
Konstruktoren
| InstalledFontCollection() |
Initialisiert eine neue Instanz der InstalledFontCollection Klasse. |
Eigenschaften
| Families |
Ruft das Array von FontFamily Objekten ab, die diesem FontCollectionzugeordnet sind. (Geerbt von FontCollection) |
Methoden
| Dispose() |
Gibt alle von diesem FontCollectionverwendeten Ressourcen frei. (Geerbt von FontCollection) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die vom FontCollection verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von FontCollection) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
