pango.LayoutLine a line in a pango.Layout (new in PyGTK 2.8) Synopsis pango.LayoutLine gobject.GBoxed get_extents get_pixel_extents index_to_x index trailing x_to_index x_pos Ancestry +-- gobject.GBoxed +-- pango.LayoutLine Attributes
"is_paragraph_start" Read True if this is the first line of the paragraph "length" Read the length of the line in bytes "resolved_dir" Read the resolved direction of line "runs" Read a list containing the runs of the line in visual order. "start_index" Read the start of the line as byte index into the layout.
Description A pango.LayoutLine object represents one of the lines resulting from laying out a paragraph via pango.Layout. pango.LayoutLine objects are obtained by calling the pango.Layout.get_line() method or the pango.LayoutIter.get_line() method. pango.LayoutLine objects are only valid until the text, attributes, or settings of the parent pango.Layout are modified. Methods pango.LayoutLine.get_extents get_extents Returns : a 2-tuple containing 4-tuples representing the rectangles for the logical and ink extents in Pango units. This method is available in PyGTK 2.8 and above. The get_extents() method returns the logical and ink extents rectangles of the layout line in a 2-tuple containing two 4-tuples which represent the rectangles. See the documentation for the pango.Font.get_glyph_extents() method for details about the interpretation of the rectangles. The return extents are in Pango units (1 device unit = pango.SCALE pango units). pango.LayoutLine.get_pixel_extents get_pixel_extents Returns : a 2-tuple containing 4-tuples representing the rectangles for the logical and ink extents in device units. This method is available in PyGTK 2.8 and above. The get_pixel_extents() method returns the logical and ink extents rectangles of the layout line in a 2-tuple containing two 4-tuples which represent the rectangles. See the documentation for the pango.Font.get_glyph_extents() method for details about the interpretation of the rectangles. The return extents are in device units (1 device unit = pango.SCALE pango units). pango.LayoutLine.index_to_x index_to_x index trailing index : the byte offset of a grapheme within the layout trailing : an integer indicating the edge of the grapheme to retrieve the position of. If 0, the trailing edge of the grapheme, if > 0, the leading edge of the grapheme. Returns : the X position in Pango units This method is available in PyGTK 2.8 and above. The index_to_x() method returns the X position (in Pango units) of the grapheme at the byte offset specified by index and edge specified by trailing. pango.LayoutLine.x_to_index x_to_index x_pos x_pos : the x offset (in Pango units) from the left edge of the line. Returns : a 3-tuple containing a boolean indicating if the x_pos is inside the line, the byte offset of the grapheme and the location in the grapheme. This method is available in PyGTK 2.8 and above. The x_to_index() method returns a 3-tuple containing a boolean that is True if x_pos is inside the line, the location inside the grapheme - either zero, or the number of characters in the grapheme. 0 represents the trailing edge of the grapheme.