~oif-team/ubuntu/natty/qt4-x11/xi2.1

<td width="1">  </td><td class="postheader" 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="top" width="230"><img src="images/trolltech-logo.png" align="right" width="203" height="32" border="0" /></td></tr></table><h1 align="center">Special-Purpose Global Functions Exported by Qt</h1>

<p>Qt provides a few low-level global functions for fine-tuning applications. Most of these perform very specific tasks and are platform-specific. In general, we recommend that you try using Qt's public API before resorting to using any functions mentioned here.</p>

<p>These functions are exported by <a href="qtcore.html#qtcore">QtCore</a> and <a href="qtgui.html#qtgui">QtGui</a>, but most of them aren't declared in Qt's header files. To use them in your application, you must declare them before calling them. For example:</p>

<pre>  #ifdef Q_WS_X11

void qt_x11_wait_for_window_manager(QWidget *widget);

#endif

int main(int argc, char *argv[])

{

QApplication app(argc, argv);

...

window.show();

#ifdef Q_WS_X11

qt_x11_wait_for_window_manager(&window);

#endif

...

return app.exec();

}</pre>

<p>These functions will remain as part of Qt for the lifetime of Qt 4.</p>

<p>Functions:</p>

<ul><li><a href="#void-qt-set-library-config-file-const-qstring-filename">void qt_set_library_config_file(const QString &<i>fileName</i>)</a></li>

<li><a href="#void-qt-set-sequence-auto-mnemonic-bool-enable">void qt_set_sequence_auto_mnemonic(bool <i>enable</i>)</a></li>

<li><a href="#hdc-qt-win-display-dc">HDC qt_win_display_dc()</a></li>

<li><a href="#void-qt-x11-set-fallback-font-family-int-script-const-qstring-family">void qt_x11_set_fallback_font_family(int <i>script</i>, const QString &<i>family</i>)</a></li>

<li><a href="#void-qt-x11-wait-for-window-manager-qwidget-widget">void qt_x11_wait_for_window_manager(QWidget *<i>widget</i>)</a></li>

<li><a href="#void-qt-mac-secure-keyboard-bool-enable">void qt_mac_secure_keyboard(bool <i>enable</i>)</a></li>

<li><a href="#void-qt-mac-set-dock-menu-qmenu-menu">void qt_mac_set_dock_menu(QMenu *<i>menu</i>)</a></li>

<li><a href="#void-qt-mac-set-menubar-icons-bool-enable">void qt_mac_set_menubar_icons(bool <i>enable</i>)</a></li>

<li><a href="#void-qt-mac-set-menubar-merge-bool-enable">void qt_mac_set_menubar_merge(bool <i>enable</i>)</a></li>

<li><a href="#void-qt-mac-set-native-menubar-bool-enable">void qt_mac_set_native_menubar(bool <i>enable</i>)</a></li>

<li><a href="#void-qt-mac-set-press-and-hold-context-bool-enable">void qt_mac_set_press_and_hold_context(bool <i>enable</i>)</a></li>

</ul>

<h2>void qt_set_library_config_file(const QString &<i>fileName</i>)</h2>

<p>Specifies the location of the Qt configuration file. You must call this function before constructing a <a href="qapplication.html">QApplication</a> or <a href="qcoreapplication.html">QCoreApplication</a> object. If no location is specified, Qt automatically finds an appropriate location.</p>

<h2>void qt_set_sequence_auto_mnemonic(bool <i>enable</i>)</h2>

<p>Specifies whether mnemonics for menu items, labels, etc., should be honored or not. On Windows and <a href="winsystem.html#x11">X11</a>, this feature is on by default; on Mac OS X, it is off. When this feature is off, the <a href="qkeysequence.html#mnemonic">QKeySequence::mnemonic</a>() function always returns an empty string.</p>

<h2>HDC qt_win_display_dc()</h2>

<p>Returns the Windows device context for the display. Use this at your own risks and perils.</p>

<h2>void qt_x11_set_fallback_font_family(int <i>script</i>, const QString &<i>family</i>)</h2>

<p>Sets the font family to be used for a given script as the fallback when the current font doesn't contain a character. The values for the <i>script</i> parameter are defined by the <tt>Script</tt> enum, located in <tt><private/qunicodetable_p.h></tt>.</p>

<h2>void qt_x11_wait_for_window_manager(QWidget *<i>widget</i>)</h2>

<p>Blocks until the <a href="winsystem.html#x11">X11</a> window manager has shown the widget after a call to <a href="qwidget.html#show">QWidget::show</a>().</p>

<h2>void qt_mac_secure_keyboard(bool <i>enable</i>)</h2>

<p>Turns the Mac OS X secure keyboard feature on or off. <a href="qlineedit.html">QLineEdit</a> uses this when the echo mode is <a href="qlineedit.html#EchoMode-enum">QLineEdit::Password</a> or <a href="qlineedit.html#EchoMode-enum">QLineEdit::NoEcho</a> to guard the editor against keyboard sniffing. If you implement your own password editor, you might want to turn on this feature in your editor's <a href="qwidget.html#focusInEvent">focusInEvent()</a> and turn it off in <a href="qwidget.html#focusOutEvent">focusOutEvent()</a>.</p>

<h2>void qt_mac_set_dock_menu(QMenu *<i>menu</i>)</h2>

<p>Sets the menu to display in the Mac OS X Dock for the application. This menu is shown when the user <b>Ctrl</b>-clicks on the application's icon while it is running.</p>

<h2>void qt_mac_set_menubar_icons(bool <i>enable</i>)</h2>

<p>Specifies whether icons associated to menu items for the application's menu bar should be shown on Mac OS X. By default, icons are shown on Mac OS X just like on the other platforms.</p>

<h2>void qt_mac_set_menubar_merge(bool <i>enable</i>)</h2>

<p>Specifies whether Qt should attempt to relocate standard menu items (such as <b>Quit</b>, <b>Preferences</b>, and <b>About</b>) to the application menu on Mac OS X. This feature is on by default. See <a href="mac-differences.html">Qt/Mac-Specific Issues</a> for the list of menu items for which this applies.</p>

<h2>void qt_mac_set_native_menubar(bool <i>enable</i>)</h2>

<p>Specifies whether the application should use the native menu bar on Mac OS X or be part of the main window. This feature is on by default.</p>

<h2>void qt_mac_set_press_and_hold_context(bool <i>enable</i>)</h2>

<p>Turns emulation of the right mouse button by clicking and holding the left mouse button on or off. This feature is off by default.</p>

<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>

</tr></table></div></address></body>

</html>

Older »