View Class Referenceabstract

#include <Pt/Forms/View.h>

A widget that connects controls to a paint surface. More...

Inherits Widget.

Inherited by Control, and Form.

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.
 
Screenscreen ()
 Returns the connected screen.
 
const Screenscreen () const
 Returns the connected screen.
 
Widgetparent ()
 Returns the parent.
 
const Widgetparent () 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.
 
WidgethitTest (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::PointFposition () const
 Returns the current position.
 
virtual void move (const Gfx::PointF &pos)
 Moves the widget to a position.
 
const Gfx::SizeFsize () const
 Returns the current size.
 
const Gfx::RectFbounds () 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

A View owns the boundary between a control hierarchy and the PaintSurface on which it is displayed. It establishes the surface and coordinate mapping for attached controls, then forwards their repaint, layout, visibility, geometry, and activation requests. Form and Control provide the usual view implementations; derive a view when a custom content host needs different forwarding or coordinate behavior.