Synopsis
class pango.Attribute:
def copy()
|
Functions
def pango.attr_type_register(name
)
def pango.AttrLanguage(language
, start_index
=0, end_index
=1)
def pango.AttrFamily(family
, start_index
=0, end_index
=1)
def pango.AttrForeground(red
, green
, blue
, start_index
=0, end_index
=1)
def pango.AttrBackground(red
, green
, blue
, start_index
=0, end_index
=1)
def pango.AttrSize(size
, start_index
=0, end_index
=1)
def pango.AttrStyle(style
, start_index
=0, end_index
=1)
def pango.AttrWeight(weight
, start_index
=0, end_index
=1)
def pango.AttrVariant(variant
, start_index
=0, end_index
=1)
def pango.AttrStretch(stretch
, start_index
=0, end_index
=1)
def pango.AttrFontDesc(desc
, start_index
=0, end_index
=1)
def pango.AttrUnderline(underline
, start_index
=0, end_index
=1)
def pango.AttrStrikethrough(strikethrough
, start_index
=0, end_index
=1)
def pango.AttrRise(rise
, start_index
=0, end_index
=1)
def pango.AttrShape(ink_rect
, logical_rect
, start_index
=0, end_index
=1)
def pango.AttrScale(scale
, start_index
=0, end_index
=1)
def pango.AttrFallback(fallback
, start_index
=0, end_index
=1)
def pango.AttrSizeAbsolute(size
, start_index
=0, end_index
=1)
def pango.AttrUnderlineColor(red
, green
, blue
, start_index
=0, end_index
=1)
def pango.AttrStrikethroughColor(red
, green
, blue
, start_index
=0, end_index
=1)
def pango.AttrLetterSpacing(letter_spacing
, start_index
=0, end_index
=1)
Functions
pango.attr_type_register
def pango.attr_type_register(name
)
name : | a name for the type. (Currently not
used.) |
Returns : | the new attribute type ID
integer. |
The attr_type_register
() function returns a
new attribute type ID integer value.
pango.AttrLanguage
def pango.AttrLanguage(language
, start_index
=0, end_index
=1)
language : | a pango.Language
object. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object. |
The AttrLanguage
() function creates a new
pango.Attribute
object of the type pango.ATTR_LANGUAGE
with the pango.Language
specified by language
and the text range specified by
start_index
and
end_index
.
pango.AttrFamily
def pango.AttrFamily(family
, start_index
=0, end_index
=1)
family : | the string containing a font family name
list. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object. |
The AttrFamily
() function creates a new
pango.Attribute
object of the type pango.ATTR_FAMILY
with the font family
name list specified by the string family
and the text
range specified by start_index
and
end_index
.
pango.AttrForeground
def pango.AttrForeground(red
, green
, blue
, start_index
=0, end_index
=1)
red : | the red component of the color in the range 0
to 65535. |
green : | the green component of the color in the range 0
to 65535. |
blue : | the blue component of the color in the range 0
to 65535. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object. |
The AttrForeground
() function creates a new
pango.Attribute
of the type pango.ATTR_FOREGROUND
with the RGB color
specified by red
, green
and
blue
and the text range specified by
start_index
and
end_index
.
pango.AttrBackground
def pango.AttrBackground(red
, green
, blue
, start_index
=0, end_index
=1)
red : | the red component of the color in the range 0
to 65535. |
green : | the green component of the color in the range 0
to 65535. |
blue : | the blue component of the color in the range 0
to 65535. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object. |
The AttrBackground
() function creates a new
pangoAttribute of the type pango.ATTR_BACKGROUND
with the
RGB color specified by red
,
green
and blue
and the text
range specified by start_index
and
end_index
.
pango.AttrSize
def pango.AttrSize(size
, start_index
=0, end_index
=1)
size : | the font size in thousandths of a
point. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object |
The AttrSize
() function creates a new pango.Attribute
object of the type pango.ATTR_SIZE
with the font size
specified by size
and the text range specified by
start_index
and
end_index
.
pango.AttrStyle
def pango.AttrStyle(style
, start_index
=0, end_index
=1)
style : | the font slant style. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object |
The AttrStyle
() function creates a new
pango.Attribute
object of the type pango.ATTR_STYLE
with the font slant
style specified by style
and the text range specified
by start_index
and end_index
.
The value of style
must be one of:
pango.STYLE_NORMAL | The font is upright. |
pango.STYLE_OBLIQUE | The font is slanted in a roman style. |
pango.STYLE_ITALIC | The font is slanted in an italic style. |
pango.AttrWeight
def pango.AttrWeight(weight
, start_index
=0, end_index
=1)
weight : | the font weight. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object |
The AttrWeight
() function creates a new
pango.Attribute
object of the type pango.ATTR_WEIGHT
with the font weight
specified by weight
and the text range specified by
start_index
and end_index
. The
value of style
must be one of:
pango.WEIGHT_ULTRALIGHT | The ultralight weight (= 200). |
pango.WEIGHT_LIGHT | The light weight (=300). |
pango.WEIGHT_NORMAL | The default weight (= 400). |
pango.WEIGHT_BOLD | The bold weight (= 700). |
pango.WEIGHT_ULTRABOLD | The ultrabold weight (= 800). |
pango.WEIGHT_HEAVY | The heavy weight (= 900). |
pango.AttrVariant
def pango.AttrVariant(variant
, start_index
=0, end_index
=1)
variant : | the font variant. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object |
The AttrVariant
() function creates a new
pango.Attribute
object of the type pango.ATTR_VARIANT
with the font
variant specified by variant
and the text range
specified by start_index
and
end_index
. The value of
variant
must be one of:
pango.VARIANT_NORMAL | A normal font. |
pango.VARIANT_SMALL_CAPS | A font with the lower case characters replaced by
smaller variants of the capital characters. |
pango.AttrStretch
def pango.AttrStretch(stretch
, start_index
=0, end_index
=1)
stretch : | the font stretch style. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object |
The AttrStretch
() function creates a new
pango.Attribute
object of the type pango.ATTR_STRETCH
with the font
stretch style specified by stretch
and the text range
specified by start_index
and
end_index
. The value of
stretch
must be one of:
pango.STRETCH_ULTRA_CONDENSED | The most narrow width |
pango.STRETCH_EXTRA_CONDENSED | |
pango.STRETCH_CONDENSED | |
pango.STRETCH_SEMI_CONDENSED | |
pango.STRETCH_NORMAL | The normal width. |
pango.STRETCH_SEMI_EXPANDED | |
pango.STRETCH_EXPANDED | |
pango.STRETCH_EXTRA_EXPANDED | |
pango.STRETCH_ULTRA_EXPANDED | The most expanded width |
pango.AttrFontDesc
def pango.AttrFontDesc(desc
, start_index
=0, end_index
=1)
desc : | a pango.FontDescription
object. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object |
The AttrFontDesc
() function creates a new
pango.Attribute
object of the type pango.ATTR_FONT_DESC
with the pango.FontDescription
specified by desc
and the text range specified by
start_index
and
end_index
.
pango.AttrUnderline
def pango.AttrUnderline(underline
, start_index
=0, end_index
=1)
underline : | the underline style. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object |
The AttrUnderline
() function creates a new
pango.Attribute
object of the type pango.ATTR_UNDERLINE
with the
underline style specified by underline
and the text
range specified by start_index
and
end_index
. The value of
underline
must be one of:
pango.UNDERLINE_NONE | No underline should be drawn. |
pango.UNDERLINE_SINGLE | A single underline should be drawn. |
pango.UNDERLINE_DOUBLE | A double underline should be drawn. |
pango.UNDERLINE_LOW | A single underline should be drawn at a position
beneath the ink extents of the text being underlined. This should be used
only for underlining single characters, such as for keyboard accelerators.
pango.UNDERLINE_SINGLE should be used for extended
portions of text. |
pango.AttrStrikethrough
def pango.AttrStrikethrough(strikethrough
, start_index
=0, end_index
=1)
strikethrough : | if True the text should be
struck through. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object |
The AttrStrikethrough
() function creates a
new pango.Attribute
object of the type pango.ATTR_STRIKETHROUGH
with the
value specified by strikethrough
and the text range
specified by start_index
and
end_index
. If strikethough is True
the text should be struck through.
pango.AttrRise
def pango.AttrRise(rise
, start_index
=0, end_index
=1)
rise : | the displacement of the text from the
baseline. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object |
The AttrRise
() function creates a new pango.Attribute
object of the type pango.ATTR_RISE
with the text
displacement from the baseline specified by rise
and
the text range specified by start_index
and
end_index
.
pango.AttrShape
def pango.AttrShape(ink_rect
, logical_rect
, start_index
=0, end_index
=1)
ink_rect : | the ink rectangle of the
shape. |
logical_rect : | the logical rectangle of the
shape. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object |
The AttrShape
() function creates a new
pango.Attribute
object of the type pango.ATTR_SHAPE
with the shape
rectangles specified by ink_rect
and
logical_rect
and the text range specified by
start_index
and end_index
. A
shape is used to impose a particular ink and logical rect on the result of
shaping a particular glyph. This might be used, for instance, for embedding
a picture or a widget inside a pango.Layout
.
pango.AttrScale
def pango.AttrScale(scale
, start_index
=0, end_index
=1)
scale : | the font size scale factor as a
float. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object |
The AttrScale
() function creates a new
pango.Attribute
object of the type pango.ATTR_SCALE
with the font size
scale factor specified by scale
and the text range
specified by start_index
and
end_index
. The value of scale
can also be one of the following pre-defined values:
pango.SCALE_XX_SMALL | 0.5787037037037 - the scale factor for three shrinking
steps (1 / (1.2 * 1.2 * 1.2)). |
pango.SCALE_X_SMALL | 0.6444444444444 - the scale factor for two shrinking
steps (1 / (1.2 * 1.2)). |
pango.SCALE_SMALL | 0.8333333333333 - the scale factor for one shrinking
step (1 / 1.2). |
pango.SCALE_MEDIUM | 1.0 - The scale factor for normal size. |
pango.SCALE_LARGE | 1.2 - the scale factor for one magnification
step. |
pango.SCALE_X_LARGE | 1.4399999999999 - the scale factor for two
magnification steps (1.2 * 1.2). |
pango.SCALE_XX_LARGE | 1.728 - the scale factor for three magnification steps
(1.2 * 1.2 * 1.2). |
pango.AttrFallback
def pango.AttrFallback(fallback
, start_index
=0, end_index
=1)
fallback : | if True , we should fall back
on other fonts for characters the active font is
missing. |
start_index : | the index of the start of the attribute
application in the text. |
end_index : | the index of the end of the attribute
application in the text. |
Returns : | a new pango.Attribute
object |
Note
This function is available in PyGTK 2.4 and above.
The AttrFallback
() function creates a new
pango.Attribute
object of the type pango.ATTR_FALLBACK
. If fallback is
True
other fonts on the system can be used to provide
characters missing from the current font. Otherwise, only characters from
the closest matching font can be used.