qwidget.html

QT3.0.5的帮助文档的中文翻译

</h3>
构造一个是<em>parent</em>的孩子、名称为<em>name</em>并且窗口部件标记为<em>f</em>的窗口部件。
<p> 如果<em>parent</em>为0，新的窗口部件变为顶级窗口。如果<em>parent</em>是另一个窗口部件，这个窗口部件变为<em>parent</em>中的一个子窗口。当它的<em>parent</em>被删除时，新的窗口部件被删除。
<p> <em>name</em>被发送给<a href="qobject.html">QObject</a>的构造函数。
<p> 窗口部件标记参数<em>f</em>通常为0，但它可以为顶级窗口部件设置自定义的窗口框架（比如，<em>parent</em>必须为0）。为了自定义框架，设置<a href="qt.html#WidgetFlags-enum">WStyle_Customize</a>标记和任何一个<a href="qt.html#WidgetFlags-enum">Qt::WidgetFlags</a>进行或运算。
<p> 如果你向一个已经可见的窗口部件中添加一个子窗口部件，你必须明显地显示这个孩子来使它可视。
<p> 注意Qt的X11版本也许不能在所有的系统上传递风格标记得所有组合。这是因为在X11上，Qt只能询问窗口管理器，并且窗口管理器会覆盖应用程序的设置。在Windows上，Qt可以是指你想要的任何标记。
<p> 实例：
<pre>
    <a href="qlabel.html">QLabel</a> *splashScreen = new <a href="qlabel.html">QLabel</a>( 0, "mySplashScreen",
                                WStyle_Customize | WStyle_NoBorder |
                                <a href="qt.html#WidgetFlags-enum">WStyle_Tool</a> );
    </pre>
 

<h3 class=fn><a name="~QWidget"></a>QWidget::~QWidget ()
</h3>
销毁这个窗口部件。
<p> 首先这个窗口部件的孩子都被删除。如果这个窗口部件是主窗口部件，应用程序退出。

<h3 class=fn>bool <a name="acceptDrops"></a>QWidget::acceptDrops () const
</h3>
<p>如果对于这个窗口部件放下事件生效，返回真，否则返回假。详细情况请参考<a href="qwidget.html#acceptDrops-prop">“acceptDrops”</a>属性。

<h3 class=fn>void <a name="adjustSize"></a>QWidget::adjustSize ()<tt> [虚]</tt>
</h3>
调整窗口部件的大小来适合它的内容。
<p> 如果<a href="#sizeHint">sizeHint</a>()有效（比如，如果大小提示的宽和高都大于等于0）就是用它，否则设置大小为子对象所占用的矩形（所有子窗口部件几何形状的合集）。
<p> <p>也可以参考<a href="#sizeHint-prop">sizeHint</a>和<a href="#childrenRect-prop">childrenRect</a>。
<p>实例：<a href="xform-example.html#x1467">xform/xform.cpp</a>。
<p>在<a href="qmessagebox.html#adjustSize">QMessageBox</a>中被重新实现。

<h3 class=fn>bool <a name="autoMask"></a>QWidget::autoMask () const
</h3>
<p>如果对于这个窗口部件自动面具特征生效，返回真，否则返回假。详细情况请参考<a href="qwidget.html#autoMask-prop">“autoMask”</a>属性。

<h3 class=fn>const&nbsp;<a href="qbrush.html">QBrush</a>&nbsp;&amp; <a name="backgroundBrush"></a>QWidget::backgroundBrush () const
</h3>
<p>返回这个窗口部件的背景画刷。详细情况请参考<a href="qwidget.html#backgroundBrush-prop">“backgroundBrush”</a>属性。

<h3 class=fn>const&nbsp;<a href="qcolor.html">QColor</a>&nbsp;&amp; <a name="backgroundColor"></a>QWidget::backgroundColor () const
</h3>
<b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p>作为替代请使用<a href="#paletteBackgroundColor">paletteBackgroundColor</a>()或<a href="#eraseColor">eraseColor</a>()。

<h3 class=fn><a href="qt.html#BackgroundMode-enum">BackgroundMode</a> <a name="backgroundMode"></a>QWidget::backgroundMode () const
</h3>
<p>返回绘制窗口部件的背景所使用的颜色功能。详细情况请参考<a href="qwidget.html#backgroundMode-prop">“backgroundMode”</a>属性。

<h3 class=fn><a href="qwidget.html#BackgroundOrigin-enum">BackgroundOrigin</a> <a name="backgroundOrigin"></a>QWidget::backgroundOrigin () const
</h3>
<p>返回窗口部件的背景的原点。详细情况请参考<a href="qwidget.html#backgroundOrigin-prop">“backgroundOrigin”</a>属性。

<h3 class=fn>const&nbsp;<a href="qpixmap.html">QPixmap</a>&nbsp;* <a name="backgroundPixmap"></a>QWidget::backgroundPixmap () const
</h3>
<b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p>作为替代请使用<a href="#paletteBackgroundPixmap">paletteBackgroundPixmap</a>()或者<a href="#erasePixmap">erasePixmap</a>()。
<p>实例：<a href="themes-example.html#x267">themes/metal.cpp</a>和<a href="themes-example.html#x213">themes/wood.cpp</a>。

<h3 class=fn><a href="qsize.html">QSize</a> <a name="baseSize"></a>QWidget::baseSize () const
</h3>
<p>返回窗口部件的继承大小。详细情况请参考<a href="qwidget.html#baseSize-prop">“baseSize”</a>属性。

<h3 class=fn><a href="qstring.html">QString</a> <a name="caption"></a>QWidget::caption () const
</h3>
<p>返回窗口标题。详细情况请参考<a href="qwidget.html#caption-prop">“caption”</a>属性。

<h3 class=fn><a href="qwidget.html">QWidget</a>&nbsp;* <a name="childAt"></a>QWidget::childAt ( int&nbsp;x, int&nbsp;y, bool&nbsp;includeThis = FALSE ) const
</h3>  
返回在窗口部件自己的坐标系统中像素位置<em>(x, y)</em>处的可视的子窗口部件。
<p> 如果<em>includeThis</em>为真，并且在<em>(x, y)</em>没有可视的孩子，那么这个窗口部件本身被返回。

<h3 class=fn><a href="qwidget.html">QWidget</a>&nbsp;* <a name="childAt-2"></a>QWidget::childAt ( const&nbsp;<a href="qpoint.html">QPoint</a>&nbsp;&amp;&nbsp;p, bool&nbsp;includeThis = FALSE ) const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 返回在窗口部件自己的坐标系统中点<em>p</em>处的可视的子窗口部件。
<p> 如果<em>includeThis</em>为真，并且在<em>p</em>没有可视的孩子，那么这个窗口部件本身被返回。

<h3 class=fn><a href="qrect.html">QRect</a> <a name="childrenRect"></a>QWidget::childrenRect () const
</h3>
<p>返回这个窗口部件的孩子的边界矩形。详细情况请参考<a href="qwidget.html#childrenRect-prop">“childrenRect”</a>属性。

<h3 class=fn><a href="qregion.html">QRegion</a> <a name="childrenRegion"></a>QWidget::childrenRegion () const
</h3>
<p>返回这个窗口部件的孩子所占用的组合区域。详细情况请参考<a href="qwidget.html#childrenRegion-prop">“childrenRegion”</a>属性。

<h3 class=fn>void <a name="clearFocus"></a>QWidget::clearFocus ()<tt> [槽]</tt>
</h3>
从窗口部件中拿走键盘输入焦点。
<p> 如果这个窗口部件有激活的焦点，<a href="#focusOutEvent">焦点移出事件</a>被发送给这个窗口部件告诉它关于它失去了焦点。
<p> 这个窗口部件必须已经为了获得键盘输入焦点使焦点设置生效，比如，它必须调用<a href="#setFocusPolicy">setFocusPolicy</a>()。
<p> <p>也可以参考<a href="#focus-prop">focus</a>、<a href="#setFocus">setFocus</a>()、<a href="#focusInEvent">focusInEvent</a>()、<a href="#focusOutEvent">focusOutEvent</a>()、<a href="#focusPolicy-prop">focusPolicy</a>和<a href="qapplication.html#focusWidget">QApplication::focusWidget</a>()。

<h3 class=fn>void <a name="clearMask"></a>QWidget::clearMask ()
</h3>
通过<a href="#setMask">setMask</a>()移除任何面具设置。
<p> <p>也可以参考<a href="#setMask">setMask</a>()。

<h3 class=fn>void <a name="clearWFlags"></a>QWidget::clearWFlags ( WFlags&nbsp;f )<tt> [保护]</tt>
</h3>
<p> 清空窗口部件标记<em>f</em>。
<p> 窗口部件标记是<a href="qt.html#WidgetFlags-enum">Qt::WidgetFlags</a>的组合。
<p> <p>也可以参考<a href="#testWFlags">testWFlags</a>()、<a href="#getWFlags">getWFlags</a>()和<a href="#setWFlags">setWFlags</a>()。

<h3 class=fn>bool <a name="close"></a>QWidget::close ()<tt> [槽]</tt>
</h3>
<p> 关闭这个窗口部件。如果窗口部件被关闭，返回真，否则返回假。
<p> 首先它发送给这个窗口部件一个<a href="qcloseevent.html">QCloseEvent</a>。如果它<a href="qcloseevent.html#accept">接收</a>这个关闭事件，它就被<a href="#hide">隐藏了</a>。<a href="#closeEvent">QWidget::closeEvent</a>()的默认实现是接收这个关闭事件。
<p> 当最后一个可视的顶级窗口部件被关闭，<a href="qapplication.html#lastWindowClosed">QApplication::lastWindowClosed</a>()信号被发射。
<p>实例：<a href="mdi-example.html#x2045">mdi/application.cpp</a>和<a href="popup-example.html#x1582">popup/popup.cpp</a>。

<h3 class=fn>bool <a name="close-2"></a>QWidget::close ( bool&nbsp;alsoDelete )<tt> [虚]</tt>
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 关闭这个窗口部件。如果窗口部件被关闭，返回真，否则返回假。
<p> 如果<em>alsoDelete</em>为真或者这个窗口部件有<a href="qt.html#WidgetFlags-enum">WDestructiveClose</a>窗口部件标记，这个窗口部件也被删除。这个窗口部件自己可以通过抵制它所收到的<a href="qcloseevent.html">QCloseEvent</a>来防止被关闭。
<p> 当最后一个可视的顶级窗口部件被关闭，<a href="qapplication.html#lastWindowClo