HTMLLabel
(text='', location=None, x=0, y=0, width=None, height=None, anchor_x='left', anchor_y='baseline', multiline=False, dpi=None, batch=None, group=None)¶HTML formatted text label.
A subset of HTML 4.01 is supported. See pyglet.text.formats.html for details.
Constructor:
__init__
(text='', location=None, x=0, y=0, width=None, height=None, anchor_x='left', anchor_y='baseline', multiline=False, dpi=None, batch=None, group=None)¶Create a label with an HTML string.
Parameters: |
|
---|
Methods:
get_style
(name)Get a document style value by name. set_style
(name, value)Set a document style value by name over the whole document.
Attributes:
anchor_x
Horizontal anchor alignment. anchor_y
Vertical anchor alignment. bold
Bold font style. color
Text color. content_valign
Vertical alignment of content within larger layout box. document
dpi
Get DPI used by this layout. font_name
Font family name. font_size
Font size, in points. height
Height of the layout. italic
Italic font style. multiline
Set if multiline layout is enabled. text
HTML formatted text of the label. width
Width of the layout. x
X coordinate of the layout. y
Y coordinate of the layout.
Methods
HTMLLabel.
begin_update
()Indicate that a number of changes to the layout or document are about to occur.
Changes to the layout or document between calls to begin_update and end_update do not trigger any costly relayout of text. Relayout of all changes is performed when end_update is called.
Note that between the begin_update and end_update calls, values such as content_width and content_height are undefined (i.e., they may or may not be updated to reflect the latest changes).
HTMLLabel.
delete
()Remove this layout from its batch.
HTMLLabel.
draw
()Draw this text layout.
Note that this method performs very badly if a batch was supplied to the constructor. If you add this layout to a batch, you should ideally use only the batch’s draw method.
HTMLLabel.
end_update
()Perform pending layout changes since begin_update.
See begin_update.
HTMLLabel.
get_style
(name)Get a document style value by name.
If the document has more than one value of the named style, pyglet.text.document.STYLE_INDETERMINATE is returned.
Parameters: name (str) – Style name to query. See documentation for pyglet.text.layout for known style names. Return type: object
HTMLLabel.
on_delete_text
(start, end)Event handler for AbstractDocument.on_delete_text.
The event handler is bound by the text layout; there is no need for applications to interact with this method.
HTMLLabel.
on_insert_text
(start, text)Event handler for AbstractDocument.on_insert_text.
The event handler is bound by the text layout; there is no need for applications to interact with this method.
HTMLLabel.
on_style_text
(start, end, attributes)Event handler for AbstractDocument.on_style_text.
The event handler is bound by the text layout; there is no need for applications to interact with this method.
HTMLLabel.
set_style
(name, value)Set a document style value by name over the whole document.
Parameters:
- name (str) – Name of the style to set. See documentation for pyglet.text.layout for known style names.
- value (object) – Value of the style.
Attributes
HTMLLabel.
anchor_x
Horizontal anchor alignment.
This property determines the meaning of the x coordinate. It is one of the enumerants:
"left"
(default)- The X coordinate gives the position of the left edge of the layout.
"center"
- The X coordinate gives the position of the center of the layout.
"right"
- The X coordinate gives the position of the right edge of the layout.
For the purposes of calculating the position resulting from this alignment, the width of the layout is taken to be width if multiline is True and wrap_lines is True, otherwise content_width.
Type: str
HTMLLabel.
anchor_y
Vertical anchor alignment.
This property determines the meaning of the y coordinate. It is one of the enumerants:
"top"
- The Y coordinate gives the position of the top edge of the layout.
"center"
- The Y coordinate gives the position of the center of the layout.
"baseline"
- The Y coordinate gives the position of the baseline of the first line of text in the layout.
"bottom"
(default)- The Y coordinate gives the position of the bottom edge of the layout.
For the purposes of calculating the position resulting from this alignment, the height of the layout is taken to be the smaller of height and content_height.
See also content_valign.
Type: str
HTMLLabel.
background_group
= OrderedGroup(0)
HTMLLabel.
bold
Bold font style.
Type: bool
HTMLLabel.
color
Text color.
Color is a 4-tuple of RGBA components, each in range [0, 255].
Type: (int, int, int, int)
HTMLLabel.
content_valign
Vertical alignment of content within larger layout box.
This property determines how content is positioned within the layout box when
content_height
is less thanheight
. It is one of the enumerants:
top
(default)- Content is aligned to the top of the layout box.
center
- Content is centered vertically within the layout box.
bottom
- Content is aligned to the bottom of the layout box.
This property has no effect when
content_height
is greater thanheight
(in which case the content is aligned to the top) or whenheight
isNone
(in which case there is no vertical layout box dimension).
Type: str
HTMLLabel.
document
HTMLLabel.
dpi
Get DPI used by this layout.
Read-only.
Type: float
HTMLLabel.
font_name
Font family name.
The font name, as passed to pyglet.font.load. A list of names can optionally be given: the first matching font will be used.
Type: str or list
HTMLLabel.
font_size
Font size, in points.
Type: float
HTMLLabel.
foreground_decoration_group
= TextLayoutForegroundDecorationGroup(2)
HTMLLabel.
foreground_group
= TextLayoutForegroundGroup(1)
HTMLLabel.
height
Height of the layout.
Type: int
HTMLLabel.
italic
Italic font style.
Type: bool
HTMLLabel.
multiline
Set if multiline layout is enabled.
If multiline is False, newline and paragraph characters are ignored and text is not word-wrapped. If True, the text is word-wrapped only if the wrap_lines is True.
Type: bool
HTMLLabel.
top_group
= <pyglet.text.layout.TextLayoutGroup object>
HTMLLabel.
width
Width of the layout.
This property has no effect if multiline is False or wrap_lines is False.
Type: int
HTMLLabel.
x
X coordinate of the layout.
See also anchor_x.
Type: int
HTMLLabel.
y
Y coordinate of the layout.
See also anchor_y.
Type: int