|
The Power in your Hands |
Widget Class Referenceabstract
#include <Pt/Forms/Widget.h>
Common base for objects that participate in the Forms runtime. More...
Inherits Responder, and Connectable.
Inherited by Screen, View, WindowFrame, and WindowManager.
Public Member Functions | |
| Pt::uint64_t | id () const |
| Returns the ID. | |
| const std::string & | name () const |
| Returns the name. | |
| void | setName (const std::string &n) |
| Sets the name. | |
| void | setNextResponder (Responder *r) |
| Sets the next responder. | |
| bool | isConnected () const |
| Returns true if connected to a screen. | |
| Screen * | screen () |
| Returns the connected screen. | |
| const Screen * | screen () const |
| Returns the connected screen. | |
| Widget * | parent () |
| Returns the parent. | |
| const Widget * | parent () const |
| Returns the parent. | |
| bool | isDescendantOf (const Widget &top) const |
| Returns true if an descendant of @top. | |
| bool | isAncestorOf (const Widget &child) const |
| Returns true if an ancestor of @child. | |
| Widget * | hitTest (const Gfx::PointF &pos) |
| Returns the descendant hit at a position. | |
| Gfx::PointF | toParent (const Gfx::PointF &pos) const |
| Converts to parent coordinate. | |
| Gfx::PointF | fromParent (const Gfx::PointF &pos) const |
| Converts from parent coordinate. | |
| Gfx::PointF | toGlobal (const Gfx::PointF &pos) const |
| Converts to global coordinate. | |
| Gfx::PointF | fromGlobal (const Gfx::PointF &pos) const |
| Converts to local coordinate. | |
| void | addPeer (Widget &peer) |
| Adds a peer. | |
| void | removePeer (Widget &peer) |
| Removes a peer. | |
| void | invalidate () |
| Invalidates the state. | |
| virtual void | repaint (const Gfx::RectF &rect) |
| Initiates a repaint cycle. | |
| virtual void | repaint () |
| Initiates a repaint cycle. | |
| double | scaleFactor () const |
| Returns the current scale factor. | |
| bool | isVisible () const |
| Indicates whether the widget is visible. | |
| virtual void | show (bool b=true) |
| Shows the widget. | |
| bool | isEnabled () const |
| Indicates whether the widget is enabled. | |
| virtual void | enable (bool isEnable=true) |
| Enables the widget. | |
| const Gfx::PointF & | position () const |
| Returns the current position. | |
| virtual void | move (const Gfx::PointF &pos) |
| Moves the widget to a position. | |
| const Gfx::SizeF & | size () const |
| Returns the current size. | |
| const Gfx::RectF & | bounds () const |
| Returns the current inner bounds. | |
| virtual void | resize (const Gfx::SizeF &s) |
| Resizes the widget to a new size. | |
| void | setCapture (bool capture) |
| Pointer input capture. | |
| void | processEvent (const Pt::Event &ev) |
| Process event. | |
| Pt::Signal< const Pt::Event & > & | eventReceived () |
| Signals that an event needs to be processed. | |
Detailed Description
Widget supplies identity, screen connection, geometry, visibility, enabled state, coordinate conversion, repaint requests, event dispatch, and pointer capture. The Forms runtime calls its protected hooks as state and events move through the hierarchy. Custom widget bases implement the coordinate conversions and override only the hooks for behavior they own.