SetTextMode Method (GdPicturePDF)

In This Topic

Sets the text rendering mode to be used when drawing text onto the currently loaded PDF document. The text rendering mode specifies whether drawing text causes glyph outlines to be stroked, filled, used as a clipping boundary, or some combination of the three. The initial value is set to fill mode.

The text rendering mode parameter is one of the text state parameters, that only affect text. The text state parameters are initialized to their default values at the beginning of each page (see PDF Reference, Section "Text State Parameters and Operators").

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Function SetTextMode( _
   ByVal TextMode As PdfTextMode _
) As GdPictureStatus

public GdPictureStatus SetTextMode( 
   PdfTextMode TextMode
)

public function SetTextMode( 
    TextMode: PdfTextMode
): GdPictureStatus;

public function SetTextMode( 
   TextMode : PdfTextMode
) : GdPictureStatus;

public: GdPictureStatus SetTextMode( 
   PdfTextMode TextMode
)

public:
GdPictureStatus SetTextMode( 
   PdfTextMode TextMode
)

Parameters

TextMode: A member of the PdfTextMode enumeration. A new text rendering mode to set. Initial value is PdfTextMode.PdfTextModeFill.
This value is defined for use with any font you choose.

Return Value

A member of the GdPictureStatus enumeration. If the method has been successfully followed, then the return value is GdPictureStatus.OK.

We strongly recommend always checking this status first.

Remarks

This method is only allowed for use with non-encrypted documents.

As being noticed above, be aware that the text state parameters are initialized to their default values at the beginning of each page.

Example

How to set the required text mode in the PDF document in order to be able to draw text using this mode.

VB.NET
C#

Dim caption As String = "Example: SetTextMode"
Dim gdpicturePDF As New GdPicturePDF()
Dim status As GdPictureStatus = gdpicturePDF.NewPDF()
If status = GdPictureStatus.OK Then
    If gdpicturePDF.NewPage(PdfPageSizes.PdfPageSizeA4) = GdPictureStatus.OK Then
        Dim fontName As String = gdpicturePDF.AddStandardFont(PdfStandardFont.PdfStandardFontHelvetica)
        If gdpicturePDF.GetStat() = GdPictureStatus.OK Then
            If (gdpicturePDF.SetTextSize(20) = GdPictureStatus.OK) AndAlso
               (gdpicturePDF.DrawText(fontName, 100, 800, "Text mode = Fill (default)") = GdPictureStatus.OK) AndAlso
               (gdpicturePDF.SetTextMode(PdfTextMode.PdfTextModeStroke) = GdPictureStatus.OK) AndAlso
               (gdpicturePDF.DrawText(fontName, 100, 750, "Text mode = Stroke") = GdPictureStatus.OK) AndAlso
               (gdpicturePDF.SetTextMode(PdfTextMode.PdfTextModeFillStroke) = GdPictureStatus.OK) AndAlso
               (gdpicturePDF.DrawText(fontName, 100, 700, "Text mode = Fill & Stroke") = GdPictureStatus.OK) AndAlso
               (gdpicturePDF.SetTextMode(PdfTextMode.PdfTextModeFill) Then 'Resetting to the initial value.
                status = gdpicturePDF.SaveToFile("test_SetTextMode.pdf")
                If status = GdPictureStatus.OK Then
                    MessageBox.Show("The text has been successfully drawn and the file has been saved.", caption)
                Else
                    MessageBox.Show("The text has been successfully drawn," + vbCrLf + "but the file can't be saved. Status: " + status.ToString(), caption)
                End If
            Else
                MessageBox.Show("The example has not been followed successfully." + vbCrLf + "The last known status is " + gdpicturePDF.GetStat().ToString(), caption)
            End If
        Else
            MessageBox.Show("The AddStandardFont() method has failed with the status: " + status.ToString(), caption)
        End If
    Else
        MessageBox.Show("The NewPage() method has failed with the status: " + status.ToString(), caption)
    End If
Else
    MessageBox.Show("The NewPDF() method has failed with the status: " + status.ToString(), caption)
End If
gdpicturePDF.Dispose()

string caption = "Example: SetTextMode";
GdPicturePDF gdpicturePDF = new GdPicturePDF();
GdPictureStatus status = gdpicturePDF.NewPDF();
if (status == GdPictureStatus.OK)
{
    if (gdpicturePDF.NewPage(PdfPageSizes.PdfPageSizeA4) == GdPictureStatus.OK)
    {
        string fontName = gdpicturePDF.AddStandardFont(PdfStandardFont.PdfStandardFontHelvetica);
        if (gdpicturePDF.GetStat() == GdPictureStatus.OK)
        {
            if ((gdpicturePDF.SetTextSize(20) == GdPictureStatus.OK) &&
                (gdpicturePDF.DrawText(fontName, 100, 800, "Text mode = Fill (default)") == GdPictureStatus.OK) &&
                (gdpicturePDF.SetTextMode(PdfTextMode.PdfTextModeStroke) == GdPictureStatus.OK) &&
                (gdpicturePDF.DrawText(fontName, 100, 750, "Text mode = Stroke") == GdPictureStatus.OK) &&
                (gdpicturePDF.SetTextMode(PdfTextMode.PdfTextModeFillStroke) == GdPictureStatus.OK) &&
                (gdpicturePDF.DrawText(fontName, 100, 700, "Text mode = Fill & Stroke") == GdPictureStatus.OK) &&
                (gdpicturePDF.SetTextMode(PdfTextMode.PdfTextModeFill) == GdPictureStatus.OK)) //Resetting to the initial value.
            {
                status = gdpicturePDF.SaveToFile("test_SetTextMode.pdf");
                if (status == GdPictureStatus.OK)
                    MessageBox.Show("The text has been successfully drawn and the file has been saved.", caption);
                else
                    MessageBox.Show("The text has been successfully drawn,\nbut the file can't be saved. Status: " + status.ToString(), caption);
            }
            else
                MessageBox.Show("The example has not been followed successfully.\nThe last known status is " + gdpicturePDF.GetStat().ToString(), caption);
        }
        else
            MessageBox.Show("The AddStandardFont() method has failed with the status: " + status.ToString(), caption);
    }
    else
        MessageBox.Show("The NewPage() method has failed with the status: " + status.ToString(), caption);
}
else
    MessageBox.Show("The NewPDF() method has failed with the status: " + status.ToString(), caption);
gdpicturePDF.Dispose();

Reference

GdPicturePDF Class
GdPicturePDF Members
DrawText Method
AddStandardFont Method
AddTrueTypeFont Method
SetTextSize Method