Back to Seed Clases

Gdk

Classes

Interfaces

Structs

Unions

Event

Enums

GObject.Object
parent-child marker Pango.Renderer
Gdk.PangoRenderer

Class Gdk.PangoRenderer

Import line:	Gdk = imports.gi.Gdk;
GIR File:	Gdk-2.0.gir
C documentation:	GdkPangoRenderer
Class :	PangoRenderer
Extends:	Pango.Renderer
	Show / Hide Inherited methods, properties and signals

GdkPangoRenderer is a subclass of PangoRenderer used for rendering Pango objects into GDK drawables. The default renderer for a particular screen is obtained with gdk_pango_renderer_get_default(); Pango functions like pango_renderer_draw_layout() and pango_renderer_draw_layout_line() are then used to draw objects with the renderer. In most simple cases, applications can just use gdk_draw_layout(), and don't need to directly use GdkPangoRenderer at all. Using the GdkPangoRenderer directly is most useful when working with a transformation such as a rotation, because the Pango drawing functions take user space coordinates (coordinates before the transformation) instead of device coordinates. In certain cases it can be useful to subclass GdkPangoRenderer. Examples of reasons to do this are to add handling of custom attributes by overriding 'prepare_run' or to do custom drawing of embedded objects by overriding 'draw_shape'.

Properties
Properties		Defined By
	active_count : Number read only	Pango.Renderer
	matrix : Pango.Matrix read only	Pango.Renderer
	parent_instance : Pango.Renderer read only	Gdk.PangoRenderer
	priv : Gdk.PangoRendererPrivate read only	Gdk.PangoRenderer
	screen : Gdk.Screen	Gdk.PangoRenderer
	strikethrough : Boolean read only	Pango.Renderer
	underline : Pango.Underline read only	Pango.Renderer

Methods / Constructors
Method / Constructor		Defined By
	new Gdk.PangoRenderer (Object *properties) Create a new Gdk.PangoRenderer Create a new Gdk.PangoRenderer Parameters: Object properties*
	new Gdk.PangoRenderer.c_new (Screen *screen) : Gdk.PangoRenderer Create a new Gdk.PangoRenderer Create a new Gdk.PangoRenderer Parameters: Gdk.Screen screen* Required (not null) Returns: Gdk.PangoRenderer
	Gdk.PangoRenderer.get_default (Screen *screen) : Pango.Renderer Gets the default PangoRenderer* for a screen. Gets the default PangoRenderer for a screen. This default renderer is shared by all users of the display, so properties such as the color or transformation matrix set for the renderer may be overwritten by functions such as gdk_draw_layout(). Before using the renderer, you need to call gdk_pango_renderer_set_drawable() and gdk_pango_renderer_set_gc() to set the drawable and graphics context to use for drawing. renderer is owned by GTK+ and will be kept around until the screen is closed. Parameters: Gdk.Screen screen Required (not null) Returns: Pango.Renderer	Gdk.PangoRenderer
	activate () : none Does initial setup before rendering operations on renderer. Does initial setup before rendering operations on renderer. pango_renderer_deactivate() should be called when done drawing. Calls such as pango_renderer_draw_layout() automatically activate the layout before drawing on it. Calls to pango_renderer_activate() and pango_renderer_deactivate() can be nested and the renderer will only be initialized and deinitialized once. Returns: none	Pango.Renderer
	deactivate () : none Cleans up after rendering operations on renderer. Cleans up after rendering operations on renderer. See docs for pango_renderer_activate(). Returns: none	Pango.Renderer
	draw_error_underline (Number x, Number y, Number *width, Number height) : none Draw a squiggly line that approximately covers the given rectangle in the style of an underline used to indicate a spelling error. Draw a squiggly line that approximately covers the given rectangle in the style of an underline used to indicate a spelling error. (The width of the underline is rounded to an integer number of up/down segments and the resulting rectangle is centered in the original rectangle) This should be called while renderer* is already active. Use pango_renderer_activate() to activate a renderer. Parameters: Number x Required (not null) Number y Required (not null) Number width Required (not null) Number height Required (not null) Returns: none	Pango.Renderer
	draw_glyph (Font *font, Number glyph, Number x, Number y) : none Draws a single glyph with coordinates in device space. Draws a single glyph with coordinates in device space. Parameters: Pango.Font font* Required (not null) Number glyph Required (not null) Number x Required (not null) Number y Required (not null) Returns: none	Pango.Renderer
	draw_glyph_item (String *text, GlyphItem glyph_item, Number x, Number y) : none Draws the glyphs in glyph_item* with the specified PangoRenderer, embedding the text associated with the glyphs in the output if the output format supports it (PDF for example). Draws the glyphs in glyph_item with the specified PangoRenderer, embedding the text associated with the glyphs in the output if the output format supports it (PDF for example). Note that text is the start of the text for layout, which is then indexed by glyph_item->item->offset. If text is NULL, this simply calls pango_renderer_draw_glyphs(). The default implementation of this method simply falls back to pango_renderer_draw_glyphs(). Parameters: String text Required (not null) Pango.GlyphItem glyph_item Required (not null) Number x Required (not null) in Pango units. Number y Required (not null) in Pango units. Returns: none	Pango.Renderer
	draw_glyphs (Font *font, GlyphString glyphs, Number x, Number y) : none Draws the glyphs in glyphs* with the specified PangoRenderer. Draws the glyphs in glyphs with the specified PangoRenderer. Parameters: Pango.Font font Required (not null) Pango.GlyphString glyphs Required (not null) Number x Required (not null) in Pango units. Number y Required (not null) in Pango units. Returns: none	Pango.Renderer
	draw_layout (Layout *layout, Number x, Number y) : none Draws layout* with the specified PangoRenderer. Draws layout with the specified PangoRenderer. Parameters: Pango.Layout layout Required (not null) Number x Required (not null) in Pango units. Number y Required (not null) in Pango units. Returns: none	Pango.Renderer
	draw_layout_line (LayoutLine *line, Number x, Number y) : none Draws line* with the specified PangoRenderer. Draws line with the specified PangoRenderer. Parameters: Pango.LayoutLine line Required (not null) Number x Required (not null) in Pango units. Number y Required (not null) in Pango units. Returns: none	Pango.Renderer
	draw_rectangle (RenderPart *part, Number x, Number y, Number width, Number height) : none Draws an axis-aligned rectangle in user space coordinates with the specified PangoRenderer. Draws an axis-aligned rectangle in user space coordinates with the specified PangoRenderer. This should be called while renderer* is already active. Use pango_renderer_activate() to activate a renderer. Parameters: Pango.RenderPart part Required (not null) Number x Required (not null) Number y Required (not null) Number width Required (not null) Number height Required (not null) Returns: none	Pango.Renderer
	draw_trapezoid (RenderPart *part, Number y1_, Number x11, Number x21, Number y2, Number x12, Number x22) : none Draws a trapezoid with the parallel sides aligned with the X axis using the given PangoRenderer; coordinates are in device space. Draws a trapezoid with the parallel sides aligned with the X axis using the given PangoRenderer; coordinates are in device space. Parameters: Pango.RenderPart part* Required (not null) Number y1_ Required (not null) Number x11 Required (not null) Number x21 Required (not null) Number y2 Required (not null) Number x12 Required (not null) Number x22 Required (not null) Returns: none	Pango.Renderer
	get_color (RenderPart *part) : Pango.Color Gets the current rendering color for the specified part. Gets the current rendering color for the specified part. if it hasn't been set and should be inherited from the environment. Parameters: Pango.RenderPart part* Required (not null) Returns: Pango.Color	Pango.Renderer
	get_layout () : Pango.Layout Gets the layout currently being rendered using renderer. Gets the layout currently being rendered using renderer. Calling this function only makes sense from inside a subclass's methods, like in its draw_shape() for example. The returned layout should not be modified while still being rendered. rendered using renderer at this time. Returns: Pango.Layout	Pango.Renderer
	get_layout_line () : Pango.LayoutLine Gets the layout line currently being rendered using renderer. Gets the layout line currently being rendered using renderer. Calling this function only makes sense from inside a subclass's methods, like in its draw_shape() for example. The returned layout line should not be modified while still being rendered. rendered using renderer at this time. Returns: Pango.LayoutLine	Pango.Renderer
	get_matrix () : Pango.Matrix Gets the transformation matrix that will be applied when rendering. Gets the transformation matrix that will be applied when rendering. See pango_renderer_set_matrix(). (which is the same as the identity matrix). The returned matrix is owned by Pango and must not be modified or freed. Returns: Pango.Matrix	Pango.Renderer
	part_changed (RenderPart *part) : none Informs Pango that the way that the rendering is done for part* has changed in a way that would prevent multiple pieces being joined together into one drawing call. Informs Pango that the way that the rendering is done for part has changed in a way that would prevent multiple pieces being joined together into one drawing call. For instance, if a subclass of PangoRenderer was to add a stipple option for drawing underlines, it needs to call pango_renderer_part_changed (render, PANGO_RENDER_PART_UNDERLINE); When the stipple changes or underlines with different stipples might be joined together. Pango automatically calls this for changes to colors. (See pango_renderer_set_color()) Parameters: Pango.RenderPart part Required (not null) Returns: none	Pango.Renderer
	set_color (RenderPart *part, Color color) : none Sets the color for part of the rendering. Sets the color for part of the rendering. Parameters: Pango.RenderPart part* Required (not null) Pango.Color color Required (not null) Returns: none	Pango.Renderer
	set_drawable (Drawable *drawable) : none Sets the drawable the renderer draws to. Sets the drawable the renderer draws to. Parameters: Gdk.Drawable drawable* the new target drawable, or NULL Returns: none	Gdk.PangoRenderer
	set_gc (GC gc) : none Sets the GC the renderer draws with. Sets the GC the renderer draws with. Note that the GC must not be modified until it is unset by calling the function again with NULL for the gc parameter, since GDK may make internal copies of the GC which won't be updated to follow changes to the original GC. Parameters: Gdk.GC gc the new GC to use for drawing, or NULL Returns: none	Gdk.PangoRenderer
	set_matrix (Matrix *matrix) : none Sets the transformation matrix that will be applied when rendering. Sets the transformation matrix that will be applied when rendering. Parameters: Pango.Matrix matrix* Required (not null) (No matrix set is the same as setting the identity matrix.) Returns: none	Pango.Renderer
	set_override_color (RenderPart *part, Color color) : none Sets the color for a particular render part (foreground, background, underline, etc. Sets the color for a particular render part (foreground, background, underline, etc.), overriding any attributes on the layouts renderered with this renderer. Parameters: Pango.RenderPart part* Required (not null) Gdk.Color color the color to use, or NULL to unset a previously set override color. Returns: none	Gdk.PangoRenderer
	set_stipple (RenderPart *part, Bitmap stipple) : none Sets the stipple for one render part (foreground, background, underline, etc. Sets the stipple for one render part (foreground, background, underline, etc.) Note that this is overwritten when iterating through the individual styled runs of a PangoLayout* or PangoLayoutLine. This function is thus only useful when you call low level functions like pango_renderer_draw_glyphs() directly, or in the 'prepare_run' virtual function of a subclass of GdkPangoRenderer. Parameters: Pango.RenderPart part Required (not null) Gdk.Bitmap stipple Required (not null) Returns: none	Gdk.PangoRenderer

Events
None