wxPdfDocument 1.2.0
|
Class representing a PDF document. More...
#include <pdfdocument.h>
Public Member Functions | |
wxPdfDocument (int orientation=wxPORTRAIT, const wxString &unit=wxString(wxS("mm")), wxPaperSize format=wxPAPER_A4) | |
Constructor. | |
wxPdfDocument (int orientation, double pageWidth, double pageHeight, const wxString &unit=wxString(wxS("mm"))) | |
virtual | ~wxPdfDocument () |
virtual bool | SetProtection (int permissions, const wxString &userPassword=wxEmptyString, const wxString &ownerPassword=wxEmptyString, wxPdfEncryptionMethod encryptionMethod=wxPDF_ENCRYPTION_RC4V1, int keyLength=0) |
Set permissions as well as user and owner passwords. | |
virtual void | SetImageScale (double scale) |
Set the image scale. | |
virtual double | GetImageScale () |
Returns the image scale. | |
virtual int | GetPageOrientation () |
Returns the page orientation. | |
virtual int | GetDefaultPageOrientation () |
Returns the default page orientation. | |
virtual double | GetPageWidth () |
Returns the page width in units. | |
virtual double | GetPageHeight () |
Returns the page height in units. | |
virtual double | GetBreakMargin () |
Returns the page break margin. | |
virtual double | GetScaleFactor () |
Returns the scale factor (number of points in user unit). | |
virtual void | SetMargins (double left, double top, double right=-1) |
Defines the left, top and right margins. | |
virtual void | SetLeftMargin (double margin) |
Defines the left margin. | |
virtual double | GetLeftMargin () |
Returns the left margin. | |
virtual void | SetTopMargin (double margin) |
Defines the top margin. | |
virtual double | GetTopMargin () |
Returns the top margin. | |
virtual void | SetRightMargin (double margin) |
Defines the right margin. | |
virtual double | GetRightMargin () |
Returns the right margin. | |
virtual void | SetCellMargin (double margin) |
Defines the cell margin. | |
virtual double | GetCellMargin () |
Returns the cell margin. | |
virtual void | SetLineHeight (double height) |
Sets the height of a text line. | |
virtual double | GetLineHeight () |
Returns the height of a text line. | |
virtual void | SetAutoPageBreak (bool autoPageBreak, double margin=0) |
Enables or disables the automatic page breaking mode. | |
virtual void | SetDisplayMode (wxPdfZoom zoom, wxPdfLayout layout=wxPDF_LAYOUT_CONTINUOUS, double zoomFactor=100.) |
Defines the way the document is to be displayed by the viewer. | |
virtual void | SetPaperHandling (wxPdfPaperHandling paperHandling) |
Defines the paper handling when printing (simplex / duplex). | |
virtual void | SetKerning (bool kerning) |
Enable or disable kerning. | |
virtual void | SetCompression (bool compress) |
Activates or deactivates page compression. | |
virtual void | SetViewerPreferences (int preferences=0) |
Defines the viewer preferences. | |
virtual void | SetTitle (const wxString &title) |
Defines the title of the document. | |
virtual void | SetSubject (const wxString &subject) |
Defines the subject of the document. | |
virtual void | SetAuthor (const wxString &author) |
Defines the author of the document. | |
virtual void | SetKeywords (const wxString &keywords) |
Associates keywords with the document,. | |
virtual void | SetCreator (const wxString &creator) |
Defines the creator of the document. | |
virtual void | SetCreationDate (const wxDateTime &creationDate) |
Defines the creation timestamp of the document. | |
virtual void | AliasNbPages (const wxString &alias=wxString(wxS("{nb}"))) |
Defines an alias for the total number of pages. | |
virtual void | Open () |
This method begins the generation of the PDF document. | |
virtual void | Close () |
Terminates the PDF document. | |
virtual void | AddPage (int orientation=-1, bool useDefaultPageSize=true) |
Adds a new page to the document. | |
virtual void | AddPage (int orientation, wxPaperSize format) |
virtual void | AddPage (int orientation, double pageWidth, double pageHeight) |
virtual void | Header () |
This method is used to render the page header. | |
virtual void | Footer () |
This method is used to render the page footer. | |
virtual bool | IsInFooter () |
Returns whether footer output is in progress. | |
virtual int | PageNo () |
Returns the current page number. | |
virtual void | AddSpotColour (const wxString &name, double cyan, double magenta, double yellow, double black) |
Add spot colour. | |
virtual bool | AddPattern (const wxString &patternName, const wxImage &image, double width, double height) |
Add an image pattern. | |
virtual bool | AddPattern (const wxString &patternName, int templateId, double width, double height) |
Add a template based pattern. | |
virtual bool | AddPattern (const wxString &patternName, wxPdfPatternStyle patternStyle, double width, double height, const wxColour &drawColour, const wxColour &fillColour=wxColour()) |
Add a hatched pattern. | |
virtual void | SetDrawColour (const unsigned char grayscale) |
Defines the colour used for all drawing operations. | |
virtual void | SetDrawColour (const wxColour &colour) |
Defines the colour used for all drawing operations. | |
virtual void | SetDrawColour (const wxPdfColour &colour) |
Defines the colour used for all drawing operations. | |
virtual void | SetDrawColour (const unsigned char red, const unsigned char green, const unsigned char blue) |
Defines the colour used for all drawing operations. | |
virtual void | SetDrawColour (double cyan, double magenta, double yellow, double black) |
Defines the colour used for all drawing operations. | |
virtual void | SetDrawColour (const wxString &name, double tint=100) |
Defines the spot colour used for all drawing operations. | |
virtual void | SetDrawPattern (const wxString &name) |
Defines the pattern used for all drawing operations. | |
virtual const wxPdfColour | GetDrawColour () |
Gets the colour used for all drawing operations. | |
virtual void | SetFillColour (const unsigned char grayscale) |
Defines the colour used for all filling operations. | |
virtual void | SetFillColour (const wxColour &colour) |
Defines the colour used for all filling operations. | |
virtual void | SetFillColour (const wxPdfColour &colour) |
Defines the colour used for all filling operations. | |
virtual void | SetFillColour (const unsigned char red, const unsigned char green, const unsigned char blue) |
Defines the colour used for all filling operations. | |
virtual void | SetFillColour (double cyan, double magenta, double yellow, double black) |
Defines the colour used for all filling operations. | |
virtual void | SetFillColour (const wxString &name, double tint=100) |
Defines the spot colour used for all filling operations. | |
virtual void | SetFillPattern (const wxString &name) |
Defines the pattern used for all filling operations. | |
virtual const wxPdfColour | GetPatternColour (const wxString &patternName) |
Gets the named pattern as a colour. | |
virtual const wxPdfColour | GetFillColour () |
Gets the colour used for all filling operations. | |
virtual void | SetTextColour (const unsigned char grayscale) |
Defines the colour used for text. | |
virtual void | SetTextColour (const wxColour &colour) |
Defines the colour used for text. | |
virtual void | SetTextColour (const wxPdfColour &colour) |
Defines the colour used for text. | |
virtual void | SetTextColour (const unsigned char red, const unsigned char green, const unsigned char blue) |
Defines the colour used for text. | |
virtual void | SetTextColour (double cyan, double magenta, double yellow, double black) |
Defines the colour used for text. | |
virtual void | SetTextColour (const wxString &name, double tint=100) |
Defines the spot colour used for text. | |
virtual void | SetTextPattern (const wxString &name) |
Defines the pattern used for text output. | |
virtual const wxPdfColour | GetTextColour () |
Gets the colour used for text output. | |
virtual void | SetTextRenderMode (wxPdfTextRenderMode mode=wxPDF_TEXT_RENDER_FILL) |
Sets the text render mode. | |
virtual wxPdfTextRenderMode | GetTextRenderMode () const |
Returns the text render mode. | |
virtual double | GetStringWidth (const wxString &s, double charSpacing=0) |
Returns the length of a string in user unit. | |
virtual void | SetLineWidth (double width) |
Defines the line width. | |
virtual double | GetLineWidth () |
Gets the current line width. | |
virtual void | SetLineStyle (const wxPdfLineStyle &linestyle) |
Sets line style. | |
virtual const wxPdfLineStyle & | GetLineStyle () |
Get current line style. | |
virtual void | SetFillingRule (int rule=wxWINDING_RULE) |
Set the filling rule. | |
virtual int | GetFillingRule () |
Get the current filling rule. | |
virtual void | Line (double x1, double y1, double x2, double y2) |
Draws a line between two points. | |
virtual void | Arrow (double x1, double y1, double x2, double y2, double linewidth, double height, double width) |
Draws an arrow line between two points. | |
virtual void | Rect (double x, double y, double w, double h, int style=wxPDF_STYLE_DRAW) |
Outputs a rectangle. | |
virtual void | RoundedRect (double x, double y, double w, double h, double r, int roundCorner=wxPDF_CORNER_ALL, int style=wxPDF_STYLE_DRAW) |
Draws a rounded rectangle. | |
virtual void | Curve (double x0, double y0, double x1, double y1, double x2, double y2, double x3, double y3, int style=wxPDF_STYLE_DRAW) |
Draws a Bezier curve. | |
virtual void | Ellipse (double x0, double y0, double rx, double ry=0, double angle=0, double astart=0, double afinish=360, int style=wxPDF_STYLE_DRAW, int nSeg=8, bool doSector=false) |
Draws an ellipse. | |
virtual void | Circle (double x0, double y0, double r, double astart=0, double afinish=360, int style=wxPDF_STYLE_DRAW, int nSeg=8) |
Draws a circle. | |
virtual void | Sector (double x0, double y0, double r, double astart, double afinish, int style=wxPDF_STYLE_FILLDRAW, bool clockwise=true, double origin=90.) |
Draws a sector. | |
virtual void | Polygon (const wxPdfArrayDouble &x, const wxPdfArrayDouble &y, int style=wxPDF_STYLE_DRAW) |
Draws a polygon. | |
virtual void | RegularPolygon (double x0, double y0, double r, int ns, double angle=0, bool circle=false, int style=wxPDF_STYLE_DRAW, int circleStyle=wxPDF_STYLE_DRAW, const wxPdfLineStyle &circleLineStyle=wxPdfLineStyle(), const wxPdfColour &circleFillColour=wxPdfColour()) |
Draws a regular polygon. | |
virtual void | StarPolygon (double x0, double y0, double r, int nv, int ng, double angle=0, bool circle=false, int style=wxPDF_STYLE_DRAW, int circleStyle=wxPDF_STYLE_DRAW, const wxPdfLineStyle &circleLineStyle=wxPdfLineStyle(), const wxPdfColour &circleFillColour=wxPdfColour()) |
Draws a star polygon. | |
virtual void | BezierSpline (const wxPdfArrayDouble &x, const wxPdfArrayDouble &y, int style) |
Draws a Bezier spline through a list of points. | |
virtual void | ClosedBezierSpline (const wxPdfArrayDouble &x, const wxPdfArrayDouble &y, int style) |
Draws a closed Bezier spline through a list of points. | |
virtual void | Shape (const wxPdfShape &shape, int style=wxPDF_STYLE_DRAW) |
Draws a shape. | |
virtual void | Rotate (double angle) |
Performs a rotation around the current position. | |
virtual void | Rotate (double angle, double x, double y) |
Performs a rotation around a given center. | |
virtual void | SetFontSubsetting (bool fontSubsetting=true) |
Sets the font embedding mode. | |
virtual bool | GetFontSubsetting () const |
Returns the font embedding mode. | |
virtual bool | AddFont (const wxString &family, const wxString &style=wxEmptyString, const wxString &file=wxEmptyString) |
Imports a TrueType, TrueTypeUnicode or Type1 font and makes it available. | |
virtual bool | AddFontCJK (const wxString &family) |
Imports a CJK (Chinese, Japanese or Korean) font and makes it available. | |
virtual bool | SetFont (const wxString &family, const wxString &style=wxEmptyString, double size=0) |
Sets the font used to print character strings. | |
virtual bool | SetFont (const wxString &family, int style, double size=0) |
Sets the font used to print character strings. | |
virtual bool | SetFont (const wxPdfFont &font, int style=wxPDF_FONTSTYLE_REGULAR, double size=0) |
Sets the font used to print character strings based on a wxFont object. | |
virtual bool | SetFont (const wxFont &font) |
Sets the font used to print character strings based on a wxFont object. | |
virtual void | SetFontSize (double size) |
Defines the size of the current font. | |
virtual wxPdfFont | GetCurrentFont () const |
Returns the current font. | |
virtual const wxPdfFontDescription & | GetFontDescription () const |
Returns the current font description instance. | |
virtual const wxString | GetFontFamily () |
Gets the font family of the current font. | |
virtual const wxString | GetFontStyle () const |
Gets the style of the current font. | |
virtual int | GetFontStyles () const |
Gets the style of the current font. | |
virtual double | GetFontSize () const |
Gets the size of the current font. | |
virtual int | AddLink () |
Creates a new internal link and returns its identifier. | |
virtual bool | SetLink (int link, double y=0., int page=-1) |
Defines the page and position a link points to. | |
virtual void | Link (double x, double y, double w, double h, const wxPdfLink &link) |
Puts a link on a rectangular area of the page. | |
virtual void | Bookmark (const wxString &txt, int level=0, double y=0) |
Adds a bookmark to the document outline. | |
virtual void | Text (double x, double y, const wxString &txt) |
Prints a character string. | |
virtual void | RotatedText (double x, double y, const wxString &txt, double angle) |
Prints a rotated text string. | |
virtual void | RotatedText (double textX, double textY, double rotationX, double rotationY, const wxString &txt, double angle) |
Prints a rotated text string with explicit rotation center. | |
virtual bool | AcceptPageBreak () |
Whenever a page break condition is met,. | |
virtual void | Cell (double w, double h=0., const wxString &txt=wxEmptyString, int border=wxPDF_BORDER_NONE, int ln=0, int align=wxPDF_ALIGN_LEFT, int fill=0, const wxPdfLink &link=wxPdfLink(-1)) |
Prints a cell (rectangular area) with optional borders, background colour and character string. | |
virtual int | MultiCell (double w, double h, const wxString &txt, int border=0, int align=wxPDF_ALIGN_JUSTIFY, int fill=0, int maxline=0) |
This method allows printing text with line breaks. | |
virtual int | LineCount (double w, const wxString &txt) |
This method counts the number of lines a text would occupy in respect to a given maximal width. | |
virtual int | TextBox (double w, double h, const wxString &txt, int halign=wxPDF_ALIGN_JUSTIFY, int valign=wxPDF_ALIGN_TOP, int border=0, int fill=0) |
This method counts the number of lines a text will occupy in respect to a given maximal width. | |
virtual void | Write (double h, const wxString &txt, const wxPdfLink &link=wxPdfLink(-1)) |
This method prints text from the current position. | |
virtual void | WriteCell (double h, const wxString &txt, int border=wxPDF_BORDER_NONE, int fill=0, const wxPdfLink &link=wxPdfLink(-1)) |
This method prints text with cell attributes from the current position. | |
virtual bool | WriteGlyphArray (wxPdfArrayDouble &x, wxPdfArrayDouble &y, wxPdfArrayUint32 &glyphs) |
Prints an array of glyphs identified by glyph numbers from the current position. | |
virtual bool | Image (const wxString &file, double x, double y, double w=0, double h=0, const wxString &mimeType=wxEmptyString, const wxPdfLink &link=wxPdfLink(-1), int maskImage=0) |
Puts an image in the page. | |
virtual bool | Image (const wxString &name, const wxImage &image, double x, double y, double w=0, double h=0, const wxPdfLink &link=wxPdfLink(-1), int maskImage=0, bool jpegFormat=false, int jpegQuality=75) |
virtual bool | Image (const wxString &name, wxInputStream &stream, const wxString &mimeType, double x, double y, double w=0, double h=0, const wxPdfLink &link=wxPdfLink(-1), int maskImage=0) |
virtual int | ImageMask (const wxString &file, const wxString &mimeType=wxEmptyString) |
virtual int | ImageMask (const wxString &name, const wxImage &image) |
virtual int | ImageMask (const wxString &name, wxInputStream &stream, const wxString &mimeType) |
virtual void | RotatedImage (const wxString &file, double x, double y, double w, double h, double angle, const wxString &type=wxEmptyString, const wxPdfLink &link=wxPdfLink(-1), int maskImage=0) |
Puts a rotated image in the page. | |
virtual double | GetLastImageBottomRightX () |
Get x coordinate of bottom right corner of last inserted image. | |
virtual double | GetLastImageBottomRightY () |
Get y coordinate of bottom right corner of last inserted image. | |
virtual void | Ln (double h=-1) |
Performs a line break. | |
virtual double | GetX () |
Returns the abscissa of the current position. | |
virtual void | SetX (double x) |
Defines the abscissa of the current position. | |
virtual double | GetY () |
Returns the ordinate of the current position. | |
virtual void | SetY (double y) |
Moves the current abscissa back to the left margin and sets the ordinate. | |
virtual void | SetXY (double x, double y) |
Defines the abscissa and ordinate of the current position. | |
virtual bool | SaveAsFile (const wxString &name=wxEmptyString) |
Saves the document to a file on disk. | |
virtual const wxMemoryOutputStream & | CloseAndGetBuffer () |
Closes the document and returns the memory buffer containing the document. | |
virtual void | ClippingText (double x, double y, const wxString &txt, bool outline=false) |
Define text as clipping area. | |
virtual void | ClippingRect (double x, double y, double w, double h, bool outline=false) |
Define rectangle as clipping area. | |
virtual void | ClippingEllipse (double x, double y, double rx, double ry=0, bool outline=false) |
Define ellipse as clipping area. | |
virtual void | ClippingPolygon (const wxPdfArrayDouble &x, const wxPdfArrayDouble &y, bool outline=false) |
Define polygon as clipping area. | |
virtual void | ClippingPath () |
Start defining a clipping path. | |
virtual void | MoveTo (double x, double y) |
Begin a new subpath. | |
virtual void | LineTo (double x, double y) |
Append a straight line segment to the current (sub)path. | |
virtual void | CurveTo (double x1, double y1, double x2, double y2, double x3, double y3) |
Append a cubic Bezier curve to the current (sub)path. | |
virtual void | EndPath (int style=wxPDF_STYLE_DRAW) |
End a graphics path. | |
virtual void | ClosePath (int style=wxPDF_STYLE_NOOP) |
Close the clipping path. | |
virtual void | ClippingPath (const wxPdfShape &shape, int style=wxPDF_STYLE_NOOP) |
Define clipping area using a shape. | |
virtual void | UnsetClipping () |
Remove clipping area. | |
virtual void | ClippedCell (double w, double h=0., const wxString &txt=wxEmptyString, int border=wxPDF_BORDER_NONE, int ln=0, int align=wxPDF_ALIGN_LEFT, int fill=0, const wxPdfLink &link=wxPdfLink(-1)) |
Prints a cell clipped to a rectangular area. | |
virtual void | StartTransform () |
Enters a transformation environment. | |
virtual bool | ScaleX (double sx) |
Performs scaling in X direction only with the current position as the scaling center. | |
virtual bool | ScaleX (double sx, double x, double y) |
Performs scaling in X direction only. | |
virtual bool | ScaleY (double sy) |
Performs scaling in Y direction only with the current position as the scaling center. | |
virtual bool | ScaleY (double sy, double x, double y) |
Performs scaling in Y direction only. | |
virtual bool | ScaleXY (double s) |
Performs equal scaling in X and Y direction with the current position as the scaling center. | |
virtual bool | ScaleXY (double s, double x, double y) |
Performs equal scaling in X and Y direction. | |
virtual bool | Scale (double sx, double sy) |
Performs scaling in X and Y direction with the current position as the scaling center. | |
virtual bool | Scale (double sx, double sy, double x, double y) |
Performs scaling in X and Y direction. | |
virtual void | MirrorH () |
Performs a horizontal mirroring transformation. | |
virtual void | MirrorH (double x) |
Performs a horizontal mirroring transformation. | |
virtual void | MirrorV () |
Performs a vertical mirroring transformation. | |
virtual void | MirrorV (double y) |
Performs a vertical mirroring transformation. | |
virtual void | TranslateX (double tx) |
Moves the X origin. | |
virtual void | TranslateY (double ty) |
Moves the Y origin. | |
virtual void | Translate (double tx, double ty) |
Moves the origin. | |
virtual bool | SkewX (double xAngle) |
Performs a skewing in X direction only with the current position as the skewing center. | |
virtual bool | SkewX (double xAngle, double x, double y) |
Performs a skewing in both X direction only. | |
virtual bool | SkewY (double yAngle) |
Performs a skewing in Y direction only with the current position as the skewing center. | |
virtual bool | SkewY (double yAngle, double x, double y) |
Performs a skewing in Y direction only. | |
virtual bool | Skew (double xAngle, double yAngle) |
Performs a skewing in both X and Y directions with the current position as the skewing center. | |
virtual bool | Skew (double xAngle, double yAngle, double x, double y) |
Performs a skewing in both X and Y directions. | |
virtual void | Transform (double a, double b, double c, double d, double tx, double ty) |
virtual void | StopTransform () |
Leaves a transformation environment. | |
virtual int | SetAlpha (double lineAlpha=1, double fillAlpha=1, wxPdfBlendMode blendMode=wxPDF_BLENDMODE_NORMAL) |
Sets alpha values and blend mode. | |
virtual void | SetAlphaState (int alphaState) |
Sets a previously defined alpha state. | |
virtual int | LinearGradient (const wxPdfColour &col1, const wxPdfColour &col2, wxPdfLinearGradientType gradientType=wxPDF_LINEAR_GRADIENT_HORIZONTAL) |
Defines a linear gradient shading. | |
virtual int | AxialGradient (const wxPdfColour &col1, const wxPdfColour &col2, double x1=0, double y1=0, double x2=1, double y2=0, double intexp=1) |
Defines a axial gradient shading. | |
virtual int | MidAxialGradient (const wxPdfColour &col1, const wxPdfColour &col2, double x1=0, double y1=0, double x2=1, double y2=0, double midpoint=0.5, double intexp=1) |
Defines a axial gradient shading. | |
virtual int | RadialGradient (const wxPdfColour &col1, const wxPdfColour &col2, double x1=0.5, double y1=0.5, double r1=0, double x2=0.5, double y2=0.5, double r2=1, double intexp=1) |
Defines a radial gradient shading. | |
virtual int | CoonsPatchGradient (const wxPdfCoonsPatchMesh &mesh, double minCoord=0, double maxCoord=1) |
Defines a coons patch mesh gradient shading. | |
virtual void | SetFillGradient (double x, double y, double w, double h, int gradient) |
Paints a gradient shading to rectangular area. | |
virtual void | Marker (double x, double y, wxPdfMarker markerType, double size) |
Draws a graphical marker symbol. | |
virtual void | Annotate (double x, double y, const wxString &text) |
Adds a text annotation. | |
virtual void | AppendJavascript (const wxString &javascript) |
Appends Javascript. | |
virtual void | WriteXml (const wxString &str) |
Prints a string containing simple XML markup. | |
virtual void | CheckBox (const wxString &name, double width, bool checked=false) |
Adds a check box field at the current position. | |
virtual void | CheckBox (const wxString &name, double x, double y, double width, bool checked=false) |
Adds a check box field. | |
virtual void | ComboBox (const wxString &name, double width, double height, const wxArrayString &values) |
Adds a combo box field at the current position. | |
virtual void | ComboBox (const wxString &name, double x, double y, double width, double height, const wxArrayString &values) |
Adds a combo box field. | |
virtual void | PushButton (const wxString &name, double width, double height, const wxString &caption, const wxString &action) |
Adds a push button at the current position. | |
virtual void | PushButton (const wxString &name, double x, double y, double width, double height, const wxString &caption, const wxString &action) |
Adds a push button. | |
virtual void | RadioButton (const wxString &group, const wxString &name, double width) |
Adds a radio button at the current position. | |
virtual void | RadioButton (const wxString &group, const wxString &name, double x, double y, double width) |
Adds a radio button. | |
virtual void | TextField (const wxString &name, double width, double height, const wxString &value=wxEmptyString, bool multiline=false) |
Adds a text field at the current position. | |
virtual void | TextField (const wxString &name, double x, double y, double width, double height, const wxString &value=wxEmptyString, bool multiline=false) |
Adds a text field. | |
virtual void | SetFormColours (const wxPdfColour &borderColour=wxPdfColour(), const wxPdfColour &backgroundColour=wxPdfColour(250), const wxPdfColour &textColour=wxPdfColour()) |
Sets colours for form fields. | |
virtual void | SetFormBorderStyle (wxPdfBorderStyle borderStyle=wxPDF_BORDER_SOLID, double borderWidth=-1) |
Sets the border style for form fields. | |
virtual int | BeginTemplate (double x=0, double y=0, double width=0, double height=0) |
Starts a new Template. | |
virtual int | EndTemplate () |
Terminates a template. | |
virtual void | GetTemplateSize (int templateId, double &width, double &height) |
Get the calculated size of a template. | |
virtual void | UseTemplate (int templateId) |
Uses a template in current page or in another template. | |
virtual void | UseTemplate (int templateId, double x, double y, double width=0, double height=0) |
Uses a template in current page or in another template. | |
virtual int | SetSourceFile (const wxString &filename, const wxString &password=wxEmptyString) |
Sets a source file for the external template feature. | |
virtual bool | GetSourceInfo (wxPdfInfo &info) |
Gets the document information dictionary of the current external PDF document. | |
virtual int | ImportPage (unsigned int pageno, wxPdfPageBox pageBox=wxPDF_PAGEBOX_ARTBOX) |
Imports a page from an external PDF document. | |
virtual void | GetTemplateBBox (int templateId, double &x, double &y, double &width, double &height) |
Gets the bounding box of a template. | |
virtual void | SetTemplateBBox (int templateId, double x, double y, double width, double height) |
Sets the bounding box of a template. | |
virtual void | ShapedText (const wxPdfShape &shape, const wxString &text, wxPdfShapedTextMode mode=wxPDF_SHAPEDTEXTMODE_STRETCHTOFIT) |
Prints a text string along a path defined by a shape. | |
virtual wxPdfLayer * | AddLayer (const wxString &layerName) |
Add a layer. | |
virtual wxPdfLayer * | AddLayerTitle (const wxString &layerTitle) |
Add a title layer. | |
virtual wxPdfLayerMembership * | AddLayerMembership () |
Add a layer membership container. | |
virtual void | LockLayer (wxPdfLayer *layer) |
Lock a layer. | |
virtual void | AddLayerRadioGroup (const wxPdfLayerGroup &radioGroup) |
Add a radio group of layers. | |
virtual void | EnterLayer (wxPdfLayer *layer) |
Enter a layer. | |
virtual void | EnterLayer (wxPdfLayerMembership *layer) |
virtual void | LeaveLayer () |
Leave a layer. | |
virtual bool | AttachFile (const wxString &fileName, const wxString &attachName=wxEmptyString, const wxString &description=wxEmptyString) |
Attach file. | |
void | SetPdfA1Conformance (bool enable) |
Set PDF/A-1b conformance. | |
bool | GetPdfA1Conformance () const |
Get PDF/A-1b conformance. | |
void | SetMessageTranslateMode (bool translate) |
Set message translation mode. | |
bool | GetMessageTranslateMode () |
Get message translation mode. | |
Protected Member Functions | |
virtual void | Initialize (int orientation) |
Initialize. | |
virtual void | SaveGraphicState () |
Save graphic state. | |
virtual void | RestoreGraphicState () |
Restore graphic state. | |
virtual void | ClearGraphicState () |
Clear graphic state. | |
virtual bool | SelectFont (const wxString &family, const wxString &style=wxEmptyString, double size=0, bool setFont=true) |
Select font. | |
virtual bool | SelectFont (const wxString &family, int style, double size=0, bool setFont=true) |
Select font. | |
virtual bool | SelectFont (const wxFont &font, bool setFont=true) |
Select font based on wxFont object. | |
virtual bool | SelectFont (const wxPdfFont &font, int style, double size=0, bool setFont=true) |
Select font based on wxFont object. | |
virtual void | ForceCurrentFont () |
Force selecting the current font. | |
virtual void | SetFontSize (double size, bool setSize) |
Defines the size of the current font. | |
virtual wxString | ApplyVisualOrdering (const wxString &txt) |
Apply visual ordering. | |
virtual double | DoGetStringWidth (const wxString &s, double charSpacing=0) |
Returns the length of a string in user unit. | |
virtual void | DoCell (double w, double h=0., const wxString &txt=wxEmptyString, int border=wxPDF_BORDER_NONE, int ln=0, int align=wxPDF_ALIGN_LEFT, int fill=0, const wxPdfLink &link=wxPdfLink(-1)) |
Prints a cell (rectangular area) with optional borders, background colour and character string. | |
virtual wxSize | GetImageSize (const wxString &file, const wxString &mimeType=wxEmptyString) |
Get size of an image. | |
virtual void | BeginPage (int orientation, wxSize pageSize) |
Start document. | |
virtual void | EndPage () |
End of page contents. | |
virtual void | EndDoc () |
End dociment. | |
virtual void | PutHeader () |
Add header. | |
virtual void | PutPages () |
Add pages. | |
virtual void | ReplaceNbPagesAlias () |
Replace page number aliases. | |
virtual void | PutResources () |
Add resources. | |
virtual void | PutBookmarks () |
Add bookmarks. | |
virtual void | PutExtGStates () |
Add extended graphics states. | |
virtual void | PutShaders () |
Add shaders. | |
virtual void | PutFonts () |
Adds fonts. | |
virtual void | PutImages () |
Add images. | |
virtual void | PutTemplates () |
Add templates. | |
virtual void | PutImportedObjects () |
Add imported objects. | |
virtual void | WriteObjectValue (wxPdfObject *value, bool newline=true) |
virtual void | PutSpotColours () |
Add spot colours. | |
virtual void | InitPatternIds () |
Initialize object ids of patterns. | |
virtual void | PutPatterns () |
Add patterns. | |
virtual void | PutLayers () |
Add layers. | |
void | PutOCProperties () |
Add optional content properties. | |
void | PutOCGOrder (wxPdfLayer *layer) |
Add optional content order. | |
void | PutASEvent (const wxString &situation, const wxString &category, bool &first) |
Add automatic state event. | |
virtual void | PutJavaScript () |
Add Javascript (document level) | |
virtual void | PutFiles () |
Add attached files. | |
virtual void | PutResourceDict () |
Add resource dictionary. | |
virtual void | PutEncryption () |
Add encryption info. | |
virtual void | PutFormFields () |
Add form fields. | |
virtual void | PutInfo () |
Add info. | |
virtual void | PutColourProfile () |
Add colour profile. | |
virtual void | PutMetaData () |
Add XMP meta data. | |
virtual void | PutCatalog () |
Add catalog. | |
virtual void | PutXObjectDict () |
Add object dictionary. | |
virtual void | PutTrailer () |
Add trailer. | |
size_t | CalculateStreamLength (size_t len) |
Calculate stream size. | |
size_t | CalculateStreamOffset () |
Calculate stream offset. | |
int | GetNewObjId () |
Get new object id. | |
void | NewObj (int objId=0) |
Begin a new object. | |
wxString | DoDecoration (double x, double y, const wxString &txt) |
Decorate text. | |
void | ShowText (const wxString &txt) |
Show text string, with kerning if requested. | |
void | ShowGlyph (wxUint32 glyph) |
Show a single glyph. | |
void | TextEscape (const wxString &s, bool newline=true) |
Format a text string. | |
void | PutStream (wxMemoryOutputStream &s) |
Add byte stream. | |
void | OutTextstring (const wxString &s, bool newline=true) |
Add a text string to the document. | |
void | OutRawTextstring (const wxString &s, bool newline=true) |
Add a raw text string to the document (without charset conversion) | |
void | OutHexTextstring (const wxString &s, bool newline=true) |
Add a hex text string to the document (without charset conversion) | |
void | OutAsciiTextstring (const wxString &s, bool newline=true) |
Add an ASCII text string to the document. | |
void | OutEscape (const char *s, size_t len) |
Add \ before \, ( and ) | |
void | OutEscape (const std::string &s) |
Add \ before \, ( and ) | |
void | OutHex (const char *s, size_t len) |
Add a hex string to the document. | |
void | OutHex (const std::string &s) |
Add a hex string to the document. | |
void | OutAscii (const wxString &s, bool newline=true) |
Add ASCII string. | |
void | Out (const char *s, bool newline=true) |
Add character string. | |
void | Out (const char *s, size_t len, bool newline=true) |
Add len characters. | |
void | OutPoint (double x, double y) |
Sets a draw point. | |
void | OutPointRelative (double dx, double dy) |
Sets a draw point relative to current position. | |
void | OutLine (double x, double y) |
Draws a line from last draw point. | |
void | OutLineRelative (double dx, double dy) |
Draws a line relative from last draw point. | |
void | OutCurve (double x1, double y1, double x2, double y2, double x3, double y3) |
Draws a Bézier curve from last draw point. | |
void | Transform (double tm[6]) |
Perform transformation. | |
void | AddFormField (wxPdfAnnotationWidget *field, bool setFormField=true) |
Adds a form field to the document. | |
void | OutIndirectObject (wxPdfIndirectObject *object) |
Add an indirect object to the document. | |
void | OutImage (wxPdfImage *currentImage, double x, double y, double w, double h, const wxPdfLink &link) |
Add an image object to the document. | |
void | WriteXml (wxXmlNode *node) |
Write XML using XML node. | |
void | PrepareXmlCell (wxXmlNode *node, wxPdfCellContext &context) |
Prepare an XML cell for output. | |
void | WriteXmlCell (wxXmlNode *node, wxPdfCellContext &context) |
Output a prepared XML cell. | |
void | DoXmlAlign (wxPdfCellContext &context) |
Take alignment of an XML cell into account. | |
void | PrepareXmlTable (wxXmlNode *node, wxPdfCellContext &context) |
Prepare an XML table for output. | |
void | WriteXmlTable (wxPdfCellContext &context) |
Output a prepared XML table. | |
void | SetScaleFactor (const wxString &unit) |
Set internal scale factor. | |
wxSize | CalculatePageSize (wxPaperSize format) |
wxSize | CalculatePageSize (double pageWidth, double pageHeight) |
virtual void | AddPage (int orientation, wxSize pageSize) |
void | LoadZapfDingBats () |
double | GetHeaderHeight () const |
Friends | |
class | wxPdfImage |
class | wxPdfTable |
Class representing a PDF document.
wxPdfDocument::wxPdfDocument | ( | int | orientation = wxPORTRAIT, |
const wxString & | unit = wxString(wxS("mm")), | ||
wxPaperSize | format = wxPAPER_A4 ) |
Constructor.
orientation | Defines the default page orientation. Possible values are:
|
unit | Defines the user units. Possible values are:
|
format | Defines the page format. All known wxWidgets paper types are allowed. (Default: wxPAPER_A4) |
wxPdfDocument::wxPdfDocument | ( | int | orientation, |
double | pageWidth, | ||
double | pageHeight, | ||
const wxString & | unit = wxString(wxS("mm")) ) |
|
virtual |
|
virtual |
Whenever a page break condition is met,.
Whenever a page break condition is met, the method is called, and the break is issued or not depending on the returned value. The default implementation returns a value according to the mode selected by SetAutoPageBreak()
This method is called automatically and should not be called directly by the application.
|
virtual |
Imports a TrueType, TrueTypeUnicode or Type1 font and makes it available.
It is necessary to generate a font definition file first with the makefont utility. The definition file (and the font file itself when embedding) must be present either in the subdirectory 'fonts' of the current working directory or in the one indicated by WXPDF_FONTPATH if this environment variable is defined.
family | Font family. The name can be chosen arbitrarily. If it is a standard family name, it will override the corresponding font. |
style | Font style. Possible values are (case insensitive):
|
file | The font definition file. By default, the name is built from the family and style, in lower case with no space. |
|
virtual |
Imports a CJK (Chinese, Japanese or Korean) font and makes it available.
It is necessary to generate a font definition file first with the makefont utility. The definition file (and the font file itself when embedding) must be present either in the current directory or in the one indicated by WXPDF_FONTPATH if the constant is defined.
family | Font family. The name can be chosen arbitrarily. If it is a standard family name, it will override the corresponding font. |
All font styles (regular, bold, italic and bold-italic) are made available The font definition file name is built from the family in lower case with no space. There are several predefined font definition files available:
These fonts require that the Adobe CJK font support is installed
|
protected |
Adds a form field to the document.
|
virtual |
Add a layer.
An optional content group represents a collection of graphics that can be made visible or invisible dynamically by users of viewer applications. In wxPdfDocument they are referenced as layers.
layerName | the name of the layer |
|
virtual |
Add a layer membership container.
Content typically belongs to a single optional content group, and is visible when the group is ON and invisible when it is OFF. To express more complex visibility policies, content should not declare itself to belong to an optional content group directly, but rather to an optional content membership container.
|
virtual |
Add a radio group of layers.
Use this method to set a collection of optional content groups whose states are intended to follow a "radio button" paradigm. That is, the state of at most one optional content group in the array should be ON at a time: if one group is turned ON, all others must be turned OFF.
radioGroup | the radio group |
|
virtual |
Add a title layer.
Creates a title layer. A title layer is not really a layer but a collection of layers under the same title heading.
layerTitle | the title text |
|
virtual |
|
virtual |
|
virtual |
|
protectedvirtual |
|
virtual |
Adds a new page to the document.
If a page is already present, the Footer() method is called first to output the footer. Then the page is added, the current position set to the top-left corner according to the left and top margins, and Header() is called to display the header. The font which was set before calling is automatically restored. There is no need to call SetFont() again if you want to continue with the same font. The same is true for colours and line width. The origin of the coordinate system is at the top-left corner and increasing ordinates go downwards.
orientation | Page orientation. Possible values are:
|
useDefaultPageSize | Flag whether to use the default page size or the current page size |
|
virtual |
Add an image pattern.
Add an image pattern which can be referenced in draw or fill pattern methods
patternName | the name of the pattern (case sensitive) |
image | the image to be used as a pattern |
width | the display width of the pattern |
height | the display height of the pattern |
|
virtual |
Add a template based pattern.
Add a template based pattern which can be referenced in draw or fill pattern methods
patternName | the name of the pattern (case sensitive) |
templateId | the id of the template to be used as a pattern |
width | the display width of the pattern |
height | the display height of the pattern |
|
virtual |
Add a hatched pattern.
Add a hatched pattern which can be referenced in draw or fill pattern methods
patternName | the name of the pattern (case sensitive) |
patternStyle | the pattern style to be used as a pattern |
width | the display width |
height | the display height |
drawColour | the foreground colour used for hatching |
fillColour | the background colour to fill the pattern background (optional) |
|
virtual |
Add spot colour.
Add a spot colour which can be referenced in colour setting methods
name | the name of the spot colour (case sensitive) |
cyan | indicates the cyan level. Value between 0 and 100 |
magenta | indicates the magenta level. Value between 0 and 100 |
yellow | indicates the yellow level. Value between 0 and 100 |
black | indicates the black level. Value between 0 and 100 |
|
virtual |
|
virtual |
Adds a text annotation.
x | abscissa of the annotation symbol |
y | ordinate of the annotation symbol |
text | annotation text |
|
virtual |
Appends Javascript.
Allows to append Javascript code to a Javascript object at the document level.
javascript | Javascript code to be appended |
|
protectedvirtual |
Apply visual ordering.
|
virtual |
Draws an arrow line between two points.
x1 | Abscissa of first point |
y1 | Ordinate of first point |
x2 | Abscissa of second point |
y2 | Ordinate of second point |
linewidth | line width |
height | height of the arrow head |
width | width of the arrow head |
|
virtual |
Attach file.
Attaches a file to the PDF document.
fileName | path to the file to attach |
attachName | the name under which the file will be attached (dfeault: filename) |
description | an optional description |
|
virtual |
Defines a axial gradient shading.
col1 | first colour (RGB or CMYK). |
col2 | second colour (RGB or CMYK). |
x1 | start point of gradient vector, default: 0 (range 0 .. 1) |
y1 | start point of gradient vector, default: 0 (range 0 .. 1) |
x2 | end point of gradient vector, default: 1 (range 0 .. 1) |
y2 | end point of gradient vector, default: 0 (range 0 .. 1) |
intexp | interpolation exponent, default: 1 |
|
protectedvirtual |
Start document.
|
virtual |
Starts a new Template.
Starts a new template, optionally with own dimensions. The margins have to adapted to the new template size. For writing outside the template, for example to build a clipped template, the margins and "cursor" position have to be set manually after the call to BeginTemplate().
If no dimensions are given, the template uses the current page size. The method returns the ID of the current template. The ID is used to reference a template in the UseTemplate() method. Warning: A template once created is embedded in the resulting PDF document at all events, even if it is not used.
x | The x-coordinate given in user units |
y | The y-coordinate given in user units |
width | The width given in user units |
height | The height given in user units |
Attention: Calls to BeginTemplate can not be nested!
|
virtual |
Draws a Bezier spline through a list of points.
x | Array with abscissa values |
y | Array with ordinate values |
style | Style of the spline (draw and/or fill) |
|
virtual |
Adds a bookmark to the document outline.
txt | the bookmark title. |
level | the bookmark level (0 is top level, 1 is just below, and so on). |
y | the y position of the bookmark destination in the current page. -1 means the current position. Default value: 0. |
|
protected |
|
protected |
|
protected |
Calculate stream size.
|
protected |
Calculate stream offset.
|
virtual |
Prints a cell (rectangular area) with optional borders, background colour and character string.
The upper-left corner of the cell corresponds to the current position. The text can be aligned or centered. After the call, the current position moves to the right or to the next line. It is possible to put a link on the text. If automatic page breaking is enabled and the cell goes beyond the limit, a page break is done before outputting.
w | Cell width. If 0, the cell extends up to the right margin. |
h | Cell height. Default value: 0. |
txt | String to print. Default value: empty string. |
border | Indicates if borders must be drawn around the cell. The value can be
|
ln | Indicates where the current position should go after the call. Possible values are:
|
align | Allows to center or align the text. Possible values are:
|
fill | Indicates if the cell background must be painted (1) or transparent (0). Default value: 0. |
link | URL or identifier returned by AddLink(). |
|
virtual |
Adds a check box field at the current position.
Adds a check box to the list of form fields at the current position
name | field name of the check box |
width | width of the check box |
checked | default value of the check box |
|
virtual |
Adds a check box field.
Adds a check box to the list of form fields
name | field name of the check box |
x | abscissa of the check box position |
y | ordinate of the check box position |
width | width of the check box |
checked | default value of the check box |
|
virtual |
Draws a circle.
x0 | Abscissa of Center point |
y0 | Ordinate of Center point |
r | Radius |
astart | Start angle |
afinish | Finish angle |
style | Style of rectangle (draw and/or fill) |
nSeg | Circle is made up of nSeg Bezier curves |
|
protectedvirtual |
Clear graphic state.
|
virtual |
Prints a cell clipped to a rectangular area.
The upper-left corner of the cell corresponds to the current position. The text can be aligned or centered. After the call, the current position moves to the right or to the next line. It is possible to put a link on the text. If automatic page breaking is enabled and the cell goes beyond the limit, a page break is done before outputting.
w | Cell width. |
h | Cell height. |
txt | String to print. Default value: empty string. |
border | Indicates if borders must be drawn around the cell. The value can be
|
ln | Indicates where the current position should go after the call. Possible values are:
|
align | Allows to center or align the text. Possible values are:
|
fill | Indicates if the cell background must be painted (1) or transparent (0). Default value: 0. |
link | URL or identifier returned by AddLink(). |
|
virtual |
Define ellipse as clipping area.
A clipping area restricts the display and prevents any elements from showing outside of it.
x | Abscissa of the Center point |
y | Ordinate of the Center point |
rx | Horizontal radius |
ry | Vertical radius (if ry = 0, draws a circle) |
outline | Draw the outline or not. (Default false) |
|
virtual |
Start defining a clipping path.
A clipping area restricts the display and prevents any elements from showing outside of it. The clipping path may consist of one or more subpaths.
|
virtual |
Define clipping area using a shape.
A clipping area restricts the display and prevents any elements from showing outside of it.
shape | shape defining the clipping path |
style | Style of rendering. Possible values are:
|
|
virtual |
Define polygon as clipping area.
A clipping area restricts the display and prevents any elements from showing outside of it.
x | Array with abscissa values |
y | Array with ordinate values |
outline | Draw the outline or not. (Default false) |
|
virtual |
Define rectangle as clipping area.
A clipping area restricts the display and prevents any elements from showing outside of it.
x | Abscissa of the upper-left corner |
y | Ordinate of the upper-left corner |
w | Width of the rectangle |
h | Height of the rectangle |
outline | Draw the outline or not. |
|
virtual |
Define text as clipping area.
A clipping area restricts the display and prevents any elements from showing outside of it.
x | Abscissa of the origin |
y | Ordinate of the origin |
txt | String to print |
outline | Draw the outline or not. |
|
virtual |
Terminates the PDF document.
It is not necessary to call this method explicitly because SaveAsFile() does it automatically. If the document contains no page, AddPage() is called to prevent from getting an invalid document.
|
virtual |
|
virtual |
Draws a closed Bezier spline through a list of points.
x | Array with abscissa values |
y | Array with ordinate values |
style | Style of the spline (draw and/or fill) |
|
virtual |
Close the clipping path.
A clipping area restricts the display and prevents any elements from showing outside of it.
style | Style of rendering. Possible values are:
|
|
virtual |
Adds a combo box field at the current position.
Adds a combo box to the list of form fields at the current position
name | field name of the combo box |
width | width of the combo box |
height | height of the combo box |
values | array of option values of the combo box |
|
virtual |
Adds a combo box field.
Adds a combo box to the list of form fields
name | field name of the combo box |
x | abscissa of the combo box position |
y | ordinate of the combo box position |
width | width of the combo box |
height | height of the combo box |
values | array of option values of the combo box |
|
virtual |
Defines a coons patch mesh gradient shading.
mesh | coons patch mesh to be used for the gradient |
minCoord | minimal coordinate of the mesh |
maxCoord | maximal coordinate of the mesh |
|
virtual |
Draws a Bezier curve.
A Bezier curve is tangent to the line between the control points at either end of the curve.
x0 | Abscissa of start point |
y0 | Ordinate of start point |
x1 | Abscissa of control point 1 |
y1 | Ordinate of control point 1 |
x2 | Abscissa of control point 2 |
y2 | Ordinate of control point 2 |
x3 | Abscissa of end point |
y3 | Ordinate of end point |
style | Style of rectangle (draw and/or fill) |
|
virtual |
Append a cubic Bezier curve to the current (sub)path.
Append a cubic Bezier curve to the current path. The curve extends from the current point to the point (x3, y3), using (x1, y1) and (x2, y2) as the Bézier control points. The new current point is (x3, y3).
x1 | Abscissa of control point 1 |
y1 | Ordinate of control point 1 |
x2 | Abscissa of control point 2 |
y2 | Ordinate of control point 2 |
x3 | Abscissa of end point |
y3 | Ordinate of end point |
|
protectedvirtual |
Prints a cell (rectangular area) with optional borders, background colour and character string.
|
protected |
Decorate text.
|
protectedvirtual |
Returns the length of a string in user unit.
A font must be selected.
s | The string whose length is to be computed |
charSpacing | Extra amount of spacing between characters (optional) |
|
protected |
Take alignment of an XML cell into account.
|
virtual |
Draws an ellipse.
x0 | Abscissa of Center point |
y0 | Ordinate of Center point |
rx | Horizontal radius |
ry | Vertical radius (if ry = 0, draws a circle) |
angle | Orientation angle (anti-clockwise) |
astart | Start angle |
afinish | Finish angle |
style | Style of rectangle (draw and/or fill) |
nSeg | Ellipse is made up of nSeg Bezier curves |
doSector | connect end points of elliptic arc with center point |
|
protectedvirtual |
End dociment.
|
protectedvirtual |
End of page contents.
|
virtual |
End a graphics path.
style | Style of rendering. Possible values are:
|
|
virtual |
Terminates a template.
Terminates the creation of a template and reset initiated variables on beginTemplate.
|
virtual |
Enter a layer.
Begins a graphic block whose visibility is controlled by the layer
. Blocks can be nested. Each block must be terminated by LeaveLayer().
Note that nested layers only require a single call to this method and a single call to LeaveLayer(); all the nesting control is built in.
layer | the layer |
|
virtual |
|
virtual |
This method is used to render the page footer.
It is automatically called by AddPage() and Close() and should not be called directly by the application. The implementation in wxPdfDocument is empty, so you have to subclass it and override the method if you want a specific processing.
|
protectedvirtual |
Force selecting the current font.
|
virtual |
Returns the page break margin.
|
virtual |
Returns the cell margin.
|
virtual |
|
virtual |
Returns the default page orientation.
|
virtual |
Gets the colour used for all drawing operations.
|
virtual |
Gets the colour used for all filling operations.
|
virtual |
Get the current filling rule.
|
virtual |
Returns the current font description instance.
|
virtual |
Gets the font family of the current font.
|
virtual |
Gets the size of the current font.
|
virtual |
Gets the style of the current font.
|
virtual |
|
inlinevirtual |
Returns the font embedding mode.
|
protected |
|
virtual |
Returns the image scale.
|
protectedvirtual |
Get size of an image.
The size of the image is determined from the given graphics file.
file | Name of the file containing the image. |
mimeType | Image format. Possible values are: image/jpeg, image/png, image/gif, image/wmf. |
|
inlinevirtual |
Get x coordinate of bottom right corner of last inserted image.
|
inlinevirtual |
Get y coordinate of bottom right corner of last inserted image.
|
virtual |
Returns the left margin.
|
virtual |
Returns the height of a text line.
|
virtual |
Get current line style.
|
virtual |
|
inline |
Get message translation mode.
Gets the message translation mode which controls the handling of msg tags in XML output
|
protected |
Get new object id.
|
virtual |
Returns the page height in units.
|
virtual |
Returns the page orientation.
|
virtual |
Returns the page width in units.
|
virtual |
Gets the named pattern as a colour.
patternName | the name of the pattern |
|
inline |
Get PDF/A-1b conformance.
Gets the document conformance intent for PDF/A-1 Level B
|
virtual |
Returns the right margin.
|
virtual |
Returns the scale factor (number of points in user unit).
|
virtual |
Gets the document information dictionary of the current external PDF document.
Gets the values of the Info dictionary of the current external document, if available.
info | the info dictionary object receiving the document information |
|
virtual |
Returns the length of a string in user unit.
A font must be selected.
s | The string whose length is to be computed |
charSpacing | Extra amount of spacing between characters (optional) |
|
virtual |
Gets the bounding box of a template.
Especially for pages imported from an external PDF document the size of the bounding box might be of interest. The values returned correspond to the coordinates of the lower left corner and the width and height of the template.
templateId | A valid template ID |
x | The x coordinate of the lower left corner |
y | The y coordinate of the lower left corner |
width | The width of the template |
height | The height of the template |
|
virtual |
Get the calculated size of a template.
Retrieves the size of a template.
templateId | A valid template ID |
width | The width of the template |
height | The height of the template |
Attention: The width and/or height parameters have to be set to a value <= 0 prior to calling this method, otherwise they will not be calculated. If one dimension, i.e. width, is passed with a value > 0, the other one, i.e. height, is calculated accordingly.
|
virtual |
Gets the colour used for text output.
|
virtual |
Returns the text render mode.
|
virtual |
Returns the top margin.
|
virtual |
|
virtual |
|
virtual |
This method is used to render the page header.
It is automatically called by AddPage() and should not be called directly by the application. The implementation in wxPdfDocument is empty, so you have to subclass it and override the method if you want a specific processing.
|
virtual |
Puts an image in the page.
The upper-left corner must be given. The dimensions can be specified in different ways:
Supported formats are JPEG, PNG, GIF and WMF. For JPEG, all flavors are allowed:
For PNG, the following flavors are allowed:
but the following options are not supported:
If a transparent colour is defined, it will be taken into account (but will be only interpreted by Acrobat 4 and above).
For GIF, all flavors the wxWidgets GIF decoder is able to handle are supported
For WMF: WMF files contain vector data described in terms of Windows Graphics Device Interface (GDI) commands. There are approximately 80 different GDI commands allowed for in the WMF standard. This method interprets only a small subset of these, but is sufficient to display most WMF images. Please feel free to add further functionality.
The format can be specified explicitly or inferred from the file extension.
It is possible to put a link on the image.
Remark: if an image is used several times, only one copy will be embedded in the file.
file | Name of the file containing the image. |
x | Abscissa of the upper-left corner. |
y | Ordinate of the upper-left corner. |
w | Width of the image in the page. If not specified or equal to zero, it is automatically calculated. |
h | Height of the image in the page. If not specified or equal to zero, it is automatically calculated. |
mimeType | Image format. Possible values are: image/jpeg, image/png, image/gif, image/wmf. If not specified, the type is inferred from the file extension. |
link | URL or identifier returned by AddLink(). |
maskImage | Id of an image mask created previously by ImageMask(). |
|
virtual |
Puts an image in the page The image is given by an wxImage-Object
name | Name of the image to be used as an identifier for this image object. |
image | wxImage object which will be embedded as PNG |
x | Abscissa of the upper-left corner. |
y | Ordinate of the upper-left corner. |
w | Width of the image in the page. If not specified or equal to zero, it is automatically calculated. |
h | Height of the image in the page. If not specified or equal to zero, it is automatically calculated. |
link | URL or identifier returned by AddLink(). |
maskImage | Id of an image mask created previously by ImageMask(). |
jpegFormat | Switch whether to save image as JPEG (true) or PNG (false, default). |
jpegQuality | Quality in case of JPEG format (0 = poor, 100 = best, default 75). |
|
virtual |
Puts an image in the page The image is given by an wxInputStream-Object containing the raw image data.
name | Name of the image to be used as an identifier for this image object. |
stream | wxInputStream object containing the raw image data |
mimeType | Image format. Possible values are: image/jpeg, image/png, image/gif, image/wmf. |
x | Abscissa of the upper-left corner. |
y | Ordinate of the upper-left corner. |
w | Width of the image in the page. If not specified or equal to zero, it is automatically calculated. |
h | Height of the image in the page. If not specified or equal to zero, it is automatically calculated. |
link | URL or identifier returned by AddLink(). |
maskImage | Id of an image mask created previously by ImageMask(). |
|
virtual |
Prepares an image for use as an image mask The image is given as the name of the file containing the image
file | Name of the file containing the image. |
mimeType | Image format. Possible values are: image/jpeg, image/png, image/gif, image/wmf. |
|
virtual |
Prepares an image for use as an image mask The image is given by an wxImage-Object
name | Name of the image. |
image | wxImage object. |
|
virtual |
Prepares an image for use as an image mask The image is given by an wxInputStream-Object containing the raw image data.
name | Name of the image. |
stream | wxInputStream object containing the raw image data |
mimeType | Image format. Possible values are: image/jpeg, image/png, image/gif, image/wmf. |
|
virtual |
Imports a page from an external PDF document.
Imports a page from the current external PDF document. As the bounding box of the template the ArtBox of the imported page is used. If the page does not have an explicit ArtBox, the CropBox will be used instead; if there is no explicit CropBox then the MediaBox will be used.
pageno | page number of the page to be imported |
pageBox | page box which should be used (default: ArtBox) |
|
protectedvirtual |
Initialize.
|
protectedvirtual |
Initialize object ids of patterns.
|
virtual |
Returns whether footer output is in progress.
|
virtual |
Leave a layer.
Ends a layer controlled graphic block. It will end the most recent open block.
|
virtual |
Draws a line between two points.
x1 | Abscissa of first point |
y1 | Ordinate of first point |
x2 | Abscissa of second point |
y2 | Ordinate of second point |
|
virtual |
Defines a linear gradient shading.
col1 | first colour (RGB or CMYK). |
col2 | second colour (RGB or CMYK). |
gradientType | Type of the gradient |
|
virtual |
This method counts the number of lines a text would occupy in respect to a given maximal width.
w | Width of cells. If 0, they extend up to the right margin of the page. |
txt | String for which the number of lines is to be counted |
|
virtual |
Append a straight line segment to the current (sub)path.
Append a straight line segment from the current point to the point (x, y). The new current point is (x, y).
x | abscissa value |
y | ordinate value |
|
virtual |
Puts a link on a rectangular area of the page.
Text or image links are generally put via Cell(), Write() or Image(), but this method can be useful for instance to define a clickable area inside an image.
x | Abscissa of the upper-left corner of the rectangle |
y | Ordinate of the upper-left corner of the rectangle |
w | Width of the rectangle |
h | Height of the rectangle |
link | URL or identifier returned by AddLink() |
|
virtual |
Performs a line break.
The current abscissa goes back to the left margin and the ordinate increases by the amount passed in parameter.
h | The height of the break. By default, the value equals the height of the last printed cell. |
|
protected |
|
virtual |
Lock a layer.
Use this method to lock an optional content group. The state of a locked group cannot be changed through the user interface of a viewer application. Producers can use this entry to prevent the visibility of content that depends on these groups from being changed by users.
layer | the layer that needs to be added to the array of locked OCGs |
|
virtual |
Draws a graphical marker symbol.
x | abscissa of the marker's center |
y | ordinate of the marker's center |
markerType | type of the marker |
size | size of the marker |
|
virtual |
Defines a axial gradient shading.
col1 | first colour (RGB or CMYK). |
col2 | second colour (RGB or CMYK). |
x1 | start point of gradient vector, default: 0 (range 0 .. 1) |
y1 | start point of gradient vector, default: 0 (range 0 .. 1) |
x2 | end point of gradient vector, default: 1 (range 0 .. 1) |
y2 | end point of gradient vector, default: 0 (range 0 .. 1) |
midpoint | position of the mirror point, default: 0.5 (range 0 .. 1) |
intexp | interpolation exponent, default: 1 |
|
virtual |
Performs a horizontal mirroring transformation.
Alias for scaling -100% in x-direction
|
virtual |
Performs a horizontal mirroring transformation.
Alias for scaling -100% in x-direction
x | abscissa of the axis of reflection |
|
virtual |
Performs a vertical mirroring transformation.
Alias for scaling -100% in y-direction
|
virtual |
Performs a vertical mirroring transformation.
Alias for scaling -100% in y-direction
y | abscissa of the axis of reflection |
|
virtual |
Begin a new subpath.
Move to the starting point of a new (sub)path. The new current point is (x, y).
x | abscissa value |
y | ordinate value |
|
virtual |
This method allows printing text with line breaks.
They can be automatic (as soon as the text reaches the right border of the cell) or explicit (via the
character). As many cells as necessary are output, one below the other. Text can be aligned, centered or justified. The cell block can be framed and the background painted.
w | Width of cells. If 0, they extend up to the right margin of the page. |
h | Height of cells. |
txt | String to print |
border | Indicates if borders must be drawn around the cell. The value can be
|
align | Allows to center or align the text. Possible values are:
|
fill | Indicates if the cell background must be painted (1) or transparent (0). Default value: 0. |
maxline | Defines the maximum number of lines which should be printed. If maxline is 0 then the number of lines is not restricted. Default value: 0. |
|
protected |
Begin a new object.
|
virtual |
|
protected |
Add character string.
|
protected |
Add len characters.
|
protected |
Add ASCII string.
|
protected |
Add an ASCII text string to the document.
|
protected |
Draws a Bézier curve from last draw point.
|
protected |
Add \ before \, ( and )
|
protected |
Add \ before \, ( and )
|
protected |
Add a hex string to the document.
|
protected |
Add a hex string to the document.
|
protected |
Add a hex text string to the document (without charset conversion)
|
protected |
Add an image object to the document.
|
protected |
Add an indirect object to the document.
|
protected |
Draws a line from last draw point.
|
protected |
Draws a line relative from last draw point.
|
protected |
Sets a draw point.
|
protected |
Sets a draw point relative to current position.
|
protected |
Add a raw text string to the document (without charset conversion)
|
protected |
Add a text string to the document.
|
virtual |
|
virtual |
Draws a polygon.
x | Array with abscissa values |
y | Array with ordinate values |
style | Style of polygon (draw and/or fill) |
|
protected |
Prepare an XML cell for output.
|
protected |
Prepare an XML table for output.
|
virtual |
Adds a push button at the current position.
Adds a push button to the list of form fields at the current position
name | field name of the push button |
width | width of the push button |
height | height of the push button |
caption | caption of the push button |
action | associated Javascript action |
|
virtual |
Adds a push button.
Adds a push button to the list of form fields
name | field name of the push button |
x | abscissa of the push button position |
y | ordinate of the push button position |
width | width of the push button |
height | height of the push button |
caption | caption of the push button |
action | associated Javascript action |
|
protected |
Add automatic state event.
|
protectedvirtual |
Add bookmarks.
|
protectedvirtual |
Add catalog.
|
protectedvirtual |
Add colour profile.
|
protectedvirtual |
Add encryption info.
|
protectedvirtual |
Add extended graphics states.
|
protectedvirtual |
Add attached files.
|
protectedvirtual |
Adds fonts.
|
protectedvirtual |
Add form fields.
|
protectedvirtual |
Add header.
|
protectedvirtual |
Add images.
|
protectedvirtual |
Add imported objects.
|
protectedvirtual |
Add info.
|
protectedvirtual |
Add Javascript (document level)
|
protectedvirtual |
Add layers.
|
protectedvirtual |
Add XMP meta data.
|
protected |
Add optional content order.
|
protected |
Add optional content properties.
|
protectedvirtual |
Add pages.
|
protectedvirtual |
Add patterns.
|
protectedvirtual |
Add resource dictionary.
|
protectedvirtual |
Add resources.
|
protectedvirtual |
Add shaders.
|
protectedvirtual |
Add spot colours.
|
protected |
Add byte stream.
|
protectedvirtual |
Add templates.
|
protectedvirtual |
Add trailer.
|
protectedvirtual |
Add object dictionary.
|
virtual |
Defines a radial gradient shading.
col1 | first colour (RGB or CMYK). |
col2 | second colour (RGB or CMYK). |
x1 | center point of circle 1, default: 0.5 (range 0 .. 1) |
y1 | center point of circle 1, default: 0.5 (range 0 .. 1) |
r1 | radius of circle 1, default: 0 |
x2 | center point of circle 2, default: 0.5 (range 0 .. 1) |
y2 | center point of circle 2, default: 0.5 (range 0 .. 1) |
r2 | radius of circle 2, default: 1 |
intexp | interpolation exponent, default: 1 |
|
virtual |
Adds a radio button at the current position.
Adds a radio button to the list of form fields at the current position
group | name of the radio button group this radio button belongs to |
name | field name of the radio button |
width | width of the radio button |
|
virtual |
Adds a radio button.
Adds a radio button to the list of form fields
group | name of the radio button group this radio button belongs to |
name | field name of the radio button |
x | abscissa of the radio button position |
y | ordinate of the radio button position |
width | width of the radio button |
|
virtual |
Outputs a rectangle.
It can be drawn (border only), filled (with no border) or both.
x | Abscissa of upper-left corner |
y | Ordinate of upper-left corner |
w | Width |
h | Height |
style | Style of rendering. Possible values are:
|
|
virtual |
Draws a regular polygon.
x0 | Abscissa of Center point |
y0 | Ordinate of Center point |
r | Radius of circumscribed circle |
ns | Number of sides |
angle | Orientation angle (anti-clockwise) |
circle | Flag whether to draw circumscribed circle or not |
style | Style of polygon (draw and/or fill) |
circleStyle | Style of circumscribed circle (draw and/or fill) (if draw) |
circleLineStyle | Line style for circumscribed circle. (if draw) |
circleFillColour | Fill colour for circumscribed circle. (if draw fill circle) |
|
protectedvirtual |
Replace page number aliases.
|
protectedvirtual |
Restore graphic state.
|
virtual |
Performs a rotation around the current position.
angle | angle in degrees. |
The rotation affects all elements which are printed after the method call (with the exception of the clickable areas).
Remarks:
|
virtual |
Performs a rotation around a given center.
angle | angle in degrees. |
x | abscissa of the rotation center. Default value: current position. |
y | ordinate of the rotation center. Default value: current position. |
The rotation affects all elements which are printed after the method call (with the exception of the clickable areas).
Remarks:
|
virtual |
Puts a rotated image in the page.
The upper-left corner must be given.
The format can be specified explicitly or inferred from the file extension.
It is possible to put a link on the image.
Remark: if an image is used several times, only one copy will be embedded in the file.
file | Name of the file containing the image. |
x | Abscissa of the upper-left corner. |
y | Ordinate of the upper-left corner. |
w | Width of the image in the page. If not specified or equal to zero, it is automatically calculated. |
h | Height of the image in the page. If not specified or equal to zero, it is automatically calculated. |
angle | Angle of rotation |
type | Image format. Possible values are (case insensitive): JPG, JPEG, PNG, GIF, WMF. If not specified, the type is inferred from the file extension. |
link | URL or identifier returned by AddLink(). |
maskImage | Id of an image mask created previously by ImageMask(). |
|
virtual |
Prints a rotated text string with explicit rotation center.
textX | Abscissa of the origin |
textY | Ordinate of the origin |
rotationX | abscissa of the rotation center. |
rotationY | ordinate of the rotation center. |
txt | String to print |
angle | angle in degrees. |
|
virtual |
Prints a rotated text string.
x | abscissa of the rotation center. |
y | ordinate of the rotation center. |
txt | String to print |
angle | angle in degrees. |
|
virtual |
Draws a rounded rectangle.
x | Abscissa of upper-left corner |
y | Ordinate of upper-left corner |
w | Width |
h | Height |
r | Radius of the rounded corners |
roundCorner | Draws rounded corner or not.
|
style | Style of rectangle (draw and/or fill) |
|
virtual |
|
protectedvirtual |
Save graphic state.
|
virtual |
Performs scaling in X and Y direction with the current position as the scaling center.
A scaling transformation is applied independently for X and Y direction.
sx | scaling factor for width in percent. 0 is not allowed. |
sy | scaling factor for height in percent. 0 is not allowed. |
|
virtual |
Performs scaling in X and Y direction.
A scaling transformation is applied independently for X and Y direction.
sx | scaling factor for width in percent. 0 is not allowed. |
sy | scaling factor for height in percent. 0 is not allowed. |
x | abscissa of the scaling center. |
y | ordinate of the scaling center. |
|
virtual |
Performs scaling in X direction only with the current position as the scaling center.
A scaling transformation is applied for the X direction.
sx | scaling factor for width as percent. 0 is not allowed. |
|
virtual |
Performs scaling in X direction only.
A scaling transformation is applied for the X direction.
sx | scaling factor for width as percent. 0 is not allowed. |
x | abscissa of the scaling center. |
y | ordinate of the scaling center. |
|
virtual |
Performs equal scaling in X and Y direction with the current position as the scaling center.
A scaling transformation is applied for both - X and Y - directions.
s | scaling factor for width and height as percent. 0 is not allowed. |
|
virtual |
Performs equal scaling in X and Y direction.
A scaling transformation is applied for both - X and Y - directions.
s | scaling factor for width and height as percent. 0 is not allowed. |
x | abscissa of the scaling center. |
y | ordinate of the scaling center. |
|
virtual |
Performs scaling in Y direction only with the current position as the scaling center.
A scaling transformation is applied for the Y direction.
sy | scaling factor for height as percent. 0 is not allowed. |
|
virtual |
Performs scaling in Y direction only.
A scaling transformation is applied for the Y direction.
sy | scaling factor for height as percent. 0 is not allowed. |
x | abscissa of the scaling center. |
y | ordinate of the scaling center. |
|
virtual |
Draws a sector.
x0 | Abscissa of Center point |
y0 | Ordinate of Center point |
r | Radius |
astart | Start angle |
afinish | Finish angle |
style | Style of rectangle (draw and/or fill, default: fill&draw) |
clockwise | indicates whether to go clockwise (default: true) |
origin | origin of angles (0 for 3 o'clock, 90 for noon, 180 for 9 o'clock, 270 for 6 o'clock; default: 90) |
|
protectedvirtual |
Select font based on wxFont object.
|
protectedvirtual |
Select font based on wxFont object.
|
protectedvirtual |
Select font.
|
protectedvirtual |
Select font.
|
virtual |
Sets alpha values and blend mode.
lineAlpha | alpha value for stroking operations, from 0 (transparent) to 1 (opaque) |
fillAlpha | alpha value for non-stroking operations, from 0 (transparent) to 1 (opaque) |
blendMode | one of the following: Normal, Multiply, Screen, Overlay, Darken, Lighten, ColorDodge, ColorBurn, HardLight, SoftLight, Difference, Exclusion, Hue, Saturation, Color, Luminosity |
|
virtual |
Sets a previously defined alpha state.
alphaState | id of alpha state |
|
virtual |
Defines the author of the document.
author | The name of the author. |
|
virtual |
Enables or disables the automatic page breaking mode.
When enabling, the second parameter is the distance from the bottom of the page that defines the triggering limit. By default, the mode is on and the margin is 2 cm.
autoPageBreak | Boolean indicating if mode should be on or off. |
margin | Distance from the bottom of the page. |
|
virtual |
Defines the cell margin.
The method can be called before creating the first page.
margin | The margin. |
|
virtual |
Activates or deactivates page compression.
When activated, the internal representation of each page is compressed, which leads to a compression ratio of about 2 for the resulting document. Compression is on by default.
compress | Boolean indicating if compression must be enabled. |
|
virtual |
Defines the creation timestamp of the document.
Optionally the creation date can be specified with this method. If this method is not called the default is the current date and time.
creationDate | The date and time to be used as the creation timestamp. |
|
virtual |
Defines the creator of the document.
This is typically the name of the application that generates the PDF.
creator | The name of the creator. |
|
virtual |
Defines the way the document is to be displayed by the viewer.
The zoom level can be set:pages can be displayed entirely on screen, occupy the full width of the window, use real size, be scaled by a specific zooming factor or use viewer default (configured in the Preferences menu of Acrobat). The page layout can be specified too: single at once, continuous display, two columns or viewer default. By default, documents use the full width mode with continuous display.
zoom | The zoom to use. It can be one of the following string values or a number indicating the zooming factor to use.
|
layout | The page layout. Possible values are:
|
zoomFactor | specifies the zoom factor in percent if layout is wxPDF_ZOOM_FACTOR |
|
virtual |
Defines the colour used for all drawing operations.
Affected drawing operations are: lines, rectangles and cell borders. It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
grayscale | indicates the gray level. Value between 0 and 255 |
|
virtual |
Defines the colour used for all drawing operations.
Affected drawing operations are: lines, rectangles and cell borders. It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
red | indicates the red level. Value between 0 and 255 |
green | indicates the green level. Value between 0 and 255 |
blue | indicates the blue level. Value between 0 and 255 |
|
virtual |
Defines the colour used for all drawing operations.
Affected drawing operations are: lines, rectangles and cell borders. It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
colour | defines a colour composed of a red, green and blue component |
|
virtual |
Defines the colour used for all drawing operations.
Affected drawing operations are: lines, rectangles and cell borders. It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
colour | defines a colour using the class wxPdfColour |
|
virtual |
Defines the spot colour used for all drawing operations.
Affected drawing operations are: lines, rectangles and cell borders. It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
name | the name of the spot colour |
tint | indicates the tint level. Value between 0 and 100. Default: 100. |
|
virtual |
Defines the colour used for all drawing operations.
Affected drawing operations are: lines, rectangles and cell borders. It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
cyan | indicates the cyan level. Value between 0 and 100 |
magenta | indicates the magenta level. Value between 0 and 100 |
yellow | indicates the yellow level. Value between 0 and 100 |
black | indicates the black level. Value between 0 and 100 |
|
virtual |
Defines the pattern used for all drawing operations.
The given pattern is used for all drawing operations instead of a colour. Affected drawing operations are: lines, rectangles and cell borders. The method can be called before the first page is created and the value is retained from page to page.
name | the name of the pattern |
|
virtual |
Defines the colour used for all filling operations.
Affected filling operations are: filled rectangles and cell backgrounds. It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
grayscale | indicates the gray level. Value between 0 and 255 |
|
virtual |
Defines the colour used for all filling operations.
Affected filling operations are: filled rectangles and cell backgrounds. It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
red | indicates the red level. Value between 0 and 255 |
green | indicates the green level. Value between 0 and 255 |
blue | indicates the blue level. Value between 0 and 255 |
|
virtual |
Defines the colour used for all filling operations.
Affected filling operations are: filled rectangles and cell backgrounds. It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
colour | defines a colour composed of a red, green and blue component |
|
virtual |
Defines the colour used for all filling operations.
Affected filling operations are: filled rectangles and cell backgrounds. It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
colour | defines a colour using the class wxPdfColour |
|
virtual |
Defines the spot colour used for all filling operations.
Affected filling operations are: filled rectangles and cell backgrounds. It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
name | is the name of the spot colour |
tint | indicates the tint level. Value between 0 and 100. Default: 100. |
|
virtual |
Defines the colour used for all filling operations.
Affected filling operations are: filled rectangles and cell backgrounds. It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
cyan | indicates the cyan level. Value between 0 and 100 |
magenta | indicates the magenta level. Value between 0 and 100 |
yellow | indicates the yellow level. Value between 0 and 100 |
black | indicates the black level. Value between 0 and 100 |
|
virtual |
Paints a gradient shading to rectangular area.
x | abscissa of the top left corner of the rectangle. |
y | ordinate of the top left corner of the rectangle. |
w | width of the rectangle. |
h | height of the rectangle. |
gradient | id of the gradient. |
|
virtual |
Set the filling rule.
rule | The filling rule to be used in complex filling operations. Possible values are:
|
|
virtual |
Defines the pattern used for all filling operations.
The given pattern is used for all filling operations instead of a colour. Affected filling operations are: filled rectangles and cell backgrounds. The method can be called before the first page is created and the value is retained from page to page.
name | the name of the pattern |
|
virtual |
Sets the font used to print character strings based on a wxFont object.
The font referenced by the wxFont object will be added to the document if necessary.
font | The font to be set. |
|
virtual |
Sets the font used to print character strings based on a wxFont object.
The font referenced by the wxFont object will be added to the document if necessary.
font | The font to be set. |
style | Font style. Possible values are (case insensitive):
|
size | Font size in points. The default value is the current size. If no size has been |
|
virtual |
Sets the font used to print character strings.
It is mandatory to call a variant of this method at least once before printing text or the resulting document would not be valid. The font can be either a standard one or a font added via the AddFont() method. Standard fonts use Windows encoding cp1252 (Western Europe). The method can be called before the first page is created and the font is retained from page to page. If you just wish to change the current font size, it is simpler to call SetFontSize().
family | Family font. It can be either a name defined by AddFont() or one of the standard families (case insensitive):
|
style | Font style. Possible values are (case insensitive):
|
size | Font size in points. The default value is the current size. If no size has been specified since the beginning of the document, the value taken is 12 |
|
virtual |
Sets the font used to print character strings.
It is mandatory to call a variant of this method at least once before printing text or the resulting document would not be valid. The font can be either a standard one or a font added via the AddFont() method. Standard fonts use Windows encoding cp1252 (Western Europe). The method can be called before the first page is created and the font is retained from page to page. If you just wish to change the current font size, it is simpler to call SetFontSize().
family | Family font. It can be either a name defined by AddFont() or one of the standard families (case insensitive):
|
style | Font style. Possible values are (case insensitive):
|
size | Font size in points. The default value is the current size. If no size has been specified since the beginning of the document, the value taken is 12 |
|
virtual |
|
protectedvirtual |
Defines the size of the current font.
size | The size (in points) |
setSize | flag whether to actually set the font size in PDF output |
|
inlinevirtual |
Sets the font embedding mode.
If other fonts than the 14 Adobe core fonts are used in a document, they are usually embedded into the PDF file, often resulting in rather large PDF files. This is especially true for Unicode fonts with thousands of glyphs. To reduce the size of the resulting PDF file fonts may be subsetted, that is, only those glyphs actually used in the document are embedded.
Currently wxPdfDocument supports font subsetting for TrueType Unicode fonts only.
fontSubsetting | Boolean indicating whether font subsetting should be used or not. |
|
virtual |
Sets the border style for form fields.
Sets the border width and style to be used for all subsequent form field additions until this method is called again with different values.
borderStyle | style of the form field's border
|
borderWidth | width of the form field's border |
|
virtual |
Sets colours for form fields.
Sets the border, background and text colour to be used for all subsequent form field additions until this method is called again with different values.
borderColour | colour of the form field's border |
backgroundColour | colour of the form field's background |
textColour | colour of the form field's font |
|
virtual |
Set the image scale.
[in] | scale | image scale. |
|
virtual |
Enable or disable kerning.
When enabled, kerning is applied to text output. Kerning is disabled by default.
kerning | Boolean indicating if kerning should be enabled. |
|
virtual |
Associates keywords with the document,.
Generally keywords are in the form 'keyword1 keyword2 ...'.
keywords | The list of keywords. |
|
virtual |
Defines the left margin.
The method can be called before creating the first page. If the current abscissa gets out of page, it is brought back to the margin.
margin | The margin. |
|
virtual |
Sets the height of a text line.
height | The line height. |
|
virtual |
Sets line style.
linestyle | Line style. |
|
virtual |
Defines the line width.
By default, the value equals 0.2 mm. The method can be called before the first page is created and the value is retained from page to page.
width | The width. |
|
virtual |
Defines the page and position a link points to.
link | The link identifier returned by AddLink() |
y | Ordinate of target position; -1 indicates the current position. The default value is 0 (top of page) |
page | Number of target page; -1 indicates the current page. This is the default value |
|
virtual |
Defines the left, top and right margins.
By default, they equal 1 cm. Call this method to change them.
left | Left margin. |
top | Top margin. |
right | Right margin. Default value is the left one. |
|
inline |
Set message translation mode.
Sets the message translation mode which controls the handling of msg tags in XML output
translate | flag specifying whether messages translation should be enabled |
|
virtual |
Defines the paper handling when printing (simplex / duplex).
The paper handling option that shall be used when printing the file from the print dialog.
paperHandling | Can be one of the following values:
|
void wxPdfDocument::SetPdfA1Conformance | ( | bool | enable | ) |
Set PDF/A-1b conformance.
Sets the document conformance to PDF/A-1 Level B
enable | flag whether PDF/A-1b conformance should be enabled |
|
virtual |
Set permissions as well as user and owner passwords.
permissions | flag indicating permissions. Flags from the following list may be combined as needed If a value is present it means that the permission is granted |
userPassword | user password if applicable. If a user password is set, user will be prompted before document is opened |
ownerPassword | owner password.if applicable If an owner password is set, the document can be opened in privilege mode with no restriction if that password is entered |
encryptionMethod | selects the encryption method. Possible values are:
|
keyLength | Length of the key used for encryption (Default: 0) The default value selects the standard encryption method revision 2 with a key length of 40 bits. Specifying a value > 0 selects the standard encryption method revision 3 with the given key length, the key length has to be in the range 40..128 and has to be dividable by 8. The key length is adjusted accordingly if these conditions are not met. |
|
virtual |
Defines the right margin.
The method can be called before creating the first page.
margin | The margin. |
|
protected |
Set internal scale factor.
|
virtual |
Sets a source file for the external template feature.
Selects the source for the external template feature. A parser is setup for importing pages from the PDF document. Although wxPdfDocument usually creates PDF documents conforming to version 1.3 of the PDF standard, parsing of documents conforming to versions up to 1.6 is supported. If pages are aimported from documents conforming to a higher version than 1.3 the version used by wxPdDocument is updated accordingly.
filename | a valid filename |
password | a valid user or owner password if the PDF document is encrypted |
Attention: Access permissions for printing, copying and extracting text or graphics are required. If a PDF document does not have these access permissions, it cannot be used as a source for the external template feature.
|
virtual |
Defines the subject of the document.
subject | The subject. |
|
virtual |
Sets the bounding box of a template.
As long as a template hasn't been used it is possible to change the bounding box of the template. This may be useful for pages imported from an external PDF document allowing to set the visible portion of the template. Note: Setting the bounding box influences only the visible area of the template, not the real size it occupies.
templateId | A valid template ID |
x | The x coordinate of the lower left corner |
y | The y coordinate of the lower left corner |
width | The width of the template |
height | The height of the template |
|
virtual |
Defines the colour used for text.
It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
grayscale | indicates the gray level. Value between 0 and 255 |
|
virtual |
Defines the colour used for text.
It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
red | indicates the red level. Value between 0 and 255 |
green | indicates the green level. Value between 0 and 255 |
blue | indicates the blue level. Value between 0 and 255 |
|
virtual |
Defines the colour used for text.
It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
colour | defines a colour composed of a red, green and blue component |
|
virtual |
Defines the colour used for text.
It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
colour | defines a colour using the class wxPdfColour |
|
virtual |
Defines the spot colour used for text.
It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
name | the name of the spot colour |
tint | indicates the tint level. Value between 0 and 100. Default: 100. |
|
virtual |
Defines the colour used for text.
It can be expressed in RGB components or gray scale. The method can be called before the first page is created and the value is retained from page to page.
cyan | indicates the cyan level. Value between 0 and 100 |
magenta | indicates the magenta level. Value between 0 and 100 |
yellow | indicates the yellow level. Value between 0 and 100 |
black | indicates the black level. Value between 0 and 100 |
|
virtual |
Defines the pattern used for text output.
The given pattern is used for text output instead of a colour. The method can be called before the first page is created and the value is retained from page to page.
name | the name of the pattern |
|
virtual |
Sets the text render mode.
mode | the text render mode |
|
virtual |
Defines the title of the document.
title | The title. |
|
virtual |
Defines the top margin.
The method can be called before creating the first page.
margin | The margin. |
|
virtual |
Defines the viewer preferences.
preferences | A set of viewer preferences options.
|
|
virtual |
|
virtual |
|
virtual |
|
virtual |
Draws a shape.
shape | shape to be drawn |
style | Style of rendering. Possible values are:
|
|
virtual |
Prints a text string along a path defined by a shape.
shape | shape defining a path along which the text is printed |
text | text string to be printed |
mode | flag how to handle the text string
|
|
protected |
Show a single glyph.
|
protected |
Show text string, with kerning if requested.
|
virtual |
Performs a skewing in both X and Y directions with the current position as the skewing center.
xAngle | angle in degrees between -90 (skew to the left) and 90 (skew to the right) |
yAngle | angle in degrees between -90 (skew to the bottom) and 90 (skew to the top) |
|
virtual |
Performs a skewing in both X and Y directions.
xAngle | angle in degrees between -90 (skew to the left) and 90 (skew to the right) |
yAngle | angle in degrees between -90 (skew to the bottom) and 90 (skew to the top) |
x | abscissa of the skewing center. default is current x position |
y | ordinate of the skewing center. default is current y position |
|
virtual |
Performs a skewing in X direction only with the current position as the skewing center.
xAngle | angle in degrees between -90 (skew to the left) and 90 (skew to the right) |
|
virtual |
Performs a skewing in both X direction only.
xAngle | angle in degrees between -90 (skew to the left) and 90 (skew to the right) |
x | abscissa of the skewing center. default is current x position |
y | ordinate of the skewing center. default is current y position |
|
virtual |
Performs a skewing in Y direction only with the current position as the skewing center.
yAngle | angle in degrees between -90 (skew to the bottom) and 90 (skew to the top) |
|
virtual |
Performs a skewing in Y direction only.
yAngle | angle in degrees between -90 (skew to the bottom) and 90 (skew to the top) |
x | abscissa of the skewing center. default is current x position |
y | ordinate of the skewing center. default is current y position |
|
virtual |
Draws a star polygon.
x0 | Abscissa of Center point |
y0 | Ordinate of Center point |
r | Radius of circumscribed circle |
nv | Number of vertices |
ng | Number of gaps (ng % nv = 1 => regular polygon) |
angle | Orientation angle (anti-clockwise) |
circle | Flag whether to draw circumscribed circle or not |
style | Style of polygon (draw and/or fill) |
circleStyle | Style of circumscribed circle (draw and/or fill) (if draw) |
circleLineStyle | Line style for circumscribed circle. (if draw) |
circleFillColour | Fill colour for circumscribed circle. (if draw fill circle) |
|
virtual |
Enters a transformation environment.
Before applying any transformation this method should be invoked. All transformation method invoke it implicitly if necessary. All open transformation environments are closed implicitly on page end.
|
virtual |
Leaves a transformation environment.
This method should be invoked to cancel a transformation environment opened by StartTransform. All open transformation environments are closed implicitly on page end.
|
virtual |
Prints a character string.
The origin is on the left of the first charcter, on the baseline. This method allows to place a string precisely on the page, but it is usually easier to use Cell(), MultiCell() or Write() which are the standard methods to print text.
x | Abscissa of the origin |
y | Ordinate of the origin |
txt | String to print |
|
virtual |
This method counts the number of lines a text will occupy in respect to a given maximal width.
w | Width of cells. If 0, they extend up to the right margin of the page. |
h | Height of cells. |
txt | String to print |
halign | Allows to center or align the text. Possible values are:
|
valign | Allows to vertical align the text. Possible values are:
|
border | Indicates if borders must be drawn around the text box. The value can be
|
fill | Indicates if the cell background must be painted (1) or transparent (0). Default value: 0. |
|
protected |
Format a text string.
|
virtual |
Adds a text field at the current position.
Adds a text field to the list of form fields at the current position
name | field name of the text field |
width | width of the text field |
height | height of the text field |
value | default value of the text field |
multiline | flag whether the text field is a multiline field or not |
|
virtual |
Adds a text field.
Adds a text field to the list of form fields
name | field name of the text field |
x | abscissa of the text field position |
y | ordinate of the text field position |
width | width of the text field |
height | height of the text field |
value | default value of the text field |
multiline | flag whether the text field is a multiline field or not |
|
virtual |
|
protected |
Perform transformation.
|
virtual |
Moves the origin.
tx | movement to the right |
ty | movement to the bottom |
|
virtual |
Moves the X origin.
tx | movement to the right |
|
virtual |
Moves the Y origin.
ty | movement to the bottom |
|
virtual |
Remove clipping area.
Once you have finished using the clipping, you must remove it with UnsetClipping().
|
virtual |
Uses a template in current page or in another template.
Uses the specified template just like an image in the current page or in another template at the current position with default size.
The width or height is calculated using GetTemplateSize internally.
templateId | A valid template ID |
|
virtual |
Uses a template in current page or in another template.
Uses the specified template just like an image in the current page or in another template.
Width and height parameters are optional. The width or height is calculated using GetTemplateSize internally. By default the size as defined by BeginTemplate is used.
templateId | A valid template ID |
x | The x coordinate |
y | The y coordinate |
width | The new width of the template |
height | The new height of the template |
Attention: The template may be displayed distorted, if both width and height are given with values > 0 and do not correspond to the dimensions of the template.
|
virtual |
This method prints text from the current position.
When the right margin is reached (or the
character is met) a line break occurs and text continues from the left margin. Upon method exit, the current position is left just at the end of the text. It is possible to put a link on the text.
h | Line height |
txt | String to print |
link | URL or identifier returned by AddLink() |
|
virtual |
This method prints text with cell attributes from the current position.
When the right margin is reached (or the
character is met) a line break occurs and text continues from the left margin. Upon method exit, the current position is left just at the end of the text. It is possible to put a link on the text.
h | Line height |
txt | String to print |
border | Indicates if borders must be drawn around the cell. The value can be
|
fill | Indicates if the cell background must be painted (1) or transparent (0). Default value: 0. |
link | URL or identifier returned by AddLink() |
|
virtual |
Prints an array of glyphs identified by glyph numbers from the current position.
The glyphs are positioned according to the given offsets in horizontal (x) and vertical (y) direction.
|
protectedvirtual |
|
virtual |
Prints a string containing simple XML markup.
Output starts at the current position.
str | string containing text with simple XML markup |
|
protected |
Write XML using XML node.
|
protected |
Output a prepared XML cell.
|
protected |
Output a prepared XML table.
|
friend |
|
friend |