Dela via

Gör så här: Skapa en privat teckensnittssamling

  • Artikel

Klassen PrivateFontCollection ärver från den FontCollection abstrakta basklassen. Du kan använda ett PrivateFontCollection-objekt för att underhålla en uppsättning teckensnitt specifikt för ditt program. En privat teckensnittssamling kan innehålla installerade systemteckensnitt och teckensnitt som inte har installerats på datorn. Om du vill lägga till en teckensnittsfil i en privat teckensnittssamling anropar du metoden AddFontFile för ett PrivateFontCollection objekt.

Egenskapen Families för ett PrivateFontCollection-objekt innehåller en matris med FontFamily objekt.

Antalet teckensnittsfamiljer i en privat teckensnittssamling är inte nödvändigtvis detsamma som antalet teckensnittsfiler som har lagts till i samlingen. Anta till exempel att du lägger till filerna ArialBd.tff, Times.tff och TimesBd.tff i en samling. Det kommer att finnas tre filer men bara två familjer i samlingen eftersom Times.tff och TimesBd.tff tillhör samma familj.

Exempel

I följande exempel läggs följande tre teckensnittsfiler till i ett PrivateFontCollection objekt:

  • C:\systemroot\Fonts\Arial.tff (Arial, regular)

  • C:\systemroot\Fonts\CourBI.tff (Courier New, fet kursiv)

  • C:\systemroot\Fonts\TimesBd.tff (Times New Roman, bold)

Koden hämtar en matris med FontFamily objekt från egenskapen Families för PrivateFontCollection-objektet.

För varje FontFamily-objekt i samlingen anropar koden metoden IsStyleAvailable för att avgöra om olika format (vanliga, fetstil, kursiv stil, fet kursiv stil, understrykning och genomstrykning) är tillgängliga. Argumenten som skickas till metoden IsStyleAvailable är medlemmar i FontStyle uppräkning.

Om det finns en viss kombination av familj/format skapas ett Font objekt med hjälp av den familjen och stilen. Det första argumentet som skickas till konstruktorn Font är teckensnittsfamiljenamnet (inte ett FontFamily objekt, vilket är fallet för andra varianter av Font konstruktorn). När Font-objektet har konstruerats skickas det till DrawString-metoden för Graphics-klassen för att visa familjenamnet tillsammans med namnet på formatet.

Utdata från följande kod liknar de utdata som visas i följande bild:

Skärmbild som visar text i olika teckensnitt.

Arial.tff (som lades till i den privata teckensnittssamlingen i följande kodexempel) är teckensnittsfilen för det vanliga formatet Arial. Observera dock att programmets utdata visar flera andra tillgängliga format än vanliga för teckensnittsfamiljen Arial. Det beror på att GDI+ kan simulera fetstil, kursiv stil och fet kursiv stil från det vanliga formatet. GDI+ kan också skapa understrykningar och strikeouts från det vanliga formatet.

På samma sätt kan GDI+ simulera det fetstilade kursivt format från antingen fet stil eller kursiv stil. Programmets utdata visar att den fetstilstilen är tillgänglig för Times-familjen även om TimesBd.tff (Times New Roman, fetstil) är den enda Times-filen i samlingen.

// Helper function to print text in a font and style
private float DrawFont(Graphics graphicsObj,
                       FontFamily family,
                       FontStyle style,
                       SolidBrush colorBrush,
                       PointF location,
                       string styleName)
{
    // The string to print, which contains the family name and style
    string familyNameAndStyle = $"{family.Name} {styleName}";

    // Create the font object
    using (Font fontObject = new Font(family, 16, style, GraphicsUnit.Pixel))
    {
        // Draw the string
        graphicsObj.DrawString(familyNameAndStyle, fontObject, colorBrush, location);

        // Return the height of the font
        return fontObject.Height;
    }
}

// The OnPaint method of a form, which provides the graphics object
protected override void OnPaint(PaintEventArgs e)
{
    PointF location = new PointF(10, 0);
    SolidBrush solidBrush = new SolidBrush(Color.Black);

    FontFamily[] fontFamilies;
    PrivateFontCollection privateFontCollection = new PrivateFontCollection(); // Dispose later

    // Add three font files to the private collection.
    privateFontCollection.AddFontFile(System.Environment.ExpandEnvironmentVariables("%systemroot%\\Fonts\\Arial.ttf"));
    privateFontCollection.AddFontFile(System.Environment.ExpandEnvironmentVariables("%systemroot%\\Fonts\\CourBI.ttf"));
    privateFontCollection.AddFontFile(System.Environment.ExpandEnvironmentVariables("%systemroot%\\Fonts\\TimesBD.ttf"));

    // Get the array of FontFamily objects.
    fontFamilies = privateFontCollection.Families;

    // Process each font in the collection
    for (int i = 0; i < fontFamilies.Length; i++)
    {
        // Draw the font in every style

        // Regular
        if (fontFamilies[i].IsStyleAvailable(FontStyle.Regular))
            location.Y += DrawFont(e.Graphics, fontFamilies[i], FontStyle.Regular, solidBrush, location, "Regular");

        // Bold
        if (fontFamilies[i].IsStyleAvailable(FontStyle.Bold))
            location.Y += DrawFont(e.Graphics, fontFamilies[i], FontStyle.Bold, solidBrush, location, "Bold");

        // Italic
        if (fontFamilies[i].IsStyleAvailable(FontStyle.Italic))
            location.Y += DrawFont(e.Graphics, fontFamilies[i], FontStyle.Italic, solidBrush, location, "Italic");

        // Bold and Italic
        if (fontFamilies[i].IsStyleAvailable(FontStyle.Bold) &&
            fontFamilies[i].IsStyleAvailable(FontStyle.Italic))
            location.Y += DrawFont(e.Graphics, fontFamilies[i], FontStyle.Bold | FontStyle.Italic, solidBrush, location, "BoldItalic");

        // Underline
        if (fontFamilies[i].IsStyleAvailable(FontStyle.Underline))
            location.Y += DrawFont(e.Graphics, fontFamilies[i], FontStyle.Underline, solidBrush, location, "Underline");

        // Strikeout
        if (fontFamilies[i].IsStyleAvailable(FontStyle.Strikeout))
            location.Y += DrawFont(e.Graphics, fontFamilies[i], FontStyle.Strikeout, solidBrush, location, "Strikeout");

        // Extra space between font families
        location.Y += 10;
    }

    privateFontCollection.Dispose();
}

' Helper function to print text in a font and style
Private Function DrawFont(graphicsObj As Graphics,
                          family As FontFamily,
                          style As FontStyle,
                          colorBrush As SolidBrush,
                          location As PointF,
                          styleName As String) As Single

    ' The string to print, which contains the family name and style
    Dim familyNameAndStyle As String = $"{family.Name} {styleName}"

    ' Create the font object
    Using fontObject As New Font(family, 16, style, GraphicsUnit.Pixel)

        ' Draw the string
        graphicsObj.DrawString(familyNameAndStyle, fontObject, colorBrush, location)

        ' Return the height of the font
        Return fontObject.Height

    End Using

End Function

' The OnPaint method of a form, which provides the graphics object
Protected Overrides Sub OnPaint(e As PaintEventArgs)

    Dim location As New PointF(10, 0)
    Dim solidBrush As New SolidBrush(Color.Black)

    Dim fontFamilies() As FontFamily
    Dim privateFontCollection As New PrivateFontCollection() ' Dispose later

    ' Add three font files to the private collection.
    privateFontCollection.AddFontFile(System.Environment.ExpandEnvironmentVariables("%systemroot%\Fonts\Arial.ttf"))
    privateFontCollection.AddFontFile(System.Environment.ExpandEnvironmentVariables("%systemroot%\Fonts\CourBI.ttf"))
    privateFontCollection.AddFontFile(System.Environment.ExpandEnvironmentVariables("%systemroot%\Fonts\TimesBD.ttf"))

    ' Get the array of FontFamily objects.
    fontFamilies = privateFontCollection.Families

    ' Process each font in the collection
    For i = 0 To fontFamilies.Length - 1

        ' Draw the font in every style

        ' Regular
        If fontFamilies(i).IsStyleAvailable(FontStyle.Regular) Then
            location.Y += DrawFont(e.Graphics, fontFamilies(i), FontStyle.Regular, solidBrush, location, "Regular")
        End If

        ' Bold
        If fontFamilies(i).IsStyleAvailable(FontStyle.Bold) Then
            location.Y += DrawFont(e.Graphics, fontFamilies(i), FontStyle.Bold, solidBrush, location, "Bold")
        End If

        ' Italic
        If fontFamilies(i).IsStyleAvailable(FontStyle.Italic) Then
            location.Y += DrawFont(e.Graphics, fontFamilies(i), FontStyle.Italic, solidBrush, location, "Italic")
        End If

        ' Bold and Italic
        If fontFamilies(i).IsStyleAvailable(FontStyle.Italic) And
           fontFamilies(i).IsStyleAvailable(FontStyle.Italic) Then
            location.Y += DrawFont(e.Graphics, fontFamilies(i), FontStyle.Bold Or FontStyle.Italic, solidBrush, location, "BoldItalic")
        End If

        ' Underline
        If fontFamilies(i).IsStyleAvailable(FontStyle.Underline) Then
            location.Y += DrawFont(e.Graphics, fontFamilies(i), FontStyle.Underline, solidBrush, location, "Underline")
        End If

        ' Strikeout
        If fontFamilies(i).IsStyleAvailable(FontStyle.Strikeout) Then
            location.Y += DrawFont(e.Graphics, fontFamilies(i), FontStyle.Strikeout, solidBrush, location, "Strikeout")
        End If

        ' Extra space between font families
        location.Y += 10

    Next

    privateFontCollection.Dispose()

End Sub

Kompilera koden

Föregående exempel är utformat för användning med Windows Forms och kräver PaintEventArgse, som är en parameter för PaintEventHandler.

Se även