Views
Gadgets Package API Reference Guide
Product Documentation:
Views Documentation Home
List of all members | Public Member Functions
IlvScrolledView Class Reference

View container class. More...

#include <ilviews/gadgets/scview.h>

Inheritance diagram for IlvScrolledView:
IlvGadgetContainer IlvContainer IlvStylist IlvDrawingView IlvView IlvAbstractView IlvSystemPort IlvStylable IlvPort IlvValueInterface

Public Member Functions

 IlvScrolledView (IlvAbstractView *parent, const IlvRect &rect, IlBoolean visible=IlTrue)
 Constructor. More...
 
 IlvScrolledView (IlvDisplay *display, const char *name, const char *title, const IlvRect &rect, IlBoolean visible=IlTrue)
 Constructor. More...
 
 IlvScrolledView (IlvDisplay *display, const char *name, const char *title, const IlvRect &rect, IlUInt properties, IlBoolean visible=IlTrue, IlvSystemView transientFor=0)
 Constructor. More...
 
 IlvScrolledView (IlvDisplay *display, IlvSystemView parent, const IlvRect &rect, IlBoolean visible=IlTrue)
 Constructor. More...
 
 IlvScrolledView (IlvDisplay *display, IlvSystemView window)
 Constructor. More...
 
IlvViewgetClipView () const
 Returns the clipping view. More...
 
IlvScrollBargetHorizontalScrollBar () const
 Returns the horizontal scroll bar. More...
 
IlvAbstractViewgetScrolledView () const
 Returns the view that is being scrolled. More...
 
IlvScrollBargetVerticalScrollBar () const
 Returns the vertical scroll bar. More...
 
void hideScrollBar (IlvOrientation direction)
 Hides the specified scroll bar. More...
 
void moveScrollBar (IlvOrientation direction, IlvPosition where)
 Moves the specified scroll bar to a new position. More...
 
void showScrollBar (IlvOrientation direction)
 Shows the specified scroll bar. More...
 
IlvPosition whereIsScrollBar (IlvOrientation direction) const
 Indicates the position of the specified scroll bar. More...
 
- Public Member Functions inherited from IlvGadgetContainer
 IlvGadgetContainer (IlvAbstractView *parent, const IlvRect &rect, IlBoolean useacc=IlFalse, IlBoolean visible=IlTrue)
 Initializes a new instance of the IlvGadgetContainer class as a child view of another view. More...
 
 IlvGadgetContainer (IlvDisplay *display, const char *name, const char *title, const IlvRect &rect, IlBoolean useacc=IlFalse, IlBoolean visible=IlTrue)
 Initializes a new instance of the IlvGadgetContainer class as a top view. More...
 
 IlvGadgetContainer (IlvDisplay *display, const char *name, const char *title, const IlvRect &rect, IlUInt properties, IlBoolean useacc=IlFalse, IlBoolean visible=IlTrue, IlvSystemView transientFor=0)
 Initializes a new instance of the IlvGadgetContainer class as a top view. More...
 
 IlvGadgetContainer (IlvDisplay *display, IlvSystemView parent, const IlvRect &rect, IlBoolean useacc=IlFalse, IlBoolean visible=IlTrue)
 Initializes a new instance of the IlvGadgetContainer class as a child view of a system view. More...
 
 IlvGadgetContainer (IlvDisplay *display, IlvSystemView window, IlBoolean useacc=IlFalse)
 Initializes a new instance of the IlvGadgetContainer class using an existing system view. More...
 
virtual IlBoolean allowFocus (IlBoolean value)
 Specifies whether the container manages the focus. More...
 
virtual void applyResize (IlFloat sx, IlFloat sy, IlBoolean redraw=IlTrue)
 Is called to carry out the resize events applying to the gadget container. More...
 
IlBoolean autoResize (IlBoolean a)
 Sets the auto resize mode of the gadget container. More...
 
IlvButtongetDefaultButton () const
 Returns the default button of the gadget container. More...
 
virtual IlvGraphicgetFirstFocusGraphic () const
 Returns the first object that receives the focus in this container. More...
 
virtual IlvGraphicgetFocus () const
 Returns the object that has the keyboard focus in the gadget container. More...
 
virtual IlvGraphicgetGrab () const
 Returns the object that is currently grabbing events in the container. More...
 
virtual IlvGraphicgetLastFocusGraphic () const
 Returns the last object that receives the focus in this container. More...
 
IlvLookFeelHandlergetLookFeelHandler () const
 Returns the look and feel handler associated with this container. More...
 
virtual IlvGraphicgetNextFocusGraphic (IlvGraphic *object) const
 Returns the next object that will receive the focus after the specified object. More...
 
IlvGraphicgetOverriddenFocus () const
 Returns the object that will receive the focus after calling setFocus(). More...
 
virtual IlvGraphicgetPreviousFocusGraphic (IlvGraphic *object) const
 Returns the previous object that received the focus before the specified object. More...
 
IlBoolean isAutoResizing () const
 Indicates whether the gadget container gets resized when loading a file. More...
 
virtual IlBoolean isFocusAllowed () const
 Indicates whether the focus is allowed in the container. More...
 
virtual void moveFocusAfter (IlBoolean redraw=IlTrue)
 Is called to find the next focusable object. More...
 
virtual void moveFocusBefore (IlBoolean redraw=IlTrue)
 Is called to find the previous focusable object. More...
 
void overrideFocus (IlvGraphic *obj)
 Sets the object that will receive the focus after calling setFocus(). More...
 
virtual void removeGrab ()
 Cancels the grabbing settings defined with setGrab(). More...
 
void setDefaultButton (IlvButton *button, IlBoolean redraw=IlTrue)
 Sets the default button of the gadget container. More...
 
virtual void setFocus (IlvGraphic *graphic=0, IlBoolean redraw=IlTrue)
 Sets the focus to the specified object of the gadget container. More...
 
virtual void setGrab (IlvGraphic *object)
 Sets the specified object as the grabbing object. More...
 
void setLookFeelHandler (IlvLookFeelHandler *lfh)
 Sets the look and feel handler of this container. More...
 

Detailed Description

View container class.

Library: ilvadvgdt

The IlvScrolledView class is a predefined gadget container class that lets you create scrolled views. This class builds the necessary view hierarchy to create a window with scroll bars. Once you have created an IlvScrolledView, you add the scrollable view as a subview of the clipping view of this object. The logical representation of the hierarchy looks like this:

Layout Of A Scrolled View

See also
IlvScrollView, IlvSCGadgetContainerRectangle

Constructor & Destructor Documentation

◆ IlvScrolledView() [1/5]

IlvScrolledView::IlvScrolledView ( IlvAbstractView parent,
const IlvRect rect,
IlBoolean  visible = IlTrue 
)

Constructor.

Initializes a new instance of the IlvScrolledView class as a child view of parent.

Parameters
parentThe parent view of the scrolled view.
rectThe size and position of the scrolled view.
visibleA Boolean value specifying whether the view should be visible.

◆ IlvScrolledView() [2/5]

IlvScrolledView::IlvScrolledView ( IlvDisplay display,
IlvSystemView  parent,
const IlvRect rect,
IlBoolean  visible = IlTrue 
)

Constructor.

Initializes a new instance of the IlvScrolledView class as a child view of the system view specified by parent.

Parameters
displayThe connection to the display.
parentThe parent view of the scrolled view.
rectThe size and position of the scrolled view.
visibleA Boolean value specifying whether the view should be visible.

◆ IlvScrolledView() [3/5]

IlvScrolledView::IlvScrolledView ( IlvDisplay display,
IlvSystemView  window 
)

Constructor.

Initializes a new instance of the IlvScrolledView class mapped to the existing system view specified by window.

Parameters
displayThe connection to the display.
windowThe system view to which the scrolled view is mapped.

◆ IlvScrolledView() [4/5]

IlvScrolledView::IlvScrolledView ( IlvDisplay display,
const char *  name,
const char *  title,
const IlvRect rect,
IlBoolean  visible = IlTrue 
)

Constructor.

Initializes a new instance of the IlvScrolledView class as a top view.

Parameters
displayThe connection to the display.
nameThe name of the scrolled view.
titleThe title of the scrolled view.
rectThe size and position of the scrolled view.
visibleA Boolean value specifying whether the view should be visible.

◆ IlvScrolledView() [5/5]

IlvScrolledView::IlvScrolledView ( IlvDisplay display,
const char *  name,
const char *  title,
const IlvRect rect,
IlUInt  properties,
IlBoolean  visible = IlTrue,
IlvSystemView  transientFor = 0 
)

Constructor.

Initializes a new instance of the IlvScrolledView class as a top view.

Parameters
displayThe connection to the display.
nameThe name of the scrolled view.
titleThe title of the scrolled view.
rectThe size and position of the scrolled view.
propertiesThe properties of the scrolled view. For details, see the IlvView constructors.
visibleA Boolean value specifying whether the view should be visible.
transientForThe system view for which the scrolled view is transient. For details, see the IlvView constructors.

Member Function Documentation

◆ getClipView()

IlvView* IlvScrolledView::getClipView ( ) const

Returns the clipping view.

This view must be the parent of the view to be scrolled.

Returns
The clipping view.
See also
getScrolledView

◆ getHorizontalScrollBar()

IlvScrollBar* IlvScrolledView::getHorizontalScrollBar ( ) const

Returns the horizontal scroll bar.

Returns
The horizontal scroll bar.
See also
getVerticalScrollBar

◆ getScrolledView()

IlvAbstractView* IlvScrolledView::getScrolledView ( ) const

Returns the view that is being scrolled.

Returns
The view that is being scrolled.
See also
getClipView

◆ getVerticalScrollBar()

IlvScrollBar* IlvScrolledView::getVerticalScrollBar ( ) const

Returns the vertical scroll bar.

Returns
The vertical scroll bar.
See also
getHorizontalScrollBar

◆ hideScrollBar()

void IlvScrolledView::hideScrollBar ( IlvOrientation  direction)

Hides the specified scroll bar.

Hides the scroll bar that has the specified direction and deactivates it.

Parameters
directionThe scroll bar direction. Valid values are: IlvHorizontal and IlvVertical.
See also
showScrollBar, getHorizontalScrollBar, getVerticalScrollBar

◆ moveScrollBar()

void IlvScrolledView::moveScrollBar ( IlvOrientation  direction,
IlvPosition  where 
)

Moves the specified scroll bar to a new position.

Parameters
directionThe direction of the scroll bar to be moved to a new position. Valid values are: IlvHorizontal and IlvVertical.
whereThe new position of the scroll bar. Valid values are: IlvLeft and IlvRight for horizontal scroll bars, and IlvTop and IlvBottom for vertical scroll bars.
See also
showScrollBar, hideScrollBar, whereIsScrollBar

◆ showScrollBar()

void IlvScrolledView::showScrollBar ( IlvOrientation  direction)

Shows the specified scroll bar.

Displays the scroll bar that has the specified direction and activates it.

Parameters
directionThe scroll bar direction. Valid values are: IlvHorizontal and IlvVertical.
See also
hideScrollBar, getHorizontalScrollBar, getVerticalScrollBar

◆ whereIsScrollBar()

IlvPosition IlvScrolledView::whereIsScrollBar ( IlvOrientation  direction) const

Indicates the position of the specified scroll bar.

Parameters
directionThe direction of the scroll bar to be located. Valid values are: IlvHorizontal and IlvVertical.
Returns
The position of the scroll bar indicated by direction.
See also
moveScrollBar