.. _StaticText: ================================================ StaticText ================================================ Description ----------- A text label that the user cannot change. Properties ^^^^^^^^^^ +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`active` readonly | Always false. This element cannot have input focus. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`alignment` readonly | The alignment style for this element. If defined, this value overrides the alignChildren setting for the parent container. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bounds` readonly | The boundaries of the element, in parent-relative coordinates. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`characters` readonly | A number of characters for which to reserve space when calculating the preferred size of the element. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`children` readonly | An array of child elements. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`enabled` readonly | True if this element is enabled. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`graphics` readonly | The graphics object that can be used to customize the element's appearance, in response to the?onDraw()?event. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`helpTip` readonly | The help text that is displayed when the mouse hovers over the element. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`indent` readonly | The number of pixels to indent the element during automatic layout. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`justify` readonly | The text justification style. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`location` readonly | The upper left corner of this element relative to its parent. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`maximumSize` readonly | The maximum height and width to which the element can be resized. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`minimumSize` readonly | The minimum height and width to which the element can be resized. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`parent` readonly | The parent element. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`preferredSize` readonly | The preferred size, used by layout managers to determine the best size for each element. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`properties` readonly | An object that contains one or more creation properties of the container (properties used only when the element is created). | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`shortcutKey` readonly | The key sequence that invokes the?onShortcutKey()?callback for this element (in Windows only). | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`size` readonly | The current dimensions of this element. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`text` readonly | The text to display, a localizable string. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`type` readonly | The element type, "statictext". | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`visible` readonly | True if this element is shown, false if it is hidden. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`window` readonly | The window that this element belongs to. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`windowBounds` readonly | The bounds of this element relative to the top-level parent window. | +---------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ Methods ^^^^^^^ +---------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`addEventListener` readonly | Registers an event handler for a particular type of event occuring in this element. | +---------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`dispatchEvent` readonly | Simulates the occurrence of an event in this target. | +---------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`hide` readonly | Hides this element. | +---------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`notify` readonly | Sends a notification message, simulating the specified user interaction event. | +---------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`removeEventListener` readonly | Unregisters an event handler for a particular type of event occuring in this element. | +---------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`show` readonly | Shows this element. | +---------------------------------------------------------------------+---------------------------------------------------------------------------------------+ Events ^^^^^^ +---------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ | :ref:`onDraw` readonly | An event-handler callback function, called when the window is about to be drawn. | +---------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ | :ref:`onShortcutKey` readonly | An event-handler callback function, called when the element's shortcutKey sequence is typed in the active window. | +---------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ .. container:: hide .. toctree:: :hidden: :maxdepth: 1 StaticText/characters.rst StaticText/justify.rst StaticText/text.rst StaticText/active.rst StaticText/shortcutKey.rst StaticText/graphics.rst StaticText/visible.rst StaticText/bounds.rst StaticText/location.rst StaticText/maximumSize.rst StaticText/minimumSize.rst StaticText/preferredSize.rst StaticText/size.rst StaticText/windowBounds.rst StaticText/alignment.rst StaticText/children.rst StaticText/properties.rst StaticText/enabled.rst StaticText/helpTip.rst StaticText/indent.rst StaticText/parent.rst StaticText/window.rst StaticText/type.rst StaticText/notify.rst StaticText/show.rst StaticText/hide.rst StaticText/addEventListener.rst StaticText/removeEventListener.rst StaticText/dispatchEvent.rst StaticText/onDraw.rst StaticText/onShortcutKey.rst