diff options
| author | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2011-11-08 12:31:36 -0600 |
|---|---|---|
| committer | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2011-11-08 12:31:36 -0600 |
| commit | d796c9dd933ab96ec83b9a634feedd5d32e1ba3f (patch) | |
| tree | 6e3dcca4f77e20ec8966c666aac7c35bd4704053 /doc/html/qscrollview.html | |
| download | tqt3-d796c9dd933ab96ec83b9a634feedd5d32e1ba3f.tar.gz tqt3-d796c9dd933ab96ec83b9a634feedd5d32e1ba3f.zip | |
Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731
Diffstat (limited to 'doc/html/qscrollview.html')
| -rw-r--r-- | doc/html/qscrollview.html | 930 |
1 files changed, 930 insertions, 0 deletions
diff --git a/doc/html/qscrollview.html b/doc/html/qscrollview.html new file mode 100644 index 000000000..887e83777 --- /dev/null +++ b/doc/html/qscrollview.html @@ -0,0 +1,930 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/widgets/qscrollview.cpp:347 --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>TQScrollView Class</title> +<style type="text/css"><!-- +fn { margin-left: 1cm; text-indent: -1cm; } +a:link { color: #004faf; text-decoration: none } +a:visited { color: #672967; text-decoration: none } +body { background: #ffffff; color: black; } +--></style> +</head> +<body> + +<table border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr bgcolor="#E5E5E5"> +<td valign=center> + <a href="index.html"> +<font color="#004faf">Home</font></a> + | <a href="classes.html"> +<font color="#004faf">All Classes</font></a> + | <a href="mainclasses.html"> +<font color="#004faf">Main Classes</font></a> + | <a href="annotated.html"> +<font color="#004faf">Annotated</font></a> + | <a href="groups.html"> +<font color="#004faf">Grouped Classes</font></a> + | <a href="functions.html"> +<font color="#004faf">Functions</font></a> +</td> +<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQScrollView Class Reference</h1> + +<p>The TQScrollView widget provides a scrolling area with on-demand scroll bars. +<a href="#details">More...</a> +<p><tt>#include <<a href="qscrollview-h.html">qscrollview.h</a>></tt> +<p>Inherits <a href="qframe.html">TQFrame</a>. +<p>Inherited by <a href="qcanvasview.html">TQCanvasView</a>, <a href="qtable.html">TQTable</a>, <a href="qgridview.html">TQGridView</a>, <a href="qiconview.html">TQIconView</a>, <a href="qlistbox.html">TQListBox</a>, <a href="qlistview.html">TQListView</a>, and <a href="qtextedit.html">TQTextEdit</a>. +<p><a href="qscrollview-members.html">List of all member functions.</a> +<h2>Public Members</h2> +<ul> +<li class=fn><a href="#TQScrollView"><b>TQScrollView</b></a> ( TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )</li> +<li class=fn><a href="#~TQScrollView"><b>~TQScrollView</b></a> ()</li> +<li class=fn>enum <a href="#ResizePolicy-enum"><b>ResizePolicy</b></a> { Default, Manual, AutoOne, AutoOneFit }</li> +<li class=fn>virtual void <a href="#setResizePolicy"><b>setResizePolicy</b></a> ( ResizePolicy )</li> +<li class=fn>ResizePolicy <a href="#resizePolicy"><b>resizePolicy</b></a> () const</li> +<li class=fn>void <a href="#removeChild"><b>removeChild</b></a> ( TQWidget * child )</li> +<li class=fn>virtual void <a href="#addChild"><b>addChild</b></a> ( TQWidget * child, int x = 0, int y = 0 )</li> +<li class=fn>virtual void <a href="#moveChild"><b>moveChild</b></a> ( TQWidget * child, int x, int y )</li> +<li class=fn>int <a href="#childX"><b>childX</b></a> ( TQWidget * child )</li> +<li class=fn>int <a href="#childY"><b>childY</b></a> ( TQWidget * child )</li> +<li class=fn>bool childIsVisible ( TQWidget * child ) <em>(obsolete)</em></li> +<li class=fn>void showChild ( TQWidget * child, bool y = TRUE ) <em>(obsolete)</em></li> +<li class=fn>enum <a href="#ScrollBarMode-enum"><b>ScrollBarMode</b></a> { Auto, AlwaysOff, AlwaysOn }</li> +<li class=fn>ScrollBarMode <a href="#vScrollBarMode"><b>vScrollBarMode</b></a> () const</li> +<li class=fn>virtual void <a href="#setVScrollBarMode"><b>setVScrollBarMode</b></a> ( ScrollBarMode )</li> +<li class=fn>ScrollBarMode <a href="#hScrollBarMode"><b>hScrollBarMode</b></a> () const</li> +<li class=fn>virtual void <a href="#setHScrollBarMode"><b>setHScrollBarMode</b></a> ( ScrollBarMode )</li> +<li class=fn>TQWidget * <a href="#cornerWidget"><b>cornerWidget</b></a> () const</li> +<li class=fn>virtual void <a href="#setCornerWidget"><b>setCornerWidget</b></a> ( TQWidget * corner )</li> +<li class=fn>TQScrollBar * <a href="#horizontalScrollBar"><b>horizontalScrollBar</b></a> () const</li> +<li class=fn>TQScrollBar * <a href="#verticalScrollBar"><b>verticalScrollBar</b></a> () const</li> +<li class=fn>TQWidget * <a href="#viewport"><b>viewport</b></a> () const</li> +<li class=fn>TQWidget * <a href="#clipper"><b>clipper</b></a> () const</li> +<li class=fn>int <a href="#visibleWidth"><b>visibleWidth</b></a> () const</li> +<li class=fn>int <a href="#visibleHeight"><b>visibleHeight</b></a> () const</li> +<li class=fn>int <a href="#contentsWidth"><b>contentsWidth</b></a> () const</li> +<li class=fn>int <a href="#contentsHeight"><b>contentsHeight</b></a> () const</li> +<li class=fn>int <a href="#contentsX"><b>contentsX</b></a> () const</li> +<li class=fn>int <a href="#contentsY"><b>contentsY</b></a> () const</li> +<li class=fn>void <a href="#updateContents"><b>updateContents</b></a> ( int x, int y, int w, int h )</li> +<li class=fn>void <a href="#updateContents-2"><b>updateContents</b></a> ( const TQRect & r )</li> +<li class=fn>void <a href="#updateContents-3"><b>updateContents</b></a> ()</li> +<li class=fn>void <a href="#repaintContents"><b>repaintContents</b></a> ( int x, int y, int w, int h, bool erase = TRUE )</li> +<li class=fn>void <a href="#repaintContents-2"><b>repaintContents</b></a> ( const TQRect & r, bool erase = TRUE )</li> +<li class=fn>void <a href="#repaintContents-3"><b>repaintContents</b></a> ( bool erase = TRUE )</li> +<li class=fn>void <a href="#contentsToViewport"><b>contentsToViewport</b></a> ( int x, int y, int & vx, int & vy ) const</li> +<li class=fn>void <a href="#viewportToContents"><b>viewportToContents</b></a> ( int vx, int vy, int & x, int & y ) const</li> +<li class=fn>TQPoint <a href="#contentsToViewport-2"><b>contentsToViewport</b></a> ( const TQPoint & p ) const</li> +<li class=fn>TQPoint <a href="#viewportToContents-2"><b>viewportToContents</b></a> ( const TQPoint & vp ) const</li> +<li class=fn>void <a href="#enableClipper"><b>enableClipper</b></a> ( bool y )</li> +<li class=fn>void <a href="#setStaticBackground"><b>setStaticBackground</b></a> ( bool y )</li> +<li class=fn>bool <a href="#hasStaticBackground"><b>hasStaticBackground</b></a> () const</li> +<li class=fn>TQSize <a href="#viewportSize"><b>viewportSize</b></a> ( int x, int y ) const</li> +<li class=fn>bool <a href="#isHorizontalSliderPressed"><b>isHorizontalSliderPressed</b></a> ()</li> +<li class=fn>bool <a href="#isVerticalSliderPressed"><b>isVerticalSliderPressed</b></a> ()</li> +<li class=fn>virtual void <a href="#setDragAutoScroll"><b>setDragAutoScroll</b></a> ( bool b )</li> +<li class=fn>bool <a href="#dragAutoScroll"><b>dragAutoScroll</b></a> () const</li> +</ul> +<h2>Public Slots</h2> +<ul> +<li class=fn>virtual void <a href="#resizeContents"><b>resizeContents</b></a> ( int w, int h )</li> +<li class=fn>void <a href="#scrollBy"><b>scrollBy</b></a> ( int dx, int dy )</li> +<li class=fn>virtual void <a href="#setContentsPos"><b>setContentsPos</b></a> ( int x, int y )</li> +<li class=fn>void <a href="#ensureVisible"><b>ensureVisible</b></a> ( int x, int y )</li> +<li class=fn>void <a href="#ensureVisible-2"><b>ensureVisible</b></a> ( int x, int y, int xmargin, int ymargin )</li> +<li class=fn>void <a href="#center"><b>center</b></a> ( int x, int y )</li> +<li class=fn>void <a href="#center-2"><b>center</b></a> ( int x, int y, float xmargin, float ymargin )</li> +<li class=fn>void <a href="#updateScrollBars"><b>updateScrollBars</b></a> ()</li> +</ul> +<h2>Signals</h2> +<ul> +<li class=fn>void <a href="#contentsMoving"><b>contentsMoving</b></a> ( int x, int y )</li> +<li class=fn>void <a href="#horizontalSliderPressed"><b>horizontalSliderPressed</b></a> ()</li> +<li class=fn>void <a href="#horizontalSliderReleased"><b>horizontalSliderReleased</b></a> ()</li> +<li class=fn>void <a href="#verticalSliderPressed"><b>verticalSliderPressed</b></a> ()</li> +<li class=fn>void <a href="#verticalSliderReleased"><b>verticalSliderReleased</b></a> ()</li> +</ul> +<h2>Properties</h2> +<ul> +<li class=fn>int <a href="#contentsHeight-prop"><b>contentsHeight</b></a> - the height of the contents area <em>(read only)</em></li> +<li class=fn>int <a href="#contentsWidth-prop"><b>contentsWidth</b></a> - the width of the contents area <em>(read only)</em></li> +<li class=fn>int <a href="#contentsX-prop"><b>contentsX</b></a> - the X coordinate of the contents that are at the left edge of the viewport <em>(read only)</em></li> +<li class=fn>int <a href="#contentsY-prop"><b>contentsY</b></a> - the Y coordinate of the contents that are at the top edge of the viewport <em>(read only)</em></li> +<li class=fn>bool <a href="#dragAutoScroll-prop"><b>dragAutoScroll</b></a> - whether autoscrolling in drag move events is enabled</li> +<li class=fn>ScrollBarMode <a href="#hScrollBarMode-prop"><b>hScrollBarMode</b></a> - the mode for the horizontal scroll bar</li> +<li class=fn>ResizePolicy <a href="#resizePolicy-prop"><b>resizePolicy</b></a> - the resize policy</li> +<li class=fn>ScrollBarMode <a href="#vScrollBarMode-prop"><b>vScrollBarMode</b></a> - the mode for the vertical scroll bar</li> +<li class=fn>int <a href="#visibleHeight-prop"><b>visibleHeight</b></a> - the vertical amount of the content that is visible <em>(read only)</em></li> +<li class=fn>int <a href="#visibleWidth-prop"><b>visibleWidth</b></a> - the horizontal amount of the content that is visible <em>(read only)</em></li> +</ul> +<h2>Protected Members</h2> +<ul> +<li class=fn>virtual void <a href="#drawContents"><b>drawContents</b></a> ( TQPainter * p, int clipx, int clipy, int clipw, int cliph )</li> +<li class=fn>virtual void <a href="#drawContentsOffset"><b>drawContentsOffset</b></a> ( TQPainter * p, int offsetx, int offsety, int clipx, int clipy, int clipw, int cliph )</li> +<li class=fn>virtual void <a href="#contentsMousePressEvent"><b>contentsMousePressEvent</b></a> ( TQMouseEvent * e )</li> +<li class=fn>virtual void <a href="#contentsMouseReleaseEvent"><b>contentsMouseReleaseEvent</b></a> ( TQMouseEvent * e )</li> +<li class=fn>virtual void <a href="#contentsMouseDoubleClickEvent"><b>contentsMouseDoubleClickEvent</b></a> ( TQMouseEvent * e )</li> +<li class=fn>virtual void <a href="#contentsMouseMoveEvent"><b>contentsMouseMoveEvent</b></a> ( TQMouseEvent * e )</li> +<li class=fn>virtual void <a href="#contentsDragEnterEvent"><b>contentsDragEnterEvent</b></a> ( TQDragEnterEvent * )</li> +<li class=fn>virtual void <a href="#contentsDragMoveEvent"><b>contentsDragMoveEvent</b></a> ( TQDragMoveEvent * )</li> +<li class=fn>virtual void <a href="#contentsDragLeaveEvent"><b>contentsDragLeaveEvent</b></a> ( TQDragLeaveEvent * )</li> +<li class=fn>virtual void <a href="#contentsDropEvent"><b>contentsDropEvent</b></a> ( TQDropEvent * )</li> +<li class=fn>virtual void <a href="#contentsWheelEvent"><b>contentsWheelEvent</b></a> ( TQWheelEvent * e )</li> +<li class=fn>virtual void <a href="#contentsContextMenuEvent"><b>contentsContextMenuEvent</b></a> ( TQContextMenuEvent * e )</li> +<li class=fn>virtual void <a href="#viewportPaintEvent"><b>viewportPaintEvent</b></a> ( TQPaintEvent * pe )</li> +<li class=fn>virtual void <a href="#viewportResizeEvent"><b>viewportResizeEvent</b></a> ( TQResizeEvent * )</li> +<li class=fn>virtual void <a href="#setMargins"><b>setMargins</b></a> ( int left, int top, int right, int bottom )</li> +<li class=fn>int <a href="#leftMargin"><b>leftMargin</b></a> () const</li> +<li class=fn>int <a href="#topMargin"><b>topMargin</b></a> () const</li> +<li class=fn>int <a href="#rightMargin"><b>rightMargin</b></a> () const</li> +<li class=fn>int <a href="#bottomMargin"><b>bottomMargin</b></a> () const</li> +<li class=fn>virtual void <a href="#setHBarGeometry"><b>setHBarGeometry</b></a> ( TQScrollBar & hbar, int x, int y, int w, int h )</li> +<li class=fn>virtual void <a href="#setVBarGeometry"><b>setVBarGeometry</b></a> ( TQScrollBar & vbar, int x, int y, int w, int h )</li> +<li class=fn>virtual bool <a href="#eventFilter"><b>eventFilter</b></a> ( TQObject * obj, TQEvent * e )</li> +</ul> +<hr><a name="details"></a><h2>Detailed Description</h2> + + +The TQScrollView widget provides a scrolling area with on-demand scroll bars. +<p> + +<p> The TQScrollView is a large canvas - potentially larger than the +coordinate system normally supported by the underlying window +system. This is important because it is tquite easy to go beyond +these limitations (e.g. many web pages are more than 32000 pixels +high). Additionally, the TQScrollView can have TQWidgets positioned +on it that scroll around with the drawn content. These sub-widgets +can also have positions outside the normal coordinate range (but +they are still limited in size). +<p> To provide content for the widget, inherit from TQScrollView, +reimplement <a href="#drawContents">drawContents</a>() and use <a href="#resizeContents">resizeContents</a>() to set the +size of the viewed area. Use <a href="#addChild">addChild</a>() and <a href="#moveChild">moveChild</a>() to +position widgets on the view. +<p> To use TQScrollView effectively it is important to understand its +widget structure in the three styles of use: a single large child +widget, a large panning area with some widgets and a large panning +area with many widgets. +<p> <h3> Using One Big Widget +</h3> +<a name="1"></a><p> <center><img src="qscrollview-vp2.png"></center> +<p> The first, simplest usage of TQScrollView (depicted above), is +appropriate for scrolling areas that are never more than about +4000 pixels in either dimension (this is about the maximum +reliable size on X11 servers). In this usage, you just make one +large child in the TQScrollView. The child should be a child of the +<a href="#viewport">viewport</a>() of the scrollview and be added with addChild(): +<pre> + TQScrollView* sv = new TQScrollView(...); + <a href="qvbox.html">TQVBox</a>* big_box = new <a href="qvbox.html">TQVBox</a>(sv-><a href="#viewport">viewport</a>()); + sv-><a href="#addChild">addChild</a>(big_box); + </pre> + +You can go on to add arbitrary child widgets to the single child +in the scrollview as you would with any widget: +<pre> + <a href="qlabel.html">TQLabel</a>* child1 = new <a href="qlabel.html">TQLabel</a>("CHILD", big_box); + <a href="qlabel.html">TQLabel</a>* child2 = new <a href="qlabel.html">TQLabel</a>("CHILD", big_box); + <a href="qlabel.html">TQLabel</a>* child3 = new <a href="qlabel.html">TQLabel</a>("CHILD", big_box); + ... + </pre> + +<p> Here the TQScrollView has four children: the viewport(), the +<a href="#verticalScrollBar">verticalScrollBar</a>(), the <a href="#horizontalScrollBar">horizontalScrollBar</a>() and a small +<a href="#cornerWidget">cornerWidget</a>(). The <a href="#viewport">viewport</a>() has one child: the big <a href="qvbox.html">TQVBox</a>. The +TQVBox has the three <a href="qlabel.html">TQLabel</a> objects as child widgets. When the view +is scrolled, the TQVBox is moved; its children move with it as +child widgets normally do. +<p> <h3> Using a Very Big View with Some Widgets +</h3> +<a name="1-1"></a><p> <center><img src="qscrollview-vp.png"></center> +<p> The second usage of TQScrollView (depicted above) is appropriate +when few, if any, widgets are on a very large scrolling area that +is potentially larger than 4000 pixels in either dimension. In +this usage you call <a href="#resizeContents">resizeContents</a>() to set the size of the area +and reimplement <a href="#drawContents">drawContents</a>() to paint the contents. You may also +add some widgets by making them children of the viewport() and +adding them with <a href="#addChild">addChild</a>() (this is the same as the process for +the single large widget in the previous example): +<pre> + TQScrollView* sv = new TQScrollView(...); + <a href="qlabel.html">TQLabel</a>* child1 = new <a href="qlabel.html">TQLabel</a>("CHILD", sv-><a href="#viewport">viewport</a>()); + sv-><a href="#addChild">addChild</a>(child1); + <a href="qlabel.html">TQLabel</a>* child2 = new <a href="qlabel.html">TQLabel</a>("CHILD", sv-><a href="#viewport">viewport</a>()); + sv-><a href="#addChild">addChild</a>(child2); + <a href="qlabel.html">TQLabel</a>* child3 = new <a href="qlabel.html">TQLabel</a>("CHILD", sv-><a href="#viewport">viewport</a>()); + sv-><a href="#addChild">addChild</a>(child3); + </pre> + +Here, the TQScrollView has the same four children: the <a href="#viewport">viewport</a>(), +the <a href="#verticalScrollBar">verticalScrollBar</a>(), the <a href="#horizontalScrollBar">horizontalScrollBar</a>() and a small +<a href="#cornerWidget">cornerWidget</a>(). The viewport() has the three <a href="qlabel.html">TQLabel</a> objects as +child widgets. When the view is scrolled, the scrollview moves the +child widgets individually. +<p> <h3> Using a Very Big View with Many Widgets +</h3> +<a name="1-2"></a><p> <a name="enableclipper"></a> +<center><img src="qscrollview-cl.png"></center> +<p> The final usage of TQScrollView (depicted above) is appropriate +when many widgets are on a very large scrolling area that is +potentially larger than 4000 pixels in either dimension. In this +usage you call <a href="#resizeContents">resizeContents</a>() to set the size of the area and +reimplement <a href="#drawContents">drawContents</a>() to paint the contents. You then call +<a href="#enableClipper">enableClipper</a>(TRUE) and add widgets, again by making them children +of the <a href="#viewport">viewport</a>(), and adding them with <a href="#addChild">addChild</a>(): +<pre> + TQScrollView* sv = new TQScrollView(...); + sv-><a href="#enableClipper">enableClipper</a>(TRUE); + <a href="qlabel.html">TQLabel</a>* child1 = new <a href="qlabel.html">TQLabel</a>("CHILD", sv-><a href="#viewport">viewport</a>()); + sv-><a href="#addChild">addChild</a>(child1); + <a href="qlabel.html">TQLabel</a>* child2 = new <a href="qlabel.html">TQLabel</a>("CHILD", sv-><a href="#viewport">viewport</a>()); + sv-><a href="#addChild">addChild</a>(child2); + <a href="qlabel.html">TQLabel</a>* child3 = new <a href="qlabel.html">TQLabel</a>("CHILD", sv-><a href="#viewport">viewport</a>()); + sv-><a href="#addChild">addChild</a>(child3); + </pre> + +<p> Here, the TQScrollView has four children: the <a href="#clipper">clipper</a>() (not the +viewport() this time), the <a href="#verticalScrollBar">verticalScrollBar</a>(), the +<a href="#horizontalScrollBar">horizontalScrollBar</a>() and a small <a href="#cornerWidget">cornerWidget</a>(). The clipper() +has one child: the <a href="#viewport">viewport</a>(). The viewport() has the same three +labels as child widgets. When the view is scrolled the viewport() +is moved; its children move with it as child widgets normally do. +<p> <a name="allviews"></a> +<h3> Details Relevant for All Views +</h3> +<a name="1-3"></a><p> Normally you will use the first or third method if you want any +child widgets in the view. +<p> Note that the widget you see in the scrolled area is the +viewport() widget, not the TQScrollView itself. So to turn mouse +tracking on, for example, use viewport()->setMouseTracking(TRUE). +<p> To enable drag-and-drop, you would <a href="qwidget.html#setAcceptDrops">setAcceptDrops</a>(TRUE) on the +TQScrollView (because drag-and-drop events propagate to the +parent). But to work out the logical position in the view, you +would need to map the drop co-ordinate from being relative to the +TQScrollView to being relative to the contents; use the function +<a href="#viewportToContents">viewportToContents</a>() for this. +<p> To handle mouse events on the scrolling area, subclass scrollview +as you would subclass other widgets, but rather than +reimplementing <a href="qwidget.html#mousePressEvent">mousePressEvent</a>(), reimplement +<a href="#contentsMousePressEvent">contentsMousePressEvent</a>() instead. The contents specific event +handlers provide translated events in the coordinate system of the +scrollview. If you reimplement mousePressEvent(), you'll get +called only when part of the TQScrollView is clicked: and the only +such part is the "corner" (if you don't set a <a href="#cornerWidget">cornerWidget</a>()) and +the frame; everything else is covered up by the viewport, clipper +or scroll bars. +<p> When you construct a TQScrollView, some of the widget flags apply +to the <a href="#viewport">viewport</a>() instead of being sent to the <a href="qwidget.html">TQWidget</a> constructor +for the TQScrollView. This applies to <a href="qt.html#WidgetFlags-enum">WNoAutoErase</a>, <a href="qt.html#WidgetFlags-enum">WStaticContents</a>, and <a href="qt.html#WidgetFlags-enum">WPaintClever</a>. See <a href="qt.html#WidgetFlags-enum">TQt::WidgetFlags</a> for +documentation about these flags. Here are some examples: +<p> <ul> +<p> <li> An image-manipulation widget would use <tt>WNoAutoErase|WStaticContents</tt> because the widget draws all pixels +itself, and when its size increases, it only needs a paint event +for the new part because the old part remains unchanged. +<p> <li> A scrolling game widget in which the background scrolls as the +characters move might use <a href="qt.html#WidgetFlags-enum">WNoAutoErase</a> (in addition to <a href="qt.html#WidgetFlags-enum">WStaticContents</a>) so that the window system background does not +flash in and out during scrolling. +<p> <li> A word processing widget might use <a href="qt.html#WidgetFlags-enum">WNoAutoErase</a> and repaint +itself line by line to get a less-flickery resizing. If the widget +is in a mode in which no text justification can take place, it +might use <a href="qt.html#WidgetFlags-enum">WStaticContents</a> too, so that it would only get a +repaint for the newly visible parts. +<p> </ul> +<p> Child widgets may be moved using <a href="#addChild">addChild</a>() or <a href="#moveChild">moveChild</a>(). Use +<a href="#childX">childX</a>() and <a href="#childY">childY</a>() to get the position of a child widget. +<p> A widget may be placed in the corner between the vertical and +horizontal scrollbars with <a href="#setCornerWidget">setCornerWidget</a>(). You can get access +to the scrollbars using <a href="#horizontalScrollBar">horizontalScrollBar</a>() and +<a href="#verticalScrollBar">verticalScrollBar</a>(), and to the viewport with <a href="#viewport">viewport</a>(). The +scroll view can be scrolled using <a href="#scrollBy">scrollBy</a>(), <a href="#ensureVisible">ensureVisible</a>(), +<a href="#setContentsPos">setContentsPos</a>() or <a href="#center">center</a>(). +<p> The visible area is given by <a href="#visibleWidth">visibleWidth</a>() and <a href="#visibleHeight">visibleHeight</a>(), +and the contents area by <a href="#contentsWidth">contentsWidth</a>() and <a href="#contentsHeight">contentsHeight</a>(). The +contents may be repainted using one of the <a href="#repaintContents">repaintContents</a>() or +<a href="#updateContents">updateContents</a>() functions. +<p> Coordinate conversion is provided by <a href="#contentsToViewport">contentsToViewport</a>() and +<a href="#viewportToContents">viewportToContents</a>(). +<p> The <a href="#contentsMoving">contentsMoving</a>() signal is emitted just before the contents +are moved to a new position. +<p> <b>Warning:</b> TQScrollView currently does not erase the background when +resized, i.e. you must always clear the background manually in +scrollview subclasses. This will change in a future version of TQt +and we recommend specifying the WNoAutoErase flag explicitly. +<p> <img src=qscrollview-m.png> <img src=qscrollview-w.png> +<p>See also <a href="abstractwidgets.html">Abstract Widget Classes</a>. + +<hr><h2>Member Type Documentation</h2> +<h3 class=fn><a name="ResizePolicy-enum"></a>TQScrollView::ResizePolicy</h3> + +<p> This enum type is used to control a TQScrollView's reaction to +resize events. +<ul> +<li><tt>TQScrollView::Default</tt> - the TQScrollView selects one of the other settings +automatically when it has to. In this version of TQt, TQScrollView +changes to <a href="#ResizePolicy-enum">Manual</a> if you resize the contents with +<a href="#resizeContents">resizeContents</a>() and to <a href="#ResizePolicy-enum">AutoOne</a> if a child is added. +<li><tt>TQScrollView::Manual</tt> - the contents stays the size set by resizeContents(). +<li><tt>TQScrollView::AutoOne</tt> - if there is only one child widget the contents stays +the size of that widget. Otherwise the behavior is undefined. +<li><tt>TQScrollView::AutoOneFit</tt> - if there is only one child widget the contents stays +the size of that widget's <a href="qwidget.html#sizeHint">sizeHint</a>(). If the scrollview is resized +larger than the child's sizeHint(), the child will be resized to +fit. If there is more than one child, the behavior is undefined. +</ul><p> +<h3 class=fn><a name="ScrollBarMode-enum"></a>TQScrollView::ScrollBarMode</h3> + +<p> This enum type describes the various modes of TQScrollView's scroll +bars. +<ul> +<li><tt>TQScrollView::Auto</tt> - TQScrollView shows a scroll bar when the content is +too large to fit and not otherwise. This is the default. +<li><tt>TQScrollView::AlwaysOff</tt> - TQScrollView never shows a scroll bar. +<li><tt>TQScrollView::AlwaysOn</tt> - TQScrollView always shows a scroll bar. +</ul><p> (The modes for the horizontal and vertical scroll bars are +independent.) + +<hr><h2>Member Function Documentation</h2> +<h3 class=fn><a name="TQScrollView"></a>TQScrollView::TQScrollView ( <a href="qwidget.html">TQWidget</a> * parent = 0, const char * name = 0, WFlags f = 0 ) +</h3> +Constructs a TQScrollView called <em>name</em> with parent <em>parent</em> and +widget flags <em>f</em>. +<p> The widget flags <a href="qt.html#WidgetFlags-enum">WStaticContents</a>, <a href="qt.html#WidgetFlags-enum">WNoAutoErase</a> and <a href="qt.html#WidgetFlags-enum">WPaintClever</a> are propagated to the <a href="#viewport">viewport</a>() widget. The other +widget flags are propagated to the parent constructor as usual. + +<h3 class=fn><a name="~TQScrollView"></a>TQScrollView::~TQScrollView () +</h3> +Destroys the TQScrollView. Any children added with <a href="#addChild">addChild</a>() will +be deleted. + +<h3 class=fn>void <a name="addChild"></a>TQScrollView::addChild ( <a href="qwidget.html">TQWidget</a> * child, int x = 0, int y = 0 )<tt> [virtual]</tt> +</h3> +Inserts the widget, <em>child</em>, into the scrolled area positioned at +(<em>x</em>, <em>y</em>). The position defaults to (0, 0). If the child is +already in the view, it is just moved. +<p> You may want to call <a href="#enableClipper">enableClipper</a>(TRUE) if you add a large number +of widgets. + +<p>Example: <a href="scrollview-example.html#x645">scrollview/scrollview.cpp</a>. +<h3 class=fn>int <a name="bottomMargin"></a>TQScrollView::bottomMargin () const<tt> [protected]</tt> +</h3> +Returns the bottom margin. +<p> <p>See also <a href="#setMargins">setMargins</a>(). + +<h3 class=fn>void <a name="center"></a>TQScrollView::center ( int x, int y )<tt> [slot]</tt> +</h3> +Scrolls the content so that the point <em>(x, y)</em> is in the center +of visible area. + +<p>Example: <a href="scrollview-example.html#x646">scrollview/scrollview.cpp</a>. +<h3 class=fn>void <a name="center-2"></a>TQScrollView::center ( int x, int y, float xmargin, float ymargin )<tt> [slot]</tt> +</h3> +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +<p> Scrolls the content so that the point <em>(x, y)</em> is visible with +the <em>xmargin</em> and <em>ymargin</em> margins (as fractions of visible +the area). +<p> For example: +<ul> +<li> Margin 0.0 allows (x, y) to be on the edge of the visible area. +<li> Margin 0.5 ensures that (x, y) is in middle 50% of the visible area. +<li> Margin 1.0 ensures that (x, y) is in the center of the the visible area. +</ul> + +<h3 class=fn>bool <a name="childIsVisible"></a>TQScrollView::childIsVisible ( <a href="qwidget.html">TQWidget</a> * child ) +</h3> +<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> Returns TRUE if <em>child</em> is visible. This is equivalent +to child->isVisible(). + +<h3 class=fn>int <a name="childX"></a>TQScrollView::childX ( <a href="qwidget.html">TQWidget</a> * child ) +</h3> +Returns the X position of the given <em>child</em> widget. Use this +rather than <a href="qwidget.html#x">TQWidget::x</a>() for widgets added to the view. +<p> This function returns 0 if <em>child</em> has not been added to the view. + +<h3 class=fn>int <a name="childY"></a>TQScrollView::childY ( <a href="qwidget.html">TQWidget</a> * child ) +</h3> +Returns the Y position of the given <em>child</em> widget. Use this +rather than <a href="qwidget.html#y">TQWidget::y</a>() for widgets added to the view. +<p> This function returns 0 if <em>child</em> has not been added to the view. + +<h3 class=fn><a href="qwidget.html">TQWidget</a> * <a name="clipper"></a>TQScrollView::clipper () const +</h3> +Returns the clipper widget. Contents in the scrollview are +ultimately clipped to be inside the clipper widget. +<p> You should not need to use this function. +<p> <p>See also <a href="#visibleWidth-prop">visibleWidth</a> and <a href="#visibleHeight-prop">visibleHeight</a>. + +<h3 class=fn>void <a name="contentsContextMenuEvent"></a>TQScrollView::contentsContextMenuEvent ( <a href="qcontextmenuevent.html">TQContextMenuEvent</a> * e )<tt> [virtual protected]</tt> +</h3> +This event handler is called whenever the TQScrollView receives a +<a href="qwidget.html#contextMenuEvent">contextMenuEvent</a>() in <em>e</em>: the mouse position is translated to +be a point on the contents. + +<p>Example: <a href="tutorial2-06.html#x2584">chart/canvasview.cpp</a>. +<h3 class=fn>void <a name="contentsDragEnterEvent"></a>TQScrollView::contentsDragEnterEvent ( <a href="qdragenterevent.html">TQDragEnterEvent</a> * )<tt> [virtual protected]</tt> +</h3> +This event handler is called whenever the TQScrollView receives a +<a href="qwidget.html#dragEnterEvent">dragEnterEvent</a>(): the drag position is translated to be a point +on the contents. + +<p>Reimplemented in <a href="qtable.html#contentsDragEnterEvent">TQTable</a>. +<h3 class=fn>void <a name="contentsDragLeaveEvent"></a>TQScrollView::contentsDragLeaveEvent ( <a href="qdragleaveevent.html">TQDragLeaveEvent</a> * )<tt> [virtual protected]</tt> +</h3> +This event handler is called whenever the TQScrollView receives a +<a href="qwidget.html#dragLeaveEvent">dragLeaveEvent</a>(): the drag position is translated to be a point +on the contents. + +<p>Reimplemented in <a href="qtable.html#contentsDragLeaveEvent">TQTable</a>. +<h3 class=fn>void <a name="contentsDragMoveEvent"></a>TQScrollView::contentsDragMoveEvent ( <a href="qdragmoveevent.html">TQDragMoveEvent</a> * )<tt> [virtual protected]</tt> +</h3> +This event handler is called whenever the TQScrollView receives a +<a href="qwidget.html#dragMoveEvent">dragMoveEvent</a>(): the drag position is translated to be a point on +the contents. + +<p>Reimplemented in <a href="qtable.html#contentsDragMoveEvent">TQTable</a>. +<h3 class=fn>void <a name="contentsDropEvent"></a>TQScrollView::contentsDropEvent ( <a href="qdropevent.html">TQDropEvent</a> * )<tt> [virtual protected]</tt> +</h3> +This event handler is called whenever the TQScrollView receives a +<a href="qwidget.html#dropEvent">dropEvent</a>(): the drop position is translated to be a point on the +contents. + +<p>Reimplemented in <a href="qtable.html#contentsDropEvent">TQTable</a>. +<h3 class=fn>int <a name="contentsHeight"></a>TQScrollView::contentsHeight () const +</h3><p>Returns the height of the contents area. +See the <a href="qscrollview.html#contentsHeight-prop">"contentsHeight"</a> property for details. +<h3 class=fn>void <a name="contentsMouseDoubleClickEvent"></a>TQScrollView::contentsMouseDoubleClickEvent ( <a href="qmouseevent.html">TQMouseEvent</a> * e )<tt> [virtual protected]</tt> +</h3> +This event handler is called whenever the TQScrollView receives a +<a href="qwidget.html#mouseDoubleClickEvent">mouseDoubleClickEvent</a>(): the click position in <em>e</em> is translated to be a +point on the contents. +<p> The default implementation generates a normal mouse press event. + +<p>Reimplemented in <a href="qlistview.html#contentsMouseDoubleClickEvent">TQListView</a>. +<h3 class=fn>void <a name="contentsMouseMoveEvent"></a>TQScrollView::contentsMouseMoveEvent ( <a href="qmouseevent.html">TQMouseEvent</a> * e )<tt> [virtual protected]</tt> +</h3> +This event handler is called whenever the TQScrollView receives a +<a href="qwidget.html#mouseMoveEvent">mouseMoveEvent</a>(): the mouse position in <em>e</em> is translated to be a point +on the contents. + +<p>Examples: <a href="canvas-example.html#x2950">canvas/canvas.cpp</a> and <a href="tutorial2-06.html#x2585">chart/canvasview.cpp</a>. +<p>Reimplemented in <a href="qlistview.html#contentsMouseMoveEvent">TQListView</a>. +<h3 class=fn>void <a name="contentsMousePressEvent"></a>TQScrollView::contentsMousePressEvent ( <a href="qmouseevent.html">TQMouseEvent</a> * e )<tt> [virtual protected]</tt> +</h3> +This event handler is called whenever the TQScrollView receives a +<a href="qwidget.html#mousePressEvent">mousePressEvent</a>(): the press position in <em>e</em> is translated to be a point +on the contents. + +<p>Examples: <a href="canvas-example.html#x2951">canvas/canvas.cpp</a> and <a href="tutorial2-06.html#x2586">chart/canvasview.cpp</a>. +<p>Reimplemented in <a href="qlistview.html#contentsMousePressEvent">TQListView</a>. +<h3 class=fn>void <a name="contentsMouseReleaseEvent"></a>TQScrollView::contentsMouseReleaseEvent ( <a href="qmouseevent.html">TQMouseEvent</a> * e )<tt> [virtual protected]</tt> +</h3> +This event handler is called whenever the TQScrollView receives a +<a href="qwidget.html#mouseReleaseEvent">mouseReleaseEvent</a>(): the release position in <em>e</em> is translated to be a +point on the contents. + +<p>Reimplemented in <a href="qlistview.html#contentsMouseReleaseEvent">TQListView</a>. +<h3 class=fn>void <a name="contentsMoving"></a>TQScrollView::contentsMoving ( int x, int y )<tt> [signal]</tt> +</h3> + +<p> This signal is emitted just before the contents are moved to +position <em>(x, y)</em>. +<p> <p>See also <a href="#contentsX-prop">contentsX</a> and <a href="#contentsY-prop">contentsY</a>. + +<h3 class=fn>void <a name="contentsToViewport"></a>TQScrollView::contentsToViewport ( int x, int y, int & vx, int & vy ) const +</h3> +Translates a point (<em>x</em>, <em>y</em>) in the contents to a point (<em>vx</em>, +<em>vy</em>) on the <a href="#viewport">viewport</a>() widget. + +<h3 class=fn><a href="qpoint.html">TQPoint</a> <a name="contentsToViewport-2"></a>TQScrollView::contentsToViewport ( const <a href="qpoint.html">TQPoint</a> & p ) const +</h3> +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +<p> Returns the point <em>p</em> translated to a point on the <a href="#viewport">viewport</a>() +widget. + +<h3 class=fn>void <a name="contentsWheelEvent"></a>TQScrollView::contentsWheelEvent ( <a href="qwheelevent.html">TQWheelEvent</a> * e )<tt> [virtual protected]</tt> +</h3> +This event handler is called whenever the TQScrollView receives a +<a href="qwidget.html#wheelEvent">wheelEvent</a>() in <em>e</em>: the mouse position is translated to be a +point on the contents. + +<h3 class=fn>int <a name="contentsWidth"></a>TQScrollView::contentsWidth () const +</h3><p>Returns the width of the contents area. +See the <a href="qscrollview.html#contentsWidth-prop">"contentsWidth"</a> property for details. +<h3 class=fn>int <a name="contentsX"></a>TQScrollView::contentsX () const +</h3><p>Returns the X coordinate of the contents that are at the left edge of the viewport. +See the <a href="qscrollview.html#contentsX-prop">"contentsX"</a> property for details. +<h3 class=fn>int <a name="contentsY"></a>TQScrollView::contentsY () const +</h3><p>Returns the Y coordinate of the contents that are at the top edge of the viewport. +See the <a href="qscrollview.html#contentsY-prop">"contentsY"</a> property for details. +<h3 class=fn><a href="qwidget.html">TQWidget</a> * <a name="cornerWidget"></a>TQScrollView::cornerWidget () const +</h3> +Returns the widget in the corner between the two scroll bars. +<p> By default, no corner widget is present. + +<p>Example: <a href="scrollview-example.html#x647">scrollview/scrollview.cpp</a>. +<h3 class=fn>bool <a name="dragAutoScroll"></a>TQScrollView::dragAutoScroll () const +</h3><p>Returns TRUE if autoscrolling in drag move events is enabled; otherwise returns FALSE. +See the <a href="qscrollview.html#dragAutoScroll-prop">"dragAutoScroll"</a> property for details. +<h3 class=fn>void <a name="drawContents"></a>TQScrollView::drawContents ( <a href="qpainter.html">TQPainter</a> * p, int clipx, int clipy, int clipw, int cliph )<tt> [virtual protected]</tt> +</h3> + +<p> Reimplement this function if you are viewing a drawing area rather +than a widget. +<p> The function should draw the rectangle (<em>clipx</em>, <em>clipy</em>, <em>clipw</em>, <em>cliph</em>) of the contents using painter <em>p</em>. The clip +rectangle is in the scrollview's coordinates. +<p> For example: +<pre> + { + // Fill a 40000 by 50000 rectangle at (100000,150000) + + // Calculate the coordinates... + int x1 = 100000, y1 = 150000; + int x2 = x1+40000-1, y2 = y1+50000-1; + + // Clip the coordinates so X/Windows will not have problems... + if (x1 < clipx) x1=clipx; + if (y1 < clipy) y1=clipy; + if (x2 > clipx+clipw-1) x2=clipx+clipw-1; + if (y2 > clipy+cliph-1) y2=clipy+cliph-1; + + // Paint using the small coordinates... + if ( x2 >= x1 && y2 >= y1 ) + p->fillRect(x1, y1, x2-x1+1, y2-y1+1, red); + } + </pre> + +<p> The clip rectangle and translation of the painter <em>p</em> is already +set appropriately. + +<p>Example: <a href="qdir-example.html#x1837">qdir/qdir.cpp</a>. +<p>Reimplemented in <a href="qcanvasview.html#drawContents">TQCanvasView</a> and <a href="qtable.html#drawContents">TQTable</a>. +<h3 class=fn>void <a name="drawContentsOffset"></a>TQScrollView::drawContentsOffset ( <a href="qpainter.html">TQPainter</a> * p, int offsetx, int offsety, int clipx, int clipy, int clipw, int cliph )<tt> [virtual protected]</tt> +</h3> +For backward-compatibility only. It is easier to use +<a href="#drawContents">drawContents</a>(<a href="qpainter.html">TQPainter</a>*,int,int,int,int). +<p> The default implementation translates the painter appropriately +and calls drawContents(TQPainter*,int,int,int,int). See +drawContents() for an explanation of the parameters <em>p</em>, <em>offsetx</em>, <em>offsety</em>, <em>clipx</em>, <em>clipy</em>, <em>clipw</em> and <em>cliph</em>. + +<p>Reimplemented in <a href="qlistview.html#drawContentsOffset">TQListView</a>. +<h3 class=fn>void <a name="enableClipper"></a>TQScrollView::enableClipper ( bool y ) +</h3> +When a large numbers of child widgets are in a scrollview, +especially if they are close together, the scrolling performance +can suffer greatly. If <em>y</em> is TRUE the scrollview will use an +extra widget to group child widgets. +<p> Note that you may only call <a href="#enableClipper">enableClipper</a>() prior to adding +widgets. +<p> For a full discussion, see this class's <a href="#enableclipper">detailed description</a>. + +<p>Example: <a href="scrollview-example.html#x648">scrollview/scrollview.cpp</a>. +<h3 class=fn>void <a name="ensureVisible"></a>TQScrollView::ensureVisible ( int x, int y )<tt> [slot]</tt> +</h3> +Scrolls the content so that the point <em>(x, y)</em> is visible with at +least 50-pixel margins (if possible, otherwise centered). + +<h3 class=fn>void <a name="ensureVisible-2"></a>TQScrollView::ensureVisible ( int x, int y, int xmargin, int ymargin )<tt> [slot]</tt> +</h3> +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +<p> Scrolls the content so that the point <em>(x, y)</em> is visible with at +least the <em>xmargin</em> and <em>ymargin</em> margins (if possible, +otherwise centered). + +<h3 class=fn>bool <a name="eventFilter"></a>TQScrollView::eventFilter ( <a href="qobject.html">TQObject</a> * obj, <a href="qevent.html">TQEvent</a> * e )<tt> [virtual protected]</tt> +</h3> +This event filter ensures the scroll bars are updated when a +single contents widget is resized, shown, hidden or destroyed; it +passes mouse events to the TQScrollView. The event is in <em>e</em> and +the object is in <em>obj</em>. + +<p>Reimplemented from <a href="qobject.html#eventFilter">TQObject</a>. +<p>Reimplemented in <a href="qlistview.html#eventFilter">TQListView</a>. +<h3 class=fn><a href="qscrollview.html#ScrollBarMode-enum">ScrollBarMode</a> <a name="hScrollBarMode"></a>TQScrollView::hScrollBarMode () const +</h3><p>Returns the mode for the horizontal scroll bar. +See the <a href="qscrollview.html#hScrollBarMode-prop">"hScrollBarMode"</a> property for details. +<h3 class=fn>bool <a name="hasStaticBackground"></a>TQScrollView::hasStaticBackground () const +</h3> +Returns TRUE if TQScrollView uses a static background; otherwise +returns FALSE. +<p> <p>See also <a href="#setStaticBackground">setStaticBackground</a>(). + +<h3 class=fn><a href="qscrollbar.html">TQScrollBar</a> * <a name="horizontalScrollBar"></a>TQScrollView::horizontalScrollBar () const +</h3> +Returns the component horizontal scroll bar. It is made available +to allow accelerators, autoscrolling, etc. +<p> It should not be used for other purposes. +<p> This function never returns 0. + +<h3 class=fn>void <a name="horizontalSliderPressed"></a>TQScrollView::horizontalSliderPressed ()<tt> [signal]</tt> +</h3> + +<p> This signal is emitted whenever the user presses the horizontal slider. + +<h3 class=fn>void <a name="horizontalSliderReleased"></a>TQScrollView::horizontalSliderReleased ()<tt> [signal]</tt> +</h3> + +<p> This signal is emitted whenever the user releases the horizontal slider. + +<h3 class=fn>bool <a name="isHorizontalSliderPressed"></a>TQScrollView::isHorizontalSliderPressed () +</h3> +Returns TRUE if horizontal slider is pressed by user; otherwise returns FALSE. + +<h3 class=fn>bool <a name="isVerticalSliderPressed"></a>TQScrollView::isVerticalSliderPressed () +</h3> +Returns TRUE if vertical slider is pressed by user; otherwise returns FALSE. + +<h3 class=fn>int <a name="leftMargin"></a>TQScrollView::leftMargin () const<tt> [protected]</tt> +</h3> +Returns the left margin. +<p> <p>See also <a href="#setMargins">setMargins</a>(). + +<h3 class=fn>void <a name="moveChild"></a>TQScrollView::moveChild ( <a href="qwidget.html">TQWidget</a> * child, int x, int y )<tt> [virtual]</tt> +</h3> +Repositions the <em>child</em> widget to (<em>x</em>, <em>y</em>). This function is +the same as <a href="#addChild">addChild</a>(). + +<h3 class=fn>void <a name="removeChild"></a>TQScrollView::removeChild ( <a href="qwidget.html">TQWidget</a> * child ) +</h3> +Removes the <em>child</em> widget from the scrolled area. Note that this +happens automatically if the <em>child</em> is deleted. + +<h3 class=fn>void <a name="repaintContents"></a>TQScrollView::repaintContents ( int x, int y, int w, int h, bool erase = TRUE ) +</h3> +Calls <a href="qwidget.html#repaint">repaint</a>() on a rectangle defined by <em>x</em>, <em>y</em>, <em>w</em>, <em>h</em>, +translated appropriately. If the rectangle is not visible, nothing +is repainted. If <em>erase</em> is TRUE the background is cleared using +the background color. +<p> <p>See also <a href="#updateContents">updateContents</a>(). + +<h3 class=fn>void <a name="repaintContents-2"></a>TQScrollView::repaintContents ( const <a href="qrect.html">TQRect</a> & r, bool erase = TRUE ) +</h3> +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +<p> Repaints the contents of rectangle <em>r</em>. If <em>erase</em> is TRUE the +background is cleared using the background color. + +<h3 class=fn>void <a name="repaintContents-3"></a>TQScrollView::repaintContents ( bool erase = TRUE ) +</h3> +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +<p> Repaints the contents. If <em>erase</em> is TRUE the background is +cleared using the background color. + +<h3 class=fn>void <a name="resizeContents"></a>TQScrollView::resizeContents ( int w, int h )<tt> [virtual slot]</tt> +</h3> +Sets the size of the contents area to <em>w</em> pixels wide and <em>h</em> +pixels high and updates the viewport accordingly. + +<h3 class=fn><a href="qscrollview.html#ResizePolicy-enum">ResizePolicy</a> <a name="resizePolicy"></a>TQScrollView::resizePolicy () const +</h3><p>Returns the resize policy. +See the <a href="qscrollview.html#resizePolicy-prop">"resizePolicy"</a> property for details. +<h3 class=fn>int <a name="rightMargin"></a>TQScrollView::rightMargin () const<tt> [protected]</tt> +</h3> +Returns the right margin. +<p> <p>See also <a href="#setMargins">setMargins</a>(). + +<h3 class=fn>void <a name="scrollBy"></a>TQScrollView::scrollBy ( int dx, int dy )<tt> [slot]</tt> +</h3> +Scrolls the content by <em>dx</em> to the left and <em>dy</em> upwards. + +<h3 class=fn>void <a name="setContentsPos"></a>TQScrollView::setContentsPos ( int x, int y )<tt> [virtual slot]</tt> +</h3> +Scrolls the content so that the point <em>(x, y)</em> is in the top-left +corner. + +<p>Example: <a href="process-example.html#x102">process/process.cpp</a>. +<h3 class=fn>void <a name="setCornerWidget"></a>TQScrollView::setCornerWidget ( <a href="qwidget.html">TQWidget</a> * corner )<tt> [virtual]</tt> +</h3> +Sets the widget in the <em>corner</em> between the two scroll bars. +<p> You will probably also want to set at least one of the scroll bar +modes to <a href="#ScrollBarMode-enum">AlwaysOn</a>. +<p> Passing 0 shows no widget in the corner. +<p> Any previous <em>corner</em> widget is hidden. +<p> You may call <a href="#setCornerWidget">setCornerWidget</a>() with the same widget at different +times. +<p> All widgets set here will be deleted by the TQScrollView when it is +destroyed unless you separately reparent the widget after setting +some other corner widget (or 0). +<p> Any <em>newly</em> set widget should have no current parent. +<p> By default, no corner widget is present. +<p> <p>See also <a href="#vScrollBarMode-prop">vScrollBarMode</a> and <a href="#hScrollBarMode-prop">hScrollBarMode</a>. + +<p>Example: <a href="scrollview-example.html#x651">scrollview/scrollview.cpp</a>. +<h3 class=fn>void <a name="setDragAutoScroll"></a>TQScrollView::setDragAutoScroll ( bool b )<tt> [virtual]</tt> +</h3><p>Sets whether autoscrolling in drag move events is enabled to <em>b</em>. +See the <a href="qscrollview.html#dragAutoScroll-prop">"dragAutoScroll"</a> property for details. +<h3 class=fn>void <a name="setHBarGeometry"></a>TQScrollView::setHBarGeometry ( <a href="qscrollbar.html">TQScrollBar</a> & hbar, int x, int y, int w, int h )<tt> [virtual protected]</tt> +</h3> +Called when the horizontal scroll bar geometry changes. This is +provided as a protected function so that subclasses can do +interesting things such as providing extra buttons in some of the +space normally used by the scroll bars. +<p> The default implementation simply gives all the space to <em>hbar</em>. +The new geometry is given by <em>x</em>, <em>y</em>, <em>w</em> and <em>h</em>. +<p> <p>See also <a href="#setVBarGeometry">setVBarGeometry</a>(). + +<h3 class=fn>void <a name="setHScrollBarMode"></a>TQScrollView::setHScrollBarMode ( <a href="qscrollview.html#ScrollBarMode-enum">ScrollBarMode</a> )<tt> [virtual]</tt> +</h3><p>Sets the mode for the horizontal scroll bar. +See the <a href="qscrollview.html#hScrollBarMode-prop">"hScrollBarMode"</a> property for details. +<h3 class=fn>void <a name="setMargins"></a>TQScrollView::setMargins ( int left, int top, int right, int bottom )<tt> [virtual protected]</tt> +</h3> +Sets the margins around the scrolling area to <em>left</em>, <em>top</em>, <em>right</em> and <em>bottom</em>. This is useful for applications such as +spreadsheets with "locked" rows and columns. The marginal space is +<em>inside</em> the <a href="qframe.html#frameRect">frameRect</a>() and is left blank; reimplement +<a href="qframe.html#drawFrame">drawFrame</a>() or put widgets in the unused area. +<p> By default all margins are zero. +<p> <p>See also <a href="qframe.html#frameChanged">frameChanged</a>(). + +<h3 class=fn>void <a name="setResizePolicy"></a>TQScrollView::setResizePolicy ( <a href="qscrollview.html#ResizePolicy-enum">ResizePolicy</a> )<tt> [virtual]</tt> +</h3><p>Sets the resize policy. +See the <a href="qscrollview.html#resizePolicy-prop">"resizePolicy"</a> property for details. +<h3 class=fn>void <a name="setStaticBackground"></a>TQScrollView::setStaticBackground ( bool y ) +</h3> +Sets the scrollview to have a static background if <em>y</em> is TRUE, +or a scrolling background if <em>y</em> is FALSE. By default, the +background is scrolling. +<p> Be aware that this mode is tquite slow, as a full repaint of the +visible area has to be triggered on every contents move. +<p> <p>See also <a href="#hasStaticBackground">hasStaticBackground</a>(). + +<h3 class=fn>void <a name="setVBarGeometry"></a>TQScrollView::setVBarGeometry ( <a href="qscrollbar.html">TQScrollBar</a> & vbar, int x, int y, int w, int h )<tt> [virtual protected]</tt> +</h3> +Called when the vertical scroll bar geometry changes. This is +provided as a protected function so that subclasses can do +interesting things such as providing extra buttons in some of the +space normally used by the scroll bars. +<p> The default implementation simply gives all the space to <em>vbar</em>. +The new geometry is given by <em>x</em>, <em>y</em>, <em>w</em> and <em>h</em>. +<p> <p>See also <a href="#setHBarGeometry">setHBarGeometry</a>(). + +<h3 class=fn>void <a name="setVScrollBarMode"></a>TQScrollView::setVScrollBarMode ( <a href="qscrollview.html#ScrollBarMode-enum">ScrollBarMode</a> )<tt> [virtual]</tt> +</h3><p>Sets the mode for the vertical scroll bar. +See the <a href="qscrollview.html#vScrollBarMode-prop">"vScrollBarMode"</a> property for details. +<h3 class=fn>void <a name="showChild"></a>TQScrollView::showChild ( <a href="qwidget.html">TQWidget</a> * child, bool y = TRUE ) +</h3> +<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> Sets the visibility of <em>child</em>. Equivalent to +<a href="qwidget.html#show">TQWidget::show</a>() or <a href="qwidget.html#hide">TQWidget::hide</a>(). + +<h3 class=fn>int <a name="topMargin"></a>TQScrollView::topMargin () const<tt> [protected]</tt> +</h3> +Returns the top margin. +<p> <p>See also <a href="#setMargins">setMargins</a>(). + +<h3 class=fn>void <a name="updateContents"></a>TQScrollView::updateContents ( int x, int y, int w, int h ) +</h3> +Calls <a href="qwidget.html#update">update</a>() on a rectangle defined by <em>x</em>, <em>y</em>, <em>w</em>, <em>h</em>, +translated appropriately. If the rectangle is not visible, nothing +is repainted. +<p> <p>See also <a href="#repaintContents">repaintContents</a>(). + +<h3 class=fn>void <a name="updateContents-2"></a>TQScrollView::updateContents ( const <a href="qrect.html">TQRect</a> & r ) +</h3> +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +<p> Updates the contents in rectangle <em>r</em> + +<h3 class=fn>void <a name="updateContents-3"></a>TQScrollView::updateContents () +</h3> +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +<p> +<h3 class=fn>void <a name="updateScrollBars"></a>TQScrollView::updateScrollBars ()<tt> [slot]</tt> +</h3> +Updates scroll bars: all possibilities are considered. You should +never need to call this in your code. + +<h3 class=fn><a href="qscrollview.html#ScrollBarMode-enum">ScrollBarMode</a> <a name="vScrollBarMode"></a>TQScrollView::vScrollBarMode () const +</h3><p>Returns the mode for the vertical scroll bar. +See the <a href="qscrollview.html#vScrollBarMode-prop">"vScrollBarMode"</a> property for details. +<h3 class=fn><a href="qscrollbar.html">TQScrollBar</a> * <a name="verticalScrollBar"></a>TQScrollView::verticalScrollBar () const +</h3> +Returns the component vertical scroll bar. It is made available to +allow accelerators, autoscrolling, etc. +<p> It should not be used for other purposes. +<p> This function never returns 0. + +<h3 class=fn>void <a name="verticalSliderPressed"></a>TQScrollView::verticalSliderPressed ()<tt> [signal]</tt> +</h3> + +<p> This signal is emitted whenever the user presses the vertical slider. + +<h3 class=fn>void <a name="verticalSliderReleased"></a>TQScrollView::verticalSliderReleased ()<tt> [signal]</tt> +</h3> + +<p> This signal is emitted whenever the user releases the vertical slider. + +<h3 class=fn><a href="qwidget.html">TQWidget</a> * <a name="viewport"></a>TQScrollView::viewport () const +</h3> +Returns the viewport widget of the scrollview. This is the widget +containing the contents widget or which is the drawing area. + +<p>Examples: <a href="helpsystem-example.html#x2683">helpsystem/tooltip.cpp</a> and <a href="scrollview-example.html#x655">scrollview/scrollview.cpp</a>. +<h3 class=fn>void <a name="viewportPaintEvent"></a>TQScrollView::viewportPaintEvent ( <a href="qpaintevent.html">TQPaintEvent</a> * pe )<tt> [virtual protected]</tt> +</h3> +This is a low-level painting routine that draws the viewport +contents. Reimplement this if <a href="#drawContents">drawContents</a>() is too high-level +(for example, if you don't want to open a <a href="qpainter.html">TQPainter</a> on the +viewport). The paint event is passed in <em>pe</em>. + +<h3 class=fn>void <a name="viewportResizeEvent"></a>TQScrollView::viewportResizeEvent ( <a href="qresizeevent.html">TQResizeEvent</a> * )<tt> [virtual protected]</tt> +</h3> +To provide simple processing of events on the contents, this +function receives all resize events sent to the viewport. +<p> <p>See also <a href="qwidget.html#resizeEvent">TQWidget::resizeEvent</a>(). + +<p>Example: <a href="tutorial2-06.html#x2587">chart/canvasview.cpp</a>. +<h3 class=fn><a href="qsize.html">TQSize</a> <a name="viewportSize"></a>TQScrollView::viewportSize ( int x, int y ) const +</h3> +Returns the viewport size for size (<em>x</em>, <em>y</em>). +<p> The viewport size depends on <em>(x, y)</em> (the size of the contents), +the size of this widget and the modes of the horizontal and +vertical scroll bars. +<p> This function permits widgets that can trade vertical and +horizontal space for each other to control scroll bar appearance +better. For example, a word processor or web browser can control +the width of the right margin accurately, whether or not there +needs to be a vertical scroll bar. + +<h3 class=fn>void <a name="viewportToContents"></a>TQScrollView::viewportToContents ( int vx, int vy, int & x, int & y ) const +</h3> +Translates a point (<em>vx</em>, <em>vy</em>) on the <a href="#viewport">viewport</a>() widget to a +point (<em>x</em>, <em>y</em>) in the contents. + +<h3 class=fn><a href="qpoint.html">TQPoint</a> <a name="viewportToContents-2"></a>TQScrollView::viewportToContents ( const <a href="qpoint.html">TQPoint</a> & vp ) const +</h3> +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +<p> Returns the point on the viewport <em>vp</em> translated to a point in +the contents. + +<h3 class=fn>int <a name="visibleHeight"></a>TQScrollView::visibleHeight () const +</h3><p>Returns the vertical amount of the content that is visible. +See the <a href="qscrollview.html#visibleHeight-prop">"visibleHeight"</a> property for details. +<h3 class=fn>int <a name="visibleWidth"></a>TQScrollView::visibleWidth () const +</h3><p>Returns the horizontal amount of the content that is visible. +See the <a href="qscrollview.html#visibleWidth-prop">"visibleWidth"</a> property for details. +<hr><h2>Property Documentation</h2> +<h3 class=fn>int <a name="contentsHeight-prop"></a>contentsHeight</h3> +<p>This property holds the height of the contents area. +<p> +<p>Get this property's value with <a href="#contentsHeight">contentsHeight</a>(). +<h3 class=fn>int <a name="contentsWidth-prop"></a>contentsWidth</h3> +<p>This property holds the width of the contents area. +<p> +<p>Get this property's value with <a href="#contentsWidth">contentsWidth</a>(). +<h3 class=fn>int <a name="contentsX-prop"></a>contentsX</h3> +<p>This property holds the X coordinate of the contents that are at the left edge of the viewport. +<p> +<p>Get this property's value with <a href="#contentsX">contentsX</a>(). +<h3 class=fn>int <a name="contentsY-prop"></a>contentsY</h3> +<p>This property holds the Y coordinate of the contents that are at the top edge of the viewport. +<p> +<p>Get this property's value with <a href="#contentsY">contentsY</a>(). +<h3 class=fn>bool <a name="dragAutoScroll-prop"></a>dragAutoScroll</h3> +<p>This property holds whether autoscrolling in drag move events is enabled. +<p>If this property is set to TRUE (the default), the TQScrollView +automatically scrolls the contents in drag move events if the user +moves the cursor close to a border of the view. Of course this +works only if the viewport accepts drops. Specifying FALSE +disables this autoscroll feature. +<p> <b>Warning:</b> Enabling this property might not be enough to +effectively turn on autoscrolling. If you put a custom widget in +the TQScrollView, you might need to call TQDragEvent::ignore() on +the event in the <a href="qwidget.html#dragEnterEvent">dragEnterEvent</a>() and <a href="qwidget.html#dragMoveEvent">dragMoveEvent</a>() +reimplementations. + +<p>Set this property's value with <a href="#setDragAutoScroll">setDragAutoScroll</a>() and get this property's value with <a href="#dragAutoScroll">dragAutoScroll</a>(). +<h3 class=fn><a href="qscrollview.html#ScrollBarMode-enum">ScrollBarMode</a> <a name="hScrollBarMode-prop"></a>hScrollBarMode</h3> +<p>This property holds the mode for the horizontal scroll bar. +<p>The default mode is <a href="#ScrollBarMode-enum">TQScrollView::Auto</a>. +<p> <p>See also <a href="#vScrollBarMode-prop">vScrollBarMode</a>. + +<p>Set this property's value with <a href="#setHScrollBarMode">setHScrollBarMode</a>() and get this property's value with <a href="#hScrollBarMode">hScrollBarMode</a>(). +<h3 class=fn><a href="qscrollview.html#ResizePolicy-enum">ResizePolicy</a> <a name="resizePolicy-prop"></a>resizePolicy</h3> +<p>This property holds the resize policy. +<p>The default is <a href="#ResizePolicy-enum">Default</a>. +<p> <p>See also <a href="#ResizePolicy-enum">ResizePolicy</a>. + +<p>Set this property's value with <a href="#setResizePolicy">setResizePolicy</a>() and get this property's value with <a href="#resizePolicy">resizePolicy</a>(). +<h3 class=fn><a href="qscrollview.html#ScrollBarMode-enum">ScrollBarMode</a> <a name="vScrollBarMode-prop"></a>vScrollBarMode</h3> +<p>This property holds the mode for the vertical scroll bar. +<p>The default mode is <a href="#ScrollBarMode-enum">TQScrollView::Auto</a>. +<p> <p>See also <a href="#hScrollBarMode-prop">hScrollBarMode</a>. + +<p>Set this property's value with <a href="#setVScrollBarMode">setVScrollBarMode</a>() and get this property's value with <a href="#vScrollBarMode">vScrollBarMode</a>(). +<h3 class=fn>int <a name="visibleHeight-prop"></a>visibleHeight</h3> +<p>This property holds the vertical amount of the content that is visible. +<p> +<p>Get this property's value with <a href="#visibleHeight">visibleHeight</a>(). +<h3 class=fn>int <a name="visibleWidth-prop"></a>visibleWidth</h3> +<p>This property holds the horizontal amount of the content that is visible. +<p> +<p>Get this property's value with <a href="#visibleWidth">visibleWidth</a>(). +<!-- eof --> +<hr><p> +This file is part of the <a href="index.html">TQt toolkit</a>. +Copyright © 1995-2007 +<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center> +<table width=100% cellspacing=0 border=0><tr> +<td>Copyright © 2007 +<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> +<td align=right><div align=right>TQt 3.3.8</div> +</table></div></address></body> +</html> |