Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > a6711891ce757817bba854bf3f25205a > files > 2405

qtjambi-doc-4.3.3-3mdv2008.1.i586.rpm

<class name="QToolTip" doc="/**
&lt;p&gt;The &lt;a href=&quot;QToolTip.html&quot;&gt;&lt;tt&gt;QToolTip&lt;/tt&gt;&lt;/a&gt; class provides tool tips (balloon help) for any widget.&lt;/p&gt;
&lt;p&gt;The tip is a short piece of text reminding the user of the widget's function. It is drawn immediately below the given position in a distinctive black-on-yellow color combination. The tip can be any &lt;a href=&quot;QTextEdit.html&quot;&gt;rich text&lt;/tt&gt;&lt;/a&gt; formatted string.&lt;/p&gt;
&lt;p&gt;Rich text displayed in a tool tip is implicitly word-wrapped unless specified differently with &lt;tt&gt;&amp;lt;p style='white-space:pre'&amp;gt;&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;The simplest and most common way to set a widget's tool tip is by calling its QWidget::setToolTip() function.&lt;/p&gt;
&lt;p&gt;It is also possible to show different tool tips for different regions of a widget, by using a &lt;a href=&quot;QHelpEvent.html&quot;&gt;&lt;tt&gt;QHelpEvent&lt;/tt&gt;&lt;/a&gt; of type QEvent::ToolTip. Intercept the help event in your widget's event() function and call QToolTip::showText() with the text you want to display. The Tooltips&lt;/tt&gt; example illustrates this technique.&lt;/p&gt;
&lt;p&gt;Note that, if you want to show tooltips in an item view, the model/view architecture provides functionality to set an item's tool tip; e.g&amp;#x2e;, the QTableWidgetItem::setToolTip() function. However, if you want to provide custom tool tips in an item view, you must intercept the help event in the QAbstractItemView::viewportEvent() function and handle it yourself.&lt;/p&gt;
&lt;p&gt;The default tool tip color and font can be customized with &lt;a href=&quot;QToolTip.html#setPalette(com.trolltech.qt.gui.QPalette)&quot;&gt;&lt;tt&gt;setPalette&lt;/tt&gt;&lt;/a&gt; and &lt;a href=&quot;QToolTip.html#setFont(com.trolltech.qt.gui.QFont)&quot;&gt;&lt;tt&gt;setFont&lt;/tt&gt;&lt;/a&gt;.&lt;/p&gt;

@see &lt;tt&gt;QWidget::toolTip&lt;/tt&gt;
@see &lt;tt&gt;QAction::toolTip&lt;/tt&gt;
@see Tool Tips Example&lt;/tt&gt; */">
    <method name="public native static com.trolltech.qt.gui.QFont font()" doc="/**
&lt;p&gt;Returns the font used to render tooltips.&lt;/p&gt;

@see &lt;a href=&quot;QToolTip.html#setFont(com.trolltech.qt.gui.QFont)&quot;&gt;&lt;tt&gt;setFont&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public native static void hideText()" doc="/**
&lt;p&gt;Hides the tool tip. This is the same as calling &lt;a href=&quot;QToolTip.html#showText(com.trolltech.qt.core.QPoint, java.lang.String, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;showText&lt;/tt&gt;&lt;/a&gt; with an empty string.&lt;/p&gt;

@see &lt;a href=&quot;QToolTip.html#showText(com.trolltech.qt.core.QPoint, java.lang.String, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;showText&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public native static com.trolltech.qt.gui.QPalette palette()" doc="/**
&lt;p&gt;Returns the palette used to render tooltips.&lt;/p&gt;

@see &lt;a href=&quot;QToolTip.html#setPalette(com.trolltech.qt.gui.QPalette)&quot;&gt;&lt;tt&gt;setPalette&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public static void setFont(com.trolltech.qt.gui.QFont arg__1)" doc="/**
&lt;p&gt;Sets the &lt;tt&gt;arg__1&lt;/tt&gt; used to render tooltips.&lt;/p&gt;

@see &lt;a href=&quot;QToolTip.html#font()&quot;&gt;&lt;tt&gt;font&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public static void setPalette(com.trolltech.qt.gui.QPalette arg__1)" doc="/**
&lt;p&gt;Sets the &lt;tt&gt;arg__1&lt;/tt&gt; used to render tooltips.&lt;/p&gt;

@see &lt;a href=&quot;QToolTip.html#palette()&quot;&gt;&lt;tt&gt;palette&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public static void showText(com.trolltech.qt.core.QPoint pos, java.lang.String text, com.trolltech.qt.gui.QWidget w, com.trolltech.qt.core.QRect rect)" doc="/**
&lt;p&gt;Shows &lt;tt&gt;text&lt;/tt&gt; as a tool tip, with the global position &lt;tt&gt;pos&lt;/tt&gt; as the point of interest. The tool tip will be shown with a platform specific offset from this point of interest.&lt;/p&gt;
&lt;p&gt;If you specify a non-empty rect the tip will be hidden as soon as you move your cursor out of this area.&lt;/p&gt;
&lt;p&gt;The &lt;tt&gt;rect&lt;/tt&gt; is in the coordinates of the widget you specify with &lt;tt&gt;w&lt;/tt&gt;. If the &lt;tt&gt;rect&lt;/tt&gt; is not empty you must specify a widget. Otherwise this argument can be 0 but it is used to determine the appropriate screen on multi-head systems.&lt;/p&gt;
&lt;p&gt;If &lt;tt&gt;text&lt;/tt&gt; is empty the tool tip is hidden. If the text is the same as the currently shown tooltip, the tip will &lt;i&gt;not&lt;/i&gt; move. You can force moving by first hiding the tip with an empty text, and then showing the new tip at the new position.&lt;/p&gt;
 */"/>
    <method name="public static void showText(com.trolltech.qt.core.QPoint pos, java.lang.String text, com.trolltech.qt.gui.QWidget w)" doc="/**
&lt;p&gt;This is analogous to calling QToolTip::showText(&lt;tt&gt;pos&lt;/tt&gt;, &lt;tt&gt;text&lt;/tt&gt;, &lt;tt&gt;w&lt;/tt&gt;, QRect())&lt;/p&gt;
 */"/>
    <method name="public static void showText(com.trolltech.qt.core.QPoint pos, java.lang.String text)" doc="/**
&lt;p&gt;Equivalent to &lt;a href=&quot;QToolTip.html#showText(com.trolltech.qt.core.QPoint, java.lang.String, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;showText&lt;/tt&gt;&lt;/a&gt;(&lt;tt&gt;pos&lt;/tt&gt;, &lt;tt&gt;text&lt;/tt&gt;, 0). */"/>
</class>