wx.richtext.RichTextParagraph¶

This object represents a single paragraph containing various objects such as text content, images, and further paragraph layout objects.

Class Hierarchy¶

Inheritance diagram for class RichTextParagraph:

Methods Summary¶

`__init__`	Constructor taking a parent and style.
`AllocateLine`	Allocates or reuses a line object.
`ApplyParagraphStyle`	Applies paragraph styles such as centering to the wrapped lines.
`CalculateRange`	Calculates the range of the object.
`ClearDefaultTabs`	Clears the default tabstop array.
`ClearLines`	Clears the cached lines.
`ClearUnusedLines`	Clears remaining unused line objects, if any.
`Clone`	Clones the object.
`Copy`	Copies the object.
`Draw`	Draw the item, within the given range.
`FindObjectAtPosition`	Finds the object at the given position.
`FindPosition`	Finds the absolute position and row height for the given character position.
`FindWrapPosition`	Finds a suitable wrap position.
`GetBulletText`	Returns the bullet text for this paragraph.
`GetCombinedAttributes`	Returns combined attributes of the base style, paragraph style and character style.
`GetContiguousPlainText`	Returns the plain text searching from the start or end of the range.
`GetDefaultTabs`	Returns the default tabstop array.
`GetFirstLineBreakPosition`	Returns the first position from pos that has a line break character.
`GetImpactedByFloatingObjects`	Whether the paragraph is impacted by floating objects from above.
`GetLines`	Returns the cached lines.
`GetRangeSize`	Returns the object size for the given range.
`GetXMLNodeName`	Returns the `XML` node name of this object.
`HitTest`	Hit-testing: returns a flag indicating hit test details, plus information about position.
`Init`
`InitDefaultTabs`	Creates a default tabstop array.
`InsertText`	Inserts text at the given position.
`Layout`	Lay the item out at the specified position with the given size constraint.
`LayoutFloat`	Lays out the floating objects.
`MoveFromList`	Adds content back from a list.
`MoveToList`	Moves content to a list from this point.
`SetImpactedByFloatingObjects`	Sets whether the paragraph is impacted by floating objects from above.
`SplitAt`	Splits an object at this position if necessary, and returns the previous object, or `None` if inserting at the beginning.

Properties Summary¶

`BulletText`	See `GetBulletText`
`CombinedAttributes`	See `GetCombinedAttributes`
`ImpactedByFloatingObjects`	See `GetImpactedByFloatingObjects` and `SetImpactedByFloatingObjects`
`Lines`	See `GetLines`
`XMLNodeName`	See `GetXMLNodeName`

Class API¶

class wx.richtext.RichTextParagraph(RichTextCompositeObject)¶

Possible constructors:

RichTextParagraph(parent=None, style=None)

RichTextParagraph(text, parent=None, paraStyle=None, charStyle=None)

RichTextParagraph(obj)

This object represents a single paragraph containing various objects such as text content, images, and further paragraph layout objects.

Methods¶

__init__(self, *args, **kw)¶

Overloaded Implementations:

__init__ (self, parent=None, style=None)

Constructor taking a parent and style.

Parameters

parent (wx.richtext.RichTextObject) –
style (wx.richtext.RichTextAttr) –

__init__ (self, text, parent=None, paraStyle=None, charStyle=None)

Constructor taking a text string, a parent and paragraph and character attributes.

Parameters

text (string) –
parent (wx.richtext.RichTextObject) –
paraStyle (wx.richtext.RichTextAttr) –
charStyle (wx.richtext.RichTextAttr) –

__init__ (self, obj)

Parameters: obj (wx.richtext.RichTextParagraph) –

AllocateLine(self, pos)¶

Allocates or reuses a line object.

Parameters: pos (int) –
Return type: wx.richtext.RichTextLine

ApplyParagraphStyle(self, line, attr, rect, dc)¶

Applies paragraph styles such as centering to the wrapped lines.

Parameters

line (wx.richtext.RichTextLine) –
attr (wx.richtext.RichTextAttr) –
rect (wx.Rect) –
dc (wx.DC) –

CalculateRange(self, start)¶

Calculates the range of the object.

By default, guess that the object is 1 unit long.

Parameters: start (long) –
Return type: end

static ClearDefaultTabs()¶: Clears the default tabstop array.

ClearLines(self)¶: Clears the cached lines.

ClearUnusedLines(self, lineCount)¶

Clears remaining unused line objects, if any.

Parameters: lineCount (int) –
Return type: bool

Clone(self)¶

Clones the object.

Return type: wx.richtext.RichTextObject

Copy(self, obj)¶

Copies the object.

Parameters: obj (wx.richtext.RichTextParagraph) –

Draw(self, dc, context, range, selection, rect, descent, style)¶

Draw the item, within the given range.

Some objects may ignore the range (for example paragraphs) while others must obey it (lines, to implement wrapping)

Parameters

dc (wx.DC) –
context (wx.richtext.RichTextDrawingContext) –
range (wx.richtext.RichTextRange) –
selection (wx.richtext.RichTextSelection) –
rect (wx.Rect) –
descent (int) –
style (int) –

Return type

bool

FindObjectAtPosition(self, position)¶

Finds the object at the given position.

Parameters: position (long) –
Return type: wx.richtext.RichTextObject

FindPosition(self, dc, context, index, forceLineStart)¶

Finds the absolute position and row height for the given character position.

Parameters

dc (wx.DC) –
context (wx.richtext.RichTextDrawingContext) –
index (long) –
forceLineStart (bool) –

Return type

tuple

Returns

( bool, pt, height )

FindWrapPosition(self, range, dc, context, availableSpace, wrapPosition, partialExtents)¶

Finds a suitable wrap position.

wrapPosition is the last position in the line to the left of the split.

Parameters

range (wx.richtext.RichTextRange) –
dc (wx.DC) –
context (wx.richtext.RichTextDrawingContext) –
availableSpace (int) –
wrapPosition (long) –
partialExtents (list of integers) –

Return type

bool

GetBulletText(self)¶

Returns the bullet text for this paragraph.

Return type: string

GetCombinedAttributes(self, *args, **kw)¶

Overloaded Implementations:

GetCombinedAttributes (self, contentStyle, includingBoxAttr=False)

Returns combined attributes of the base style, paragraph style and character style.

We use this to dynamically retrieve the actual style.

Parameters

contentStyle (wx.richtext.RichTextAttr) –
includingBoxAttr (bool) –

Return type

wx.richtext.RichTextAttr

GetCombinedAttributes (self, includingBoxAttr=False)

Returns the combined attributes of the base style and paragraph style.

Parameters: includingBoxAttr (bool) –
Return type: wx.richtext.RichTextAttr

GetContiguousPlainText(self, text, range, fromStart=True)¶

Returns the plain text searching from the start or end of the range.

The resulting string may be shorter than the range given.

Parameters

text (string) –
range (wx.richtext.RichTextRange) –
fromStart (bool) –

Return type

bool

static GetDefaultTabs()¶

Returns the default tabstop array.

Return type: list of integers

GetFirstLineBreakPosition(self, pos)¶

Returns the first position from pos that has a line break character.

Parameters: pos (long) –
Return type: long

GetImpactedByFloatingObjects(self)¶

Whether the paragraph is impacted by floating objects from above.

Return type: int

GetLines(self)¶

Returns the cached lines.

Return type: PyObject

GetRangeSize(self, range, size, descent, dc, context, flags, position=Point(0, 0), parentSize=DefaultSize, partialExtents=None)¶

Returns the object size for the given range.

Returns False if the range is invalid for this object.

Parameters

range (wx.richtext.RichTextRange) –
size (wx.Size) –
descent (int) –
dc (wx.DC) –
context (wx.richtext.RichTextDrawingContext) –
flags (int) –
position (wx.Point) –
parentSize (wx.Size) –
partialExtents (list of integers) –

Return type

bool

GetXMLNodeName(self)¶

Returns the XML node name of this object.

This must be overridden for XmlNode-base XML export to work.

Return type: string

HitTest(self, dc, context, pt, flags=0)¶

Hit-testing: returns a flag indicating hit test details, plus information about position.

contextObj is returned to specify what object position is relevant to, since otherwise there’s an ambiguity. @ obj might not be a child of contextObj, since we may be referring to the container itself if we have no hit on a child - for example if we click outside an object.

The function puts the position in textPosition if one is found. pt is in logical units (a zero y position is at the beginning of the buffer).

Parameters

dc (wx.DC) –
context (wx.richtext.RichTextDrawingContext) –
pt (wx.Point) –
flags (int) –

Return type

tuple

Returns

( int, textPosition, obj, contextObj )

Init(self)¶

static InitDefaultTabs()¶: Creates a default tabstop array.

InsertText(self, pos, text)¶

Inserts text at the given position.

Parameters

pos (long) –
text (string) –

Return type

bool

Layout(self, dc, context, rect, parentRect, style)¶

Lay the item out at the specified position with the given size constraint.

Layout must set the cached size. rect is the available space for the object, and parentRect is the container that is used to determine a relative size or position (for example if a text box must be 50% of the parent text box).

Parameters

dc (wx.DC) –
context (wx.richtext.RichTextDrawingContext) –
rect (wx.Rect) –
parentRect (wx.Rect) –
style (int) –

Return type

bool

LayoutFloat(self, dc, context, rect, parentRect, style, floatCollector)¶

Lays out the floating objects.

Parameters

dc (wx.DC) –
context (wx.richtext.RichTextDrawingContext) –
rect (wx.Rect) –
parentRect (wx.Rect) –
style (int) –
floatCollector (RichTextFloatCollector) –

MoveFromList(self, list)¶

Adds content back from a list.

Parameters: list (RichTextObjectList_) –

MoveToList(self, obj, list)¶

Moves content to a list from this point.

Parameters

obj (wx.richtext.RichTextObject) –
list (RichTextObjectList_) –

SetImpactedByFloatingObjects(self, i)¶

Sets whether the paragraph is impacted by floating objects from above.

Parameters: i (int) –

SplitAt(self, pos, previousObject=None)¶

Splits an object at this position if necessary, and returns the previous object, or None if inserting at the beginning.

Parameters

pos (long) –
previousObject (RichTextObject) –

Return type

wx.richtext.RichTextObject

Properties¶

BulletText¶: See GetBulletText

CombinedAttributes¶: See GetCombinedAttributes

ImpactedByFloatingObjects¶: See GetImpactedByFloatingObjects and SetImpactedByFloatingObjects

Lines¶: See GetLines

XMLNodeName¶: See GetXMLNodeName

Navigation

wx.richtext.RichTextParagraph¶

Class Hierarchy¶

Methods Summary¶

Properties Summary¶

Class API¶

Methods¶

Properties¶