Version: 3.0.2
wxRichTextObject Class Referenceabstract

#include <wx/richtext/richtextbuffer.h>

+ Inheritance diagram for wxRichTextObject:

Detailed Description

This is the base for drawable rich text objects.

Library:  wxRichText
Category:  Rich Text
See Also
wxRichTextBuffer, wxRichTextCtrl

Public Member Functions

 wxRichTextObject (wxRichTextObject *parent=NULL)
 Constructor, taking an optional parent pointer.
 
virtual ~wxRichTextObject ()
 
virtual bool Draw (wxDC &dc, wxRichTextDrawingContext &context, const wxRichTextRange &range, const wxRichTextSelection &selection, const wxRect &rect, int descent, int style)=0
 Draw the item, within the given range.
 
virtual bool Layout (wxDC &dc, wxRichTextDrawingContext &context, const wxRect &rect, const wxRect &parentRect, int style)=0
 Lay the item out at the specified position with the given size constraint.
 
virtual int HitTest (wxDC &dc, wxRichTextDrawingContext &context, const wxPoint &pt, long &textPosition, wxRichTextObject **obj, wxRichTextObject **contextObj, int flags=0)
 Hit-testing: returns a flag indicating hit test details, plus information about position.
 
virtual bool FindPosition (wxDC &dc, wxRichTextDrawingContext &context, long index, wxPoint &pt, int *height, bool forceLineStart)
 Finds the absolute position and row height for the given character position.
 
virtual wxSize GetBestSize () const
 Returns the best size, i.e. the ideal starting size for this object irrespective of available space.
 
virtual bool GetRangeSize (const wxRichTextRange &range, wxSize &size, int &descent, wxDC &dc, wxRichTextDrawingContext &context, int flags, const wxPoint &position=wxPoint(0, 0), const wxSize &parentSize=wxDefaultSize, wxArrayInt *partialExtents=NULL) const =0
 Returns the object size for the given range.
 
virtual wxRichTextObjectDoSplit (long pos)
 Do a split from pos, returning an object containing the second part, and setting the first part in 'this'.
 
virtual void CalculateRange (long start, long &end)
 Calculates the range of the object.
 
virtual bool DeleteRange (const wxRichTextRange &range)
 Deletes the given range.
 
virtual bool IsEmpty () const
 Returns true if the object is empty.
 
virtual bool IsFloatable () const
 Returns true if this class of object is floatable.
 
virtual bool IsFloating () const
 Returns true if this object is currently floating.
 
virtual int GetFloatDirection () const
 Returns the floating direction.
 
virtual wxString GetTextForRange (const wxRichTextRange &range) const
 Returns any text in this object for the given range.
 
virtual bool CanMerge (wxRichTextObject *object, wxRichTextDrawingContext &context) const
 Returns true if this object can merge itself with the given one.
 
virtual bool Merge (wxRichTextObject *object, wxRichTextDrawingContext &context)
 Returns true if this object merged itself with the given one.
 
virtual bool CanSplit (wxRichTextDrawingContext &context) const
 Returns true if this object can potentially be split, by virtue of having different virtual attributes for individual sub-objects.
 
virtual wxRichTextObjectSplit (wxRichTextDrawingContext &context)
 Returns the final object in the split objects if this object was split due to differences between sub-object virtual attributes.
 
virtual void Dump (wxTextOutputStream &stream)
 Dump object data to the given output stream for debugging.
 
virtual bool CanEditProperties () const
 Returns true if we can edit the object's properties via a GUI.
 
virtual bool EditProperties (wxWindow *parent, wxRichTextBuffer *buffer)
 Edits the object's properties via a GUI.
 
virtual wxString GetPropertiesMenuLabel () const
 Returns the label to be used for the properties context menu item.
 
virtual bool AcceptsFocus () const
 Returns true if objects of this class can accept the focus, i.e. a call to SetFocusObject is possible.
 
virtual bool ImportFromXML (wxRichTextBuffer *buffer, wxXmlNode *node, wxRichTextXMLHandler *handler, bool *recurse)
 Imports this object from XML.
 
virtual bool UsesParagraphAttributes () const
 Returns true if this object takes note of paragraph attributes (text and image objects don't).
 
virtual wxString GetXMLNodeName () const
 Returns the XML node name of this object.
 
virtual void Invalidate (const wxRichTextRange &invalidRange=wxRICHTEXT_ALL)
 Invalidates the object at the given range.
 
virtual bool HandlesChildSelections () const
 Returns true if this object can handle the selections of its children, fOr example a table.
 
virtual wxRichTextSelection GetSelection (long start, long end) const
 Returns a selection object specifying the selections between start and end character positions.
 
virtual wxSize GetCachedSize () const
 Gets the cached object size as calculated by Layout.
 
virtual void SetCachedSize (const wxSize &sz)
 Sets the cached object size as calculated by Layout.
 
virtual wxSize GetMaxSize () const
 Gets the maximum object size as calculated by Layout.
 
virtual void SetMaxSize (const wxSize &sz)
 Sets the maximum object size as calculated by Layout.
 
virtual wxSize GetMinSize () const
 Gets the minimum object size as calculated by Layout.
 
virtual void SetMinSize (const wxSize &sz)
 Sets the minimum object size as calculated by Layout.
 
virtual wxTextAttrSize GetNaturalSize () const
 Gets the 'natural' size for an object.
 
virtual wxPoint GetPosition () const
 Returns the object position in pixels.
 
virtual void SetPosition (const wxPoint &pos)
 Sets the object position in pixels.
 
virtual wxPoint GetAbsolutePosition () const
 Returns the absolute object position, by traversing up the child/parent hierarchy.
 
virtual wxRect GetRect () const
 Returns the rectangle enclosing the object.
 
void SetRange (const wxRichTextRange &range)
 Sets the object's range within its container.
 
const wxRichTextRangeGetRange () const
 Returns the object's range.
 
wxRichTextRangeGetRange ()
 Returns the object's range.
 
void SetOwnRange (const wxRichTextRange &range)
 Set the object's own range, for a top-level object with its own position space.
 
const wxRichTextRangeGetOwnRange () const
 Returns the object's own range (valid if top-level).
 
wxRichTextRangeGetOwnRange ()
 Returns the object's own range (valid if top-level).
 
wxRichTextRange GetOwnRangeIfTopLevel () const
 Returns the object's own range only if a top-level object.
 
virtual bool IsComposite () const
 Returns true if this object is composite.
 
virtual bool IsAtomic () const
 Returns true if no user editing can be done inside the object.
 
virtual wxRichTextObjectGetParent () const
 Returns a pointer to the parent object.
 
virtual void SetParent (wxRichTextObject *parent)
 Sets the pointer to the parent object.
 
virtual
wxRichTextParagraphLayoutBox
GetContainer () const
 Returns the top-level container of this object.
 
virtual
wxRichTextParagraphLayoutBox
GetParentContainer () const
 Returns the top-level container of this object.
 
virtual void SetMargins (int margin)
 Set the margin around the object, in pixels.
 
virtual void SetMargins (int leftMargin, int rightMargin, int topMargin, int bottomMargin)
 Set the margin around the object, in pixels.
 
virtual int GetLeftMargin () const
 Returns the left margin of the object, in pixels.
 
virtual int GetRightMargin () const
 Returns the right margin of the object, in pixels.
 
virtual int GetTopMargin () const
 Returns the top margin of the object, in pixels.
 
virtual int GetBottomMargin () const
 Returns the bottom margin of the object, in pixels.
 
virtual wxRect GetAvailableContentArea (wxDC &dc, wxRichTextDrawingContext &context, const wxRect &outerRect) const
 Calculates the available content space in the given rectangle, given the margins, border and padding specified in the object's attributes.
 
virtual bool LayoutToBestSize (wxDC &dc, wxRichTextDrawingContext &context, wxRichTextBuffer *buffer, const wxRichTextAttr &parentAttr, const wxRichTextAttr &attr, const wxRect &availableParentSpace, const wxRect &availableContainerSpace, int style)
 Lays out the object first with a given amount of space, and then if no width was specified in attr, lays out the object again using the minimum size.
 
virtual bool AdjustAttributes (wxRichTextAttr &attr, wxRichTextDrawingContext &context)
 Adjusts the attributes for virtual attribute provision, collapsed borders, etc.
 
void SetAttributes (const wxRichTextAttr &attr)
 Sets the object's attributes.
 
const wxRichTextAttrGetAttributes () const
 Returns the object's attributes.
 
wxRichTextAttrGetAttributes ()
 Returns the object's attributes.
 
wxRichTextPropertiesGetProperties ()
 Returns the object's properties.
 
const wxRichTextPropertiesGetProperties () const
 Returns the object's properties.
 
void SetProperties (const wxRichTextProperties &props)
 Sets the object's properties.
 
void SetDescent (int descent)
 Sets the stored descent value.
 
int GetDescent () const
 Returns the stored descent value.
 
wxRichTextBufferGetBuffer () const
 Returns the containing buffer.
 
void SetName (const wxString &name)
 Sets the identifying name for this object as a property using the "name" key.
 
wxString GetName () const
 Returns the identifying name for this object from the properties, using the "name" key.
 
virtual bool IsTopLevel () const
 Returns true if this object is top-level, i.e. contains its own paragraphs, such as a text box.
 
bool IsShown () const
 Returns true if the object will be shown, false otherwise.
 
virtual void Show (bool show)
 Call to show or hide this object.
 
virtual wxRichTextObjectClone () const
 Clones the object.
 
void Copy (const wxRichTextObject &obj)
 Copies the object.
 
void Reference ()
 Reference-counting allows us to use the same object in multiple lists (not yet used).
 
void Dereference ()
 Reference-counting allows us to use the same object in multiple lists (not yet used).
 
virtual void Move (const wxPoint &pt)
 Moves the object recursively, by adding the offset from old to new.
 
int ConvertTenthsMMToPixels (wxDC &dc, int units) const
 Converts units in tenths of a millimetre to device units.
 
int ConvertPixelsToTenthsMM (wxDC &dc, int pixels) const
 Convert units in pixels to tenths of a millimetre.
 
- Public Member Functions inherited from wxObject
 wxObject ()
 Default ctor; initializes to NULL the internal reference data.
 
 wxObject (const wxObject &other)
 Copy ctor.
 
virtual ~wxObject ()
 Destructor.
 
virtual wxClassInfoGetClassInfo () const
 This virtual function is redefined for every class that requires run-time type information, when using the wxDECLARE_CLASS macro (or similar).
 
wxObjectRefDataGetRefData () const
 Returns the wxObject::m_refData pointer, i.e. the data referenced by this object.
 
bool IsKindOf (const wxClassInfo *info) const
 Determines whether this class is a subclass of (or the same class as) the given class.
 
bool IsSameAs (const wxObject &obj) const
 Returns true if this object has the same data pointer as obj.
 
void Ref (const wxObject &clone)
 Makes this object refer to the data in clone.
 
void SetRefData (wxObjectRefData *data)
 Sets the wxObject::m_refData pointer.
 
void UnRef ()
 Decrements the reference count in the associated data, and if it is zero, deletes the data.
 
void UnShare ()
 This is the same of AllocExclusive() but this method is public.
 
void operator delete (void *buf)
 The delete operator is defined for debugging versions of the library only, when the identifier WXDEBUG is defined.
 
void * operator new (size_t size, const wxString &filename=NULL, int lineNum=0)
 The new operator is defined for debugging versions of the library only, when the identifier WXDEBUG is defined.
 

Static Public Member Functions

static int ConvertTenthsMMToPixels (int ppi, int units, double scale=1.0)
 Converts units in tenths of a millimetre to device units.
 
static int ConvertPixelsToTenthsMM (int ppi, int pixels, double scale=1.0)
 Convert units in pixels to tenths of a millimetre.
 
static bool DrawBoxAttributes (wxDC &dc, wxRichTextBuffer *buffer, const wxRichTextAttr &attr, const wxRect &boxRect, int flags=0, wxRichTextObject *obj=NULL)
 Draws the borders and background for the given rectangle and attributes.
 
static bool DrawBorder (wxDC &dc, wxRichTextBuffer *buffer, const wxTextAttrBorders &attr, const wxRect &rect, int flags=0)
 Draws a border.
 
static bool GetBoxRects (wxDC &dc, wxRichTextBuffer *buffer, const wxRichTextAttr &attr, wxRect &marginRect, wxRect &borderRect, wxRect &contentRect, wxRect &paddingRect, wxRect &outlineRect)
 Returns the various rectangles of the box model in pixels.
 
static bool GetTotalMargin (wxDC &dc, wxRichTextBuffer *buffer, const wxRichTextAttr &attr, int &leftMargin, int &rightMargin, int &topMargin, int &bottomMargin)
 Returns the total margin for the object in pixels, taking into account margin, padding and border size.
 
static wxRect AdjustAvailableSpace (wxDC &dc, wxRichTextBuffer *buffer, const wxRichTextAttr &parentAttr, const wxRichTextAttr &childAttr, const wxRect &availableParentSpace, const wxRect &availableContainerSpace)
 Returns the rectangle which the child has available to it given restrictions specified in the child attribute, e.g.
 

Protected Attributes

wxSize m_size
 
wxSize m_maxSize
 
wxSize m_minSize
 
wxPoint m_pos
 
int m_descent
 
int m_refCount
 
bool m_show
 
wxRichTextObjectm_parent
 
wxRichTextRange m_range
 
wxRichTextRange m_ownRange
 
wxRichTextAttr m_attributes
 
wxRichTextProperties m_properties
 
- Protected Attributes inherited from wxObject
wxObjectRefDatam_refData
 Pointer to an object which is the object's reference-counted data.
 

Additional Inherited Members

- Protected Member Functions inherited from wxObject
void AllocExclusive ()
 Ensure that this object's data is not shared with any other object.
 
virtual wxObjectRefDataCreateRefData () const
 Creates a new instance of the wxObjectRefData-derived class specific to this object and returns it.
 
virtual wxObjectRefDataCloneRefData (const wxObjectRefData *data) const
 Creates a new instance of the wxObjectRefData-derived class specific to this object and initializes it copying data.
 

Constructor & Destructor Documentation

wxRichTextObject::wxRichTextObject ( wxRichTextObject parent = NULL)

Constructor, taking an optional parent pointer.

virtual wxRichTextObject::~wxRichTextObject ( )
virtual

Member Function Documentation

virtual bool wxRichTextObject::AcceptsFocus ( ) const
virtual

Returns true if objects of this class can accept the focus, i.e. a call to SetFocusObject is possible.

For example, containers supporting text, such as a text box object, can accept the focus, but a table can't (set the focus to individual cells instead).

Reimplemented in wxRichTextTable, wxRichTextField, and wxRichTextParagraphLayoutBox.

virtual bool wxRichTextObject::AdjustAttributes ( wxRichTextAttr attr,
wxRichTextDrawingContext context 
)
virtual

Adjusts the attributes for virtual attribute provision, collapsed borders, etc.

static wxRect wxRichTextObject::AdjustAvailableSpace ( wxDC dc,
wxRichTextBuffer buffer,
const wxRichTextAttr parentAttr,
const wxRichTextAttr childAttr,
const wxRect availableParentSpace,
const wxRect availableContainerSpace 
)
static

Returns the rectangle which the child has available to it given restrictions specified in the child attribute, e.g.

50% width of the parent, 400 pixels, x position 20% of the parent, etc. availableContainerSpace might be a parent that the cell has to compute its width relative to. E.g. a cell that's 50% of its parent.

virtual void wxRichTextObject::CalculateRange ( long  start,
long &  end 
)
virtual

Calculates the range of the object.

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

Reimplemented in wxRichTextTable, wxRichTextPlainText, wxRichTextParagraph, wxRichTextField, and wxRichTextCompositeObject.

virtual bool wxRichTextObject::CanEditProperties ( ) const
virtual

Returns true if we can edit the object's properties via a GUI.

Reimplemented in wxRichTextTable, wxRichTextCell, wxRichTextImage, wxRichTextField, and wxRichTextBox.

virtual bool wxRichTextObject::CanMerge ( wxRichTextObject object,
wxRichTextDrawingContext context 
) const
virtual

Returns true if this object can merge itself with the given one.

Reimplemented in wxRichTextPlainText.

virtual bool wxRichTextObject::CanSplit ( wxRichTextDrawingContext context) const
virtual

Returns true if this object can potentially be split, by virtue of having different virtual attributes for individual sub-objects.

Reimplemented in wxRichTextPlainText.

int wxRichTextObject::ConvertPixelsToTenthsMM ( wxDC dc,
int  pixels 
) const

Convert units in pixels to tenths of a millimetre.

static int wxRichTextObject::ConvertPixelsToTenthsMM ( int  ppi,
int  pixels,
double  scale = 1.0 
)
static

Convert units in pixels to tenths of a millimetre.

int wxRichTextObject::ConvertTenthsMMToPixels ( wxDC dc,
int  units 
) const

Converts units in tenths of a millimetre to device units.

static int wxRichTextObject::ConvertTenthsMMToPixels ( int  ppi,
int  units,
double  scale = 1.0 
)
static

Converts units in tenths of a millimetre to device units.

void wxRichTextObject::Copy ( const wxRichTextObject obj)

Copies the object.

virtual bool wxRichTextObject::DeleteRange ( const wxRichTextRange range)
virtual
void wxRichTextObject::Dereference ( )

Reference-counting allows us to use the same object in multiple lists (not yet used).

virtual wxRichTextObject* wxRichTextObject::DoSplit ( long  pos)
virtual

Do a split from pos, returning an object containing the second part, and setting the first part in 'this'.

Reimplemented in wxRichTextPlainText.

virtual bool wxRichTextObject::Draw ( wxDC dc,
wxRichTextDrawingContext context,
const wxRichTextRange range,
const wxRichTextSelection selection,
const wxRect rect,
int  descent,
int  style 
)
pure virtual

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)

Implemented in wxRichTextTable, wxRichTextCell, wxRichTextImage, wxRichTextPlainText, wxRichTextParagraph, wxRichTextField, wxRichTextBox, and wxRichTextParagraphLayoutBox.

static bool wxRichTextObject::DrawBorder ( wxDC dc,
wxRichTextBuffer buffer,
const wxTextAttrBorders attr,
const wxRect rect,
int  flags = 0 
)
static

Draws a border.

static bool wxRichTextObject::DrawBoxAttributes ( wxDC dc,
wxRichTextBuffer buffer,
const wxRichTextAttr attr,
const wxRect boxRect,
int  flags = 0,
wxRichTextObject obj = NULL 
)
static

Draws the borders and background for the given rectangle and attributes.

boxRect is taken to be the outer margin box, not the box around the content.

virtual void wxRichTextObject::Dump ( wxTextOutputStream stream)
virtual

Dump object data to the given output stream for debugging.

Reimplemented in wxRichTextBuffer, wxRichTextPlainText, and wxRichTextCompositeObject.

virtual bool wxRichTextObject::EditProperties ( wxWindow parent,
wxRichTextBuffer buffer 
)
virtual

Edits the object's properties via a GUI.

Reimplemented in wxRichTextTable, wxRichTextCell, wxRichTextImage, wxRichTextField, and wxRichTextBox.

virtual bool wxRichTextObject::FindPosition ( wxDC dc,
wxRichTextDrawingContext context,
long  index,
wxPoint pt,
int *  height,
bool  forceLineStart 
)
virtual

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

Reimplemented in wxRichTextTable, wxRichTextParagraph, and wxRichTextCompositeObject.

virtual wxPoint wxRichTextObject::GetAbsolutePosition ( ) const
virtual

Returns the absolute object position, by traversing up the child/parent hierarchy.

TODO: may not be needed, if all object positions are in fact relative to the top of the coordinate space.

const wxRichTextAttr& wxRichTextObject::GetAttributes ( ) const

Returns the object's attributes.

wxRichTextAttr& wxRichTextObject::GetAttributes ( )

Returns the object's attributes.

virtual wxRect wxRichTextObject::GetAvailableContentArea ( wxDC dc,
wxRichTextDrawingContext context,
const wxRect outerRect 
) const
virtual

Calculates the available content space in the given rectangle, given the margins, border and padding specified in the object's attributes.

virtual wxSize wxRichTextObject::GetBestSize ( ) const
virtual

Returns the best size, i.e. the ideal starting size for this object irrespective of available space.

For a short text string, it will be the size that exactly encloses the text. For a longer string, it might use the parent width for example.

virtual int wxRichTextObject::GetBottomMargin ( ) const
virtual

Returns the bottom margin of the object, in pixels.

static bool wxRichTextObject::GetBoxRects ( wxDC dc,
wxRichTextBuffer buffer,
const wxRichTextAttr attr,
wxRect marginRect,
wxRect borderRect,
wxRect contentRect,
wxRect paddingRect,
wxRect outlineRect 
)
static

Returns the various rectangles of the box model in pixels.

You can either specify contentRect (inner) or marginRect (outer), and the other must be the default rectangle (no width or height). Note that the outline doesn't affect the position of the rectangle, it's drawn in whatever space is available.

wxRichTextBuffer* wxRichTextObject::GetBuffer ( ) const

Returns the containing buffer.

virtual wxSize wxRichTextObject::GetCachedSize ( ) const
virtual

Gets the cached object size as calculated by Layout.

virtual wxRichTextParagraphLayoutBox* wxRichTextObject::GetContainer ( ) const
virtual

Returns the top-level container of this object.

May return itself if it's a container; use GetParentContainer to return a different container.

int wxRichTextObject::GetDescent ( ) const

Returns the stored descent value.

virtual int wxRichTextObject::GetFloatDirection ( ) const
virtual

Returns the floating direction.

virtual int wxRichTextObject::GetLeftMargin ( ) const
virtual

Returns the left margin of the object, in pixels.

virtual wxSize wxRichTextObject::GetMaxSize ( ) const
virtual

Gets the maximum object size as calculated by Layout.

This allows us to fit an object to its contents or allocate extra space if required.

virtual wxSize wxRichTextObject::GetMinSize ( ) const
virtual

Gets the minimum object size as calculated by Layout.

This allows us to constrain an object to its absolute minimum size if necessary.

wxString wxRichTextObject::GetName ( ) const

Returns the identifying name for this object from the properties, using the "name" key.

virtual wxTextAttrSize wxRichTextObject::GetNaturalSize ( ) const
virtual

Gets the 'natural' size for an object.

For an image, it would be the image size.

Reimplemented in wxRichTextImage.

const wxRichTextRange& wxRichTextObject::GetOwnRange ( ) const

Returns the object's own range (valid if top-level).

wxRichTextRange& wxRichTextObject::GetOwnRange ( )

Returns the object's own range (valid if top-level).

wxRichTextRange wxRichTextObject::GetOwnRangeIfTopLevel ( ) const

Returns the object's own range only if a top-level object.

virtual wxRichTextObject* wxRichTextObject::GetParent ( ) const
virtual

Returns a pointer to the parent object.

virtual wxRichTextParagraphLayoutBox* wxRichTextObject::GetParentContainer ( ) const
virtual

Returns the top-level container of this object.

Returns a different container than itself, unless there's no parent, in which case it will return NULL.

virtual wxPoint wxRichTextObject::GetPosition ( ) const
virtual

Returns the object position in pixels.

wxRichTextProperties& wxRichTextObject::GetProperties ( )

Returns the object's properties.

const wxRichTextProperties& wxRichTextObject::GetProperties ( ) const

Returns the object's properties.

virtual wxString wxRichTextObject::GetPropertiesMenuLabel ( ) const
virtual

Returns the label to be used for the properties context menu item.

Reimplemented in wxRichTextTable, wxRichTextCell, wxRichTextImage, wxRichTextField, and wxRichTextBox.

const wxRichTextRange& wxRichTextObject::GetRange ( ) const

Returns the object's range.

wxRichTextRange& wxRichTextObject::GetRange ( )

Returns the object's range.

virtual bool wxRichTextObject::GetRangeSize ( const wxRichTextRange range,
wxSize size,
int &  descent,
wxDC dc,
wxRichTextDrawingContext context,
int  flags,
const wxPoint position = wxPoint(0, 0),
const wxSize parentSize = wxDefaultSize,
wxArrayInt partialExtents = NULL 
) const
pure virtual

Returns the object size for the given range.

Returns false if the range is invalid for this object.

Implemented in wxRichTextTable, wxRichTextImage, wxRichTextPlainText, wxRichTextField, wxRichTextParagraphLayoutBox, and wxRichTextCompositeObject.

virtual wxRect wxRichTextObject::GetRect ( ) const
virtual

Returns the rectangle enclosing the object.

virtual int wxRichTextObject::GetRightMargin ( ) const
virtual

Returns the right margin of the object, in pixels.

virtual wxRichTextSelection wxRichTextObject::GetSelection ( long  start,
long  end 
) const
virtual

Returns a selection object specifying the selections between start and end character positions.

For example, a table would deduce what cells (of range length 1) are selected when dragging across the table.

Reimplemented in wxRichTextTable.

virtual wxString wxRichTextObject::GetTextForRange ( const wxRichTextRange range) const
virtual

Returns any text in this object for the given range.

Reimplemented in wxRichTextTable, wxRichTextPlainText, wxRichTextParagraphLayoutBox, and wxRichTextCompositeObject.

virtual int wxRichTextObject::GetTopMargin ( ) const
virtual

Returns the top margin of the object, in pixels.

static bool wxRichTextObject::GetTotalMargin ( wxDC dc,
wxRichTextBuffer buffer,
const wxRichTextAttr attr,
int &  leftMargin,
int &  rightMargin,
int &  topMargin,
int &  bottomMargin 
)
static

Returns the total margin for the object in pixels, taking into account margin, padding and border size.

virtual wxString wxRichTextObject::GetXMLNodeName ( ) const
virtual

Returns the XML node name of this object.

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

Reimplemented in wxRichTextTable, wxRichTextCell, wxRichTextImage, wxRichTextPlainText, wxRichTextParagraph, wxRichTextField, wxRichTextBox, and wxRichTextParagraphLayoutBox.

virtual bool wxRichTextObject::HandlesChildSelections ( ) const
virtual

Returns true if this object can handle the selections of its children, fOr example a table.

Required for composite selection handling to work.

Reimplemented in wxRichTextTable.

virtual int wxRichTextObject::HitTest ( wxDC dc,
wxRichTextDrawingContext context,
const wxPoint pt,
long &  textPosition,
wxRichTextObject **  obj,
wxRichTextObject **  contextObj,
int  flags = 0 
)
virtual

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).

Returns
One of the wxRichTextHitTestFlags values.

Reimplemented in wxRichTextTable, wxRichTextCell, wxRichTextBuffer, wxRichTextParagraph, wxRichTextParagraphLayoutBox, and wxRichTextCompositeObject.

virtual bool wxRichTextObject::ImportFromXML ( wxRichTextBuffer buffer,
wxXmlNode node,
wxRichTextXMLHandler handler,
bool *  recurse 
)
virtual

Imports this object from XML.

Reimplemented in wxRichTextTable, wxRichTextImage, wxRichTextPlainText, and wxRichTextParagraphLayoutBox.

virtual void wxRichTextObject::Invalidate ( const wxRichTextRange invalidRange = wxRICHTEXT_ALL)
virtual

Invalidates the object at the given range.

With no argument, invalidates the whole object.

Reimplemented in wxRichTextParagraphLayoutBox, and wxRichTextCompositeObject.

virtual bool wxRichTextObject::IsAtomic ( ) const
virtual

Returns true if no user editing can be done inside the object.

This returns true for simple objects, false for most composite objects, but true for fields, which if composite, should not be user-edited.

Reimplemented in wxRichTextField, and wxRichTextCompositeObject.

virtual bool wxRichTextObject::IsComposite ( ) const
virtual

Returns true if this object is composite.

Reimplemented in wxRichTextCompositeObject.

virtual bool wxRichTextObject::IsEmpty ( ) const
virtual

Returns true if the object is empty.

Reimplemented in wxRichTextImage, wxRichTextPlainText, wxRichTextField, and wxRichTextCompositeObject.

virtual bool wxRichTextObject::IsFloatable ( ) const
virtual

Returns true if this class of object is floatable.

Reimplemented in wxRichTextImage.

virtual bool wxRichTextObject::IsFloating ( ) const
virtual

Returns true if this object is currently floating.

bool wxRichTextObject::IsShown ( ) const

Returns true if the object will be shown, false otherwise.

virtual bool wxRichTextObject::IsTopLevel ( ) const
virtual

Returns true if this object is top-level, i.e. contains its own paragraphs, such as a text box.

Reimplemented in wxRichTextField, and wxRichTextParagraphLayoutBox.

virtual bool wxRichTextObject::Layout ( wxDC dc,
wxRichTextDrawingContext context,
const wxRect rect,
const wxRect parentRect,
int  style 
)
pure virtual

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).

Implemented in wxRichTextTable, wxRichTextImage, wxRichTextPlainText, wxRichTextParagraph, wxRichTextField, and wxRichTextParagraphLayoutBox.

virtual bool wxRichTextObject::LayoutToBestSize ( wxDC dc,
wxRichTextDrawingContext context,
wxRichTextBuffer buffer,
const wxRichTextAttr parentAttr,
const wxRichTextAttr attr,
const wxRect availableParentSpace,
const wxRect availableContainerSpace,
int  style 
)
virtual

Lays out the object first with a given amount of space, and then if no width was specified in attr, lays out the object again using the minimum size.

availableParentSpace is the maximum space for the object, whereas availableContainerSpace is the container with which relative positions and sizes should be computed. For example, a text box whose space has already been constrained in a previous layout pass to availableParentSpace, but should have a width of 50% of availableContainerSpace. (If these two rects were the same, a 2nd pass could see the object getting too small.)

virtual bool wxRichTextObject::Merge ( wxRichTextObject object,
wxRichTextDrawingContext context 
)
virtual

Returns true if this object merged itself with the given one.

The calling code will then delete the given object.

Reimplemented in wxRichTextPlainText.

virtual void wxRichTextObject::Move ( const wxPoint pt)
virtual

Moves the object recursively, by adding the offset from old to new.

Reimplemented in wxRichTextCompositeObject.

void wxRichTextObject::Reference ( )

Reference-counting allows us to use the same object in multiple lists (not yet used).

void wxRichTextObject::SetAttributes ( const wxRichTextAttr attr)

Sets the object's attributes.

virtual void wxRichTextObject::SetCachedSize ( const wxSize sz)
virtual

Sets the cached object size as calculated by Layout.

void wxRichTextObject::SetDescent ( int  descent)

Sets the stored descent value.

virtual void wxRichTextObject::SetMargins ( int  margin)
virtual

Set the margin around the object, in pixels.

virtual void wxRichTextObject::SetMargins ( int  leftMargin,
int  rightMargin,
int  topMargin,
int  bottomMargin 
)
virtual

Set the margin around the object, in pixels.

virtual void wxRichTextObject::SetMaxSize ( const wxSize sz)
virtual

Sets the maximum object size as calculated by Layout.

This allows us to fit an object to its contents or allocate extra space if required.

virtual void wxRichTextObject::SetMinSize ( const wxSize sz)
virtual

Sets the minimum object size as calculated by Layout.

This allows us to constrain an object to its absolute minimum size if necessary.

void wxRichTextObject::SetName ( const wxString name)

Sets the identifying name for this object as a property using the "name" key.

void wxRichTextObject::SetOwnRange ( const wxRichTextRange range)

Set the object's own range, for a top-level object with its own position space.

virtual void wxRichTextObject::SetParent ( wxRichTextObject parent)
virtual

Sets the pointer to the parent object.

virtual void wxRichTextObject::SetPosition ( const wxPoint pos)
virtual

Sets the object position in pixels.

void wxRichTextObject::SetProperties ( const wxRichTextProperties props)

Sets the object's properties.

void wxRichTextObject::SetRange ( const wxRichTextRange range)

Sets the object's range within its container.

virtual void wxRichTextObject::Show ( bool  show)
virtual

Call to show or hide this object.

This function does not cause the content to be laid out or redrawn.

virtual wxRichTextObject* wxRichTextObject::Split ( wxRichTextDrawingContext context)
virtual

Returns the final object in the split objects if this object was split due to differences between sub-object virtual attributes.

Returns itself if it was not split.

Reimplemented in wxRichTextPlainText.

virtual bool wxRichTextObject::UsesParagraphAttributes ( ) const
virtual

Returns true if this object takes note of paragraph attributes (text and image objects don't).

Reimplemented in wxRichTextImage, and wxRichTextPlainText.

Member Data Documentation

wxRichTextAttr wxRichTextObject::m_attributes
protected
int wxRichTextObject::m_descent
protected
wxSize wxRichTextObject::m_maxSize
protected
wxSize wxRichTextObject::m_minSize
protected
wxRichTextRange wxRichTextObject::m_ownRange
protected
wxRichTextObject* wxRichTextObject::m_parent
protected
wxPoint wxRichTextObject::m_pos
protected
wxRichTextProperties wxRichTextObject::m_properties
protected
wxRichTextRange wxRichTextObject::m_range
protected
int wxRichTextObject::m_refCount
protected
bool wxRichTextObject::m_show
protected
wxSize wxRichTextObject::m_size
protected