.. wxPython Phoenix documentation
This file was generated by Phoenix's sphinx generator and associated
tools, do not edit by hand.
Copyright: (c) 2011-2020 by Total Control Software
License: wxWindows License
.. include:: headings.inc
.. _wx.richtext.TextAttrDimension:
==========================================================================================================================================
|phoenix_title| **wx.richtext.TextAttrDimension**
==========================================================================================================================================
A class representing a rich text dimension, including units and position.
.. seealso:: :ref:`wx.richtext.RichTextAttr`, :ref:`wx.richtext.RichTextCtrl`, :ref:`wx.richtext.TextAttrDimensions`
|
|class_hierarchy| Class Hierarchy
=================================
.. raw:: html

Inheritance diagram for class
TextAttrDimension:
|
|method_summary| Methods Summary
================================
================================================================================ ================================================================================
:meth:`~wx.richtext.TextAttrDimension.__init__` Default constructor.
:meth:`~wx.richtext.TextAttrDimension.Apply` Apply the dimension, but not those identical to `compareWith` if present.
:meth:`~wx.richtext.TextAttrDimension.CollectCommonAttributes` Collects the attributes that are common to a range of content, building up a note of which attributes are absent in some objects and which clash in some objects.
:meth:`~wx.richtext.TextAttrDimension.EqPartial` Partial equality test.
:meth:`~wx.richtext.TextAttrDimension.GetFlags` Gets the dimension flags.
:meth:`~wx.richtext.TextAttrDimension.GetPosition` Gets the position flags.
:meth:`~wx.richtext.TextAttrDimension.GetUnits` Gets the units of the dimension.
:meth:`~wx.richtext.TextAttrDimension.GetValue` Returns the integer value of the dimension.
:meth:`~wx.richtext.TextAttrDimension.GetValueMM` Returns the floating-pointing value of the dimension in mm.
:meth:`~wx.richtext.TextAttrDimension.IsValid` Returns ``True`` if the dimension is valid.
:meth:`~wx.richtext.TextAttrDimension.Reset` Resets the dimension value and flags.
:meth:`~wx.richtext.TextAttrDimension.SetFlags` Sets the dimension flags.
:meth:`~wx.richtext.TextAttrDimension.SetPosition` Sets the position flags.
:meth:`~wx.richtext.TextAttrDimension.SetUnits` Sets the units of the dimension.
:meth:`~wx.richtext.TextAttrDimension.SetValid` Sets the valid flag.
:meth:`~wx.richtext.TextAttrDimension.SetValue` Sets the integer value of the dimension.
:meth:`~wx.richtext.TextAttrDimension.SetValueMM` Sets the value of the dimension in mm.
:meth:`~wx.richtext.TextAttrDimension.__bool__`
:meth:`~wx.richtext.TextAttrDimension.__nonzero__`
:meth:`~wx.richtext.TextAttrDimension.__eq__` Equality operator.
================================================================================ ================================================================================
|
|property_summary| Properties Summary
=====================================
================================================================================ ================================================================================
:attr:`~wx.richtext.TextAttrDimension.Flags` See :meth:`~wx.richtext.TextAttrDimension.GetFlags` and :meth:`~wx.richtext.TextAttrDimension.SetFlags`
:attr:`~wx.richtext.TextAttrDimension.Position` See :meth:`~wx.richtext.TextAttrDimension.GetPosition` and :meth:`~wx.richtext.TextAttrDimension.SetPosition`
:attr:`~wx.richtext.TextAttrDimension.Units` See :meth:`~wx.richtext.TextAttrDimension.GetUnits` and :meth:`~wx.richtext.TextAttrDimension.SetUnits`
:attr:`~wx.richtext.TextAttrDimension.Value` See :meth:`~wx.richtext.TextAttrDimension.GetValue` and :meth:`~wx.richtext.TextAttrDimension.SetValue`
:attr:`~wx.richtext.TextAttrDimension.ValueMM` See :meth:`~wx.richtext.TextAttrDimension.GetValueMM` and :meth:`~wx.richtext.TextAttrDimension.SetValueMM`
:attr:`~wx.richtext.TextAttrDimension.m_flags` A public C++ attribute of type `~wx.richtext.TextAttrDimensionFlags` .
:attr:`~wx.richtext.TextAttrDimension.m_value` A public C++ attribute of type ``int``.
================================================================================ ================================================================================
|
|api| Class API
===============
.. class:: wx.richtext.TextAttrDimension(object)
**Possible constructors**::
TextAttrDimension() -> None
TextAttrDimension(value : int, units:
TextAttrUnits=TEXT_ATTR_UNITS_TENTHS_MM) -> None
A class representing a rich text dimension, including units and
position.
.. method:: __init__(self, *args, **kw)
|overload| **Overloaded Implementations:**
:html:`
`
**__init__** `(self)`
Default constructor.
:rtype: `None`
:html:`
`
**__init__** `(self, value : int, units: TextAttrUnits=TEXT_ATTR_UNITS_TENTHS_MM)`
Constructor taking value and units flag.
:param `value`:
:type `value`: int
:param `units`:
:type `units`: wx.richtext.TextAttrUnits
:rtype: `None`
:html:`
`
.. method:: Apply(self, dim : TextAttrDimension, compareWith: Optional[TextAttrDimension]=None)
Apply the dimension, but not those identical to `compareWith` if present.
:param `dim`:
:type `dim`: wx.richtext.TextAttrDimension
:param `compareWith`:
:type `compareWith`: wx.richtext.TextAttrDimension
:rtype: `bool`
.. method:: CollectCommonAttributes(self, attr : TextAttrDimension, clashingAttr : TextAttrDimension, absentAttr : TextAttrDimension)
Collects the attributes that are common to a range of content, building up a note of which attributes are absent in some objects and which clash in some objects.
:param `attr`:
:type `attr`: wx.richtext.TextAttrDimension
:param `clashingAttr`:
:type `clashingAttr`: wx.richtext.TextAttrDimension
:param `absentAttr`:
:type `absentAttr`: wx.richtext.TextAttrDimension
:rtype: `None`
.. method:: EqPartial(self, dim : TextAttrDimension, weakTest: bool=True)
Partial equality test.
If `weakTest` is ``True``, attributes of this object do not have to be present if those attributes of `dim` are present. If `weakTest` is ``False``, the function will fail if an attribute is present in `dim` but not in this object.
:param `dim`:
:type `dim`: wx.richtext.TextAttrDimension
:param `weakTest`:
:type `weakTest`: bool
:rtype: `bool`
.. method:: GetFlags(self)
Gets the dimension flags.
:rtype: `wx.richtext.TextAttrDimensionFlags`
.. method:: GetPosition(self)
Gets the position flags.
:rtype: :ref:`wx.richtext.TextBoxAttrPosition`
.. method:: GetUnits(self)
Gets the units of the dimension.
:rtype: :ref:`wx.richtext.TextAttrUnits`
.. method:: GetValue(self)
Returns the integer value of the dimension.
:rtype: `int`
.. method:: GetValueMM(self)
Returns the floating-pointing value of the dimension in mm.
:rtype: `float`
.. method:: IsValid(self)
Returns ``True`` if the dimension is valid.
:rtype: `bool`
.. method:: Reset(self)
Resets the dimension value and flags.
:rtype: `None`
.. method:: SetFlags(self, flags : TextAttrDimensionFlags)
Sets the dimension flags.
:param `flags`:
:type `flags`: wx.richtext.TextAttrDimensionFlags
:rtype: `None`
.. method:: SetPosition(self, pos : TextBoxAttrPosition)
Sets the position flags.
:param `pos`:
:type `pos`: wx.richtext.TextBoxAttrPosition
:rtype: `None`
.. method:: SetUnits(self, units : TextAttrUnits)
Sets the units of the dimension.
:param `units`:
:type `units`: wx.richtext.TextAttrUnits
:rtype: `None`
.. method:: SetValid(self, b : bool)
Sets the valid flag.
:param `b`:
:type `b`: bool
:rtype: `None`
.. method:: SetValue(self, *args, **kw)
|overload| **Overloaded Implementations:**
:html:`
`
**SetValue** `(self, value : int)`
Sets the integer value of the dimension.
:param `value`:
:type `value`: int
:rtype: `None`
:html:`
`
**SetValue** `(self, value : int, flags : TextAttrDimensionFlags)`
Sets the integer value of the dimension, passing dimension flags.
:param `value`:
:type `value`: int
:param `flags`:
:type `flags`: wx.richtext.TextAttrDimensionFlags
:rtype: `None`
:html:`
`
**SetValue** `(self, dim : TextAttrDimension)`
Sets the dimension.
:param `dim`:
:type `dim`: wx.richtext.TextAttrDimension
:rtype: `None`
:html:`
`
.. method:: SetValueMM(self, value : float)
Sets the value of the dimension in mm.
:param `value`:
:type `value`: float
:rtype: `None`
.. method:: __bool__(self)
:rtype: `int`
.. method:: __nonzero__(self)
:rtype: `int`
.. method:: __eq__(self)
Equality operator.
:param `dim`:
:type `dim`: wx.richtext.TextAttrDimension
.. attribute:: Flags
See :meth:`~wx.richtext.TextAttrDimension.GetFlags` and :meth:`~wx.richtext.TextAttrDimension.SetFlags`
.. attribute:: Position
See :meth:`~wx.richtext.TextAttrDimension.GetPosition` and :meth:`~wx.richtext.TextAttrDimension.SetPosition`
.. attribute:: Units
See :meth:`~wx.richtext.TextAttrDimension.GetUnits` and :meth:`~wx.richtext.TextAttrDimension.SetUnits`
.. attribute:: Value
See :meth:`~wx.richtext.TextAttrDimension.GetValue` and :meth:`~wx.richtext.TextAttrDimension.SetValue`
.. attribute:: ValueMM
See :meth:`~wx.richtext.TextAttrDimension.GetValueMM` and :meth:`~wx.richtext.TextAttrDimension.SetValueMM`
.. attribute:: m_flags
A public C++ attribute of type `~wx.richtext.TextAttrDimensionFlags` .
.. attribute:: m_value
A public C++ attribute of type ``int``.