QToolBar man page on aLinux

Man page or keyword search:  
man Server   7435 pages
apropos Keyword Search (all sections)
Output format
aLinux logo
[printable version]

QToolBar(3qt)							 QToolBar(3qt)

NAME
       QToolBar - Movable panel containing widgets such as tool buttons

SYNOPSIS
       #include <qtoolbar.h>

       Inherits QDockWindow.

   Public Members
       QToolBar ( const QString & label, QMainWindow *, ToolBarDock = DockTop,
	   bool newLine = FALSE, const char * name = 0 )  (obsolete)
       QToolBar ( const QString & label, QMainWindow * mainWindow, QWidget *
	   parent, bool newLine = FALSE, const char * name = 0, WFlags f = 0 )
       QToolBar ( QMainWindow * parent = 0, const char * name = 0 )
       void addSeparator ()
       QMainWindow * mainWindow () const
       virtual void setStretchableWidget ( QWidget * w )
       virtual void setLabel ( const QString & )
       QString label () const
       virtual void clear ()

   Properties
       QString label - the toolbar's label

DESCRIPTION
       The QToolBar class provides a movable panel containing widgets such as
       tool buttons.

       A toolbar is a panel that contains a set of controls, usually
       represented by small icons. It's purpose is to provide quick access to
       frequently used commands or options. Within a QMainWindow the user can
       drag toolbars within and between the dock areas. Toolbars can also be
       dragged out of any dock area to float freely as top-level windows.

       QToolBar is a specialization of QDockWindow, and so provides all the
       functionality of a QDockWindow.

       To use QToolBar you simply create a QToolBar as a child of a
       QMainWindow, create a number of QToolButton widgets (or other widgets)
       in left to right (or top to bottom) order and call addSeparator() when
       you want a separator. When a toolbar is floated the caption used is the
       label given in the constructor call. This can be changed with
       setLabel().

	       QToolBar * fileTools = new QToolBar( this, "file operations" );
	       fileTools->setLabel( "File Operations" );
	       fileOpenAction->addTo( fileTools );
	       fileSaveAction->addTo( fileTools );

       This extract from the application/application.cpp example shows the
       creation of a new toolbar as a child of a QMainWindow and adding two
       QActions.

       You may use most widgets within a toolbar, with QToolButton and
       QComboBox being the most common.

       If you create a new widget on an already visible QToolBar, this widget
       will automatically become visible without needing a show() call. (This
       differs from every other Qt widget container. We recommend calling
       show() anyway since we hope to fix this anomaly in a future release.)

       QToolBars, like QDockWindows, are located in QDockAreas or float as
       top-level windows. QMainWindow provides four QDockAreas (top, left,
       right and bottom). When you create a new toolbar (as in the example
       above) as a child of a QMainWindow the toolbar will be added to the top
       dock area. You can move it to another dock area (or float it) by
       calling QMainWindow::moveDockWindow(). QDock areas lay out their
       windows in Lines.

       If the main window is resized so that the area occupied by the toolbar
       is too small to show all its widgets a little arrow button (which looks
       like a right-pointing chevron, '»') will appear at the right or
       bottom of the toolbar depending on its orientation. Clicking this
       button pops up a menu that shows the 'overflowing' items. QToolButtons
       are represented in the menu using their textLabel property, other
       QButton subclasses are represented using their text property, and
       QComboBoxes are represented as submenus, with the caption text being
       used in the submenu item.

       Usually a toolbar will get precisely the space it needs. However, with
       setHorizontalStretchable(), setVerticalStretchable() or
       setStretchableWidget() you can tell the main window to expand the
       toolbar to fill all available space in the specified orientation.

       The toolbar arranges its buttons either horizontally or vertically (see
       orientation() for details). Generally, QDockArea will set the
       orientation correctly for you, but you can set it yourself with
       setOrientation() and track any changes by connecting to the
       orientationChanged() signal.

       You can use the clear() method to remove all items from a toolbar.

       <center>
				   [Image Omitted]

       </center> <blockquote><p align="center"> A floating QToolbar (dock
       window) </p> </blockquote>

       See also QToolButton, QMainWindow, Parts of Isys on Visual Design, GUI
       Design Handbook: Tool Bar, and Main Window and Related Classes.

MEMBER FUNCTION DOCUMENTATION
QToolBar::QToolBar ( const QString & label, QMainWindow *, ToolBarDock =
       DockTop, bool newLine = FALSE, const char * name = 0 )
       This function is obsolete. It is provided to keep old source working.
       We strongly advise against using it in new code.

QToolBar::QToolBar ( const QString & label, QMainWindow * mainWindow, QWidget
       * parent, bool newLine = FALSE, const char * name = 0, WFlags f = 0 )
       Constructs an empty horizontal toolbar.

       The toolbar is called name and is a child of parent and is managed by
       mainWindow. The label and newLine parameters are passed straight to
       QMainWindow::addDockWindow(). name and the widget flags f are passed on
       to the QDockWindow constructor.

       Use this constructor if you want to create torn-off (undocked,
       floating) toolbars or toolbars in the status bar.

QToolBar::QToolBar ( QMainWindow * parent = 0, const char * name = 0 )
       This is an overloaded member function, provided for convenience. It
       behaves essentially like the above function.

       Constructs an empty toolbar called name, with parent parent, in its
       parent's top dock area, without any label and without requiring a
       newline.

void QToolBar::addSeparator ()
       Adds a separator to the right/bottom of the toolbar.

       Examples:

void QToolBar::clear () [virtual]
       Deletes all the toolbar's child widgets.

QString QToolBar::label () const
       Returns the toolbar's label. See the "label" property for details.

QMainWindow * QToolBar::mainWindow () const
       Returns a pointer to the QMainWindow which manages this toolbar.

void QToolBar::setLabel ( const QString & ) [virtual]
       Sets the toolbar's label. See the "label" property for details.

void QToolBar::setStretchableWidget ( QWidget * w ) [virtual]
       Sets the widget w to be expanded if this toolbar is requested to
       stretch.

       The request to stretch might occur because QMainWindow right-justifies
       the dock area the toolbar is in, or because this toolbar's
       isVerticalStretchable() or isHorizontalStretchable() is set to TRUE.

       If you call this function and the toolbar is not yet stretchable,
       setStretchable() is called.

       See also QMainWindow::rightJustification, setVerticalStretchable(), and
       setHorizontalStretchable().

       Examples:

   Property Documentation
QString label
       This property holds the toolbar's label.

       If the toolbar is floated the label becomes the toolbar window's
       caption. There is no default label text.

       Set this property's value with setLabel() and get this property's value
       with label().

SEE ALSO
       http://doc.trolltech.com/qtoolbar.html
       http://www.trolltech.com/faq/tech.html

COPYRIGHT
       Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com.  See the
       license file included in the distribution for a complete license
       statement.

AUTHOR
       Generated automatically from the source code.

BUGS
       If you find a bug in Qt, please report it as described in
       http://doc.trolltech.com/bughowto.html.	Good bug reports help us to
       help you. Thank you.

       The definitive Qt documentation is provided in HTML format; it is
       located at $QTDIR/doc/html and can be read using Qt Assistant or with a
       web browser. This man page is provided as a convenience for those users
       who prefer man pages, although this format is not officially supported
       by Trolltech.

       If you find errors in this manual page, please report them to qt-
       bugs@trolltech.com.  Please include the name of the manual page
       (qtoolbar.3qt) and the Qt version (3.3.8).

Trolltech AS			2 February 2007			 QToolBar(3qt)
[top]

List of man pages available for aLinux

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net