qscrollview.html

QT参考文档

</h3>
当水平滚动条几何形状发生变化，被调用。它被提供为保护函数这样子类可以做一些有趣的事情，比如在通常由滚动条使用的一些空间上提供额外的按钮。
<p> 默认实现简单地把所有的空间给<em>hbar</em>。新的几何形状由<em>x</em>、<em>y</em>、<em>w</em>和<em>h</em>给定。
<p> <p>也可以参考<a href="#setVBarGeometry">setVBarGeometry</a>()。

<h3 class=fn>void <a name="setHScrollBarMode"></a>QScrollView::setHScrollBarMode ( <a href="qscrollview.html#ScrollBarMode-enum">ScrollBarMode</a> )<tt> [虚]</tt>
</h3>
<p>设置水平滚动条的模式。详细情况请参考<a href="qscrollview.html#hScrollBarMode-prop">“hScrollBarMode”</a>属性。

<h3 class=fn>void <a name="setMargins"></a>QScrollView::setMargins ( int&nbsp;left, int&nbsp;top, int&nbsp;right, int&nbsp;bottom )<tt> [虚 保护]</tt>
</h3>
设置滚动区域周围的边距为<em>left</em>、<em>top</em>、<em>right</em>和<em>bottom</em>。这对于一些像电子制表软件要“锁定”行或列的应用程序很有用。边距空间在<a href="qframe.html#frameRect">frameRect</a>()<em>之内</em>并且是空白的，重新实现<a href="#drawContents">drawContents</a>()或者在没有被使用的区域放上窗口部件。
<p> 默认情况下，所有边距为0。
<p> <p>也可以参考<a href="qframe.html#frameChanged">frameChanged</a>()。

<h3 class=fn>void <a name="setResizePolicy"></a>QScrollView::setResizePolicy ( <a href="qscrollview.html#ResizePolicy-enum">ResizePolicy</a> )<tt> [虚]</tt>
</h3>
<p>设置当前重新定义大小的策略。详细情况请参考<a href="qscrollview.html#resizePolicy-prop">“resizePolicy”</a>属性。

<h3 class=fn>void <a name="setStaticBackground"></a>QScrollView::setStaticBackground ( bool&nbsp;y )
</h3>
如果<em>y</em>为真，设置滚动视图有一个静态背景，否则如果<em>y</em>为假，就是一个滚动背景。默认情况，背景是滚动的。
<p> 要知道这种方式是非常慢的，比如，每一个内容移动都不得不触发可视区域完全重新绘制。
<p> <p>也可以参考<a href="#hasStaticBackground">hasStaticBackground</a>()。

<h3 class=fn>void <a name="setVBarGeometry"></a>QScrollView::setVBarGeometry ( <a href="qscrollbar.html">QScrollBar</a>&nbsp;&amp;&nbsp;vbar, int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h )<tt> [虚 保护]</tt>
</h3>
当垂直滚动条几何形状发生变化，被调用。它被提供为保护函数这样子类可以做一些有趣的事情，比如在通常由滚动条使用的一些空间上提供额外的按钮。
<p> 默认实现简单地把所有的空间给<em>vbar</em>。新的几何形状由<em>x</em>、<em>y</em>、<em>w</em>和<em>h</em>给定。
<p> <p>也可以参考<a href="#setHBarGeometry">setHBarGeometry</a>()。

<h3 class=fn>void <a name="setVScrollBarMode"></a>QScrollView::setVScrollBarMode ( <a href="qscrollview.html#ScrollBarMode-enum">ScrollBarMode</a> )<tt> [虚]</tt>
</h3>
<p>设置垂直滚动条的模式。详细情况请参考<a href="qscrollview.html#vScrollBarMode-prop">“vScrollBarMode”</a>属性。

<h3 class=fn>void <a name="showChild"></a>QScrollView::showChild ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;child, bool&nbsp;y = TRUE )
</h3> 
<b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 设置<em>child</em>的可视性。等于<a href="qwidget.html#show">QWidget::show</a>()或<a href="qwidget.html#hide">QWidget::hide</a>()。

<h3 class=fn>int <a name="topMargin"></a>QScrollView::topMargin () const<tt> [保护]</tt>
</h3>
返回上边距。
<p>也可以参考<a href="#setMargins">setMargins</a>()。

<h3 class=fn>void <a name="updateContents"></a>QScrollView::updateContents ( int&nbsp;x, int&nbsp;y, int&nbsp;w, int&nbsp;h )
</h3>
在一个被适当转化的有<em>x</em>、<em>y</em>、<em>w</em>、<em>h</em>定义的矩形上调用<a href="qwidget.html#update">update</a>()。如果这个矩形不是可视的，那么就什么也没有被重新绘制。
<p> <p>也可以参考<a href="#repaintContents">repaintContents</a>()。

<h3 class=fn>void <a name="updateContents-2"></a>QScrollView::updateContents ( const&nbsp;<a href="qrect.html">QRect</a>&nbsp;&amp;&nbsp;r )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 更新矩形<em>r</em>中的内容。

<h3 class=fn>void <a name="updateContents-3"></a>QScrollView::updateContents ()
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

<h3 class=fn>void <a name="updateScrollBars"></a>QScrollView::updateScrollBars ()<tt> [槽]</tt>
</h3>
更新滚动条——所有可能性都被考虑了。你应该永远不需要在你的代码中调用这个函数。

<h3 class=fn><a href="qscrollview.html#ScrollBarMode-enum">ScrollBarMode</a> <a name="vScrollBarMode"></a>QScrollView::vScrollBarMode () const
</h3>
<p>返回垂直滚动条的模式。详细情况请参考<a href="qscrollview.html#vScrollBarMode-prop">“vScrollBarMode”</a>属性。

<h3 class=fn><a href="qscrollbar.html">QScrollBar</a>&nbsp;* <a name="verticalScrollBar"></a>QScrollView::verticalScrollBar () const
</h3>
返回垂直滚动条。它被用来允许快捷键、自动滚动等等和允许改变箭头滚动速度，也就是bar->setSteps( rate, bar->pageStep() )。
<p> 它不应该被其他方式操作。
<p> 这个函数从来不会返回0。

<h3 class=fn><a href="qwidget.html">QWidget</a>&nbsp;* <a name="viewport"></a>QScrollView::viewport () const
</h3>
返回滚动视图中的视口窗口部件。这个窗口部件包含内容窗口部件或者要画的区域。
<p>实例：<a href="scrollview-example.html#x742">scrollview/scrollview.cpp</a>。

<h3 class=fn>void <a name="viewportPaintEvent"></a>QScrollView::viewportPaintEvent ( <a href="qpaintevent.html">QPaintEvent</a>&nbsp;*&nbsp;pe )<tt> [虚 保护]</tt>
</h3>
这是一个绘制视口内容的低水平的绘制常规程序。如果<a href="#drawContents">drawContents</a>()太高水平的话（例如，如果你不想在视口上打开<a href="qpainter.html">QPainter</a>），重新实现这个函数。绘制事件被传递进<em>pe</em>。

<h3 class=fn>void <a name="viewportResizeEvent"></a>QScrollView::viewportResizeEvent ( <a href="qresizeevent.html">QResizeEvent</a>&nbsp;* )<tt> [虚 保护]</tt>
</h3>
提供内容上的事件的简单处理，这个函数接收所有发送给视口的重新定义大小事件。
<p> <p>也可以参考<a href="qwidget.html#resizeEvent">QWidget::resizeEvent</a>()。
<p>实例：<a href="tutorial2-06.html#x2492">chart/canvasview.cpp</a>。

<h3 class=fn><a href="qsize.html">QSize</a> <a name="viewportSize"></a>QScrollView::viewportSize ( int&nbsp;x, int&nbsp;y ) const
</h3> 
返回视口的大小(<em>x</em>, <em>y</em>)。
<p> 视口大小依赖于<em>(x, y)</em>（内容的大小）、这个窗口部件的大小和水平和垂直滚动条的模式。
<p> 这个函数允许窗口部件互相交换垂直和水平空间来更好地控制滚动条的外观。例如，一个字处理器或者网页浏览器可以精确地控制右边距的宽度来决定它是否需要一个垂直滚动条。

<h3 class=fn>void <a name="viewportToContents"></a>QScrollView::viewportToContents ( int&nbsp;vx, int&nbsp;vy, int&nbsp;&amp;&nbsp;x, int&nbsp;&amp;&nbsp;y ) const
</h3>
把<a href="#viewport">viewport</a>()窗口部件中的点(<em>vx</em>, <em>vy</em>)转换为内容中的点(<em>x</em>, <em>y</em>)。

<h3 class=fn><a href="qpoint.html">QPoint</a> <a name="viewportToContents-2"></a>QScrollView::viewportToContents ( const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;vp ) const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> <p> 返回转换为内容中的点的视口的点<em>vp</em>。

<h3 class=fn>int <a name="visibleHeight"></a>QScrollView::visibleHeight () const
</h3>
<p>返回可视内容的垂直总量。详细情况请参考<a href="qscrollview.html#visibleHeight-prop">“visibleHeight”</a>属性。

<h3 class=fn>int <a name="visibleWidth"></a>QScrollView::visibleWidth () const
</h3>
<p><p>返回可视内容的水平总量。详细情况请参考<a href="qscrollview.html#visibleWidth-prop">“visibleWidth”</a>属性。

<hr><h2>属性文档</h2>
<h3 class=fn>int <a name="contentsHeight-prop"></a>contentsHeight</h3>
<p>这个属性保存的是内容区域的高度。
<p>通过<a href="#contentsHeight">contentsHeight</a>()来获得属性值。

<h3 class=fn>int <a name="contentsWidth-prop"></a>contentsWidth</h3>
<p>这个属性保存的是内容区域的宽度。
<p>通过<a href="#contentsWidth">contentsWidth</a>()来获得属性值。

<h3 class=fn>int <a name="contentsX-prop"></a>contentsX</h3>
<p>这个属性保存的是在视口的左边缘的内容的X坐标。
<p>通过<a href="#contentsX">contentsX</a>()来获得属性值。

<h3 class=fn>int <a name="contentsY-prop"></a>contentsY</h3>
<p>这个属性保存的是在视口的左边缘的内容的Y坐标。
<p>通过<a href="#contentsY">contentsY</a>()来获得属性值。

<h3 class=fn>bool <a name="dragAutoScroll-prop"></a>dragAutoScroll</h3>
<p>这个属性保存的是在拖动移动事件中自动滚动是否生效。
<p>如果这个属性被设置为真（默认），如果用户移动光标接近视图的边框，QScrollView会在拖动移动事件中自动滚动内容。当然这只在视口允许放下的情况才能工作。指定为假将使自动滚动特征失效。
<p>通过<a href="#setDragAutoScroll">setDragAutoScroll</a>()来设置属性值并且通过<a href="#dragAutoScroll">dragAutoScroll</a>()来获得属性值。

<h3 class=fn><a href="qscrollview.html#ScrollBarMode-enum">ScrollBarMode</a> <a name="hScrollBarMode-prop"></a>hScrollBarMode</h3>
<p>这个属性保存的是水平滚动条模式。
<p>默认模式为QScrollView::Auto。
<p> <p>也可以参考<a href="#vScrollBarMode-prop">vScrollBarMode</a>。
<p>通过<a href="#setHScrollBarMode">setHScrollBarMode</a>()设置属性值并且通过<a href="#hScrollBarMode">hScrollBarMode</a>()来获得属性值。

<h3 class=fn><a href="qscrollview.html#ResizePolicy-enum">ResizePolicy</a> <a name="resizePolicy-prop"></a>resizePolicy</h3>
<p>这个属性保存的是当前重定义大小策略。
<p>默认为<a href="#ResizePolicy-enum">Default</a>。
<p> <p>也可以参考<a href="#ResizePolicy-enum">ResizePolicy</a>。
<p>通过<a href="#setResizePolicy">setResizePolicy</a>()设置属性值并且通过<a href="#resizePolicy">resizePolicy</a>()来获得属性值。

<h3 class=fn><a href="qscrollview.html#ScrollBarMode-enum">ScrollBarMode</a> <a name="vScrollBarMode-prop"></a>vScrollBarMode</h3>
<p>这个属性保存的是垂直滚动条模式。
<p>默认模式为QScrollView::Auto。
<p> <p>也可以参考<a href="#hScrollBarMode-prop">hScrollBarMode</a>。
<p>通过<a href="#setVScrollBarMode">setVScrollBarMode</a>()设置属性值并且通过<a href="#vScrollBarMode">vScrollBarMode</a>()来获得属性值。

<h3 class=fn>int <a name="visibleHeight-prop"></a>visibleHeight</h3>
<p>这个属性保存的是可视内容的垂直总量。
<p>通过<a href="#visibleHeight">visibleHeight</a>()来获得属性值。

<h3 class=fn>int <a name="visibleWidth-prop"></a>visibleWidth</h3>
<p>这个属性保存的是可视内容的水平总量。
<p>通过<a href="#visibleWidth">visibleWidth</a>()来获得属性值。

<!-- eof -->
<hr><p>
这个文件是<a href="index.html">Qt工具包</a>一部分。
版权所有 &copy; 1995-2002
<a href="http://www.trolltech.com/">Trolltech</a>。保留所有权利。
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2002 
<a href="http://www.trolltech.com">Trolltech</a>
<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td><a href="zh_CN.html">译者:Cavendish</a>
<td align=right><div align=right>Qt 3.0.5版</div>
</table></div></address></body>
</html>