com.trolltech.qt.gui
Class QStyleOptionTabV3

java.lang.Object
  extended by com.trolltech.qt.internal.QSignalEmitterInternal
      extended by com.trolltech.qt.QSignalEmitter
          extended by com.trolltech.qt.QtJambiObject
              extended by com.trolltech.qt.gui.QStyleOption
                  extended by com.trolltech.qt.gui.QStyleOptionTab
                      extended by com.trolltech.qt.gui.QStyleOptionTabV2
                          extended by com.trolltech.qt.gui.QStyleOptionTabV3
All Implemented Interfaces:
QtJambiInterface, java.lang.Cloneable

public class QStyleOptionTabV3
extends QStyleOptionTabV2
implements java.lang.Cloneable

The QStyleOptionTabV3 class is used to describe the parameters necessary for drawing a tabs in Qt 4. or above. An instance of the QStyleOptionTabV3 class has typeSO_Tab and version 3. The type is used internally by QStyleOption, its subclasses, and qstyleoption_cast() to determine the type of style option. In general you do not need to worry about this unless you want to create your own QStyleOption subclass and your own styles. The version is used by QStyleOption subclasses to implement extensions without breaking compatibility. If you use qstyleoption_cast(), you normally do not need to check it.

If you create your own QStyle subclass, you should handle both QStyleOptionTab, QStyleOptionTabV2 and QStyleOptionTabV3. One way to achieve this is to use the QStyleOptionTabV3 copy constructor. For example:

        QStyleOptionTab tabOption = null;
        if ((tabOption = (QStyleOptionTab) option) != null) {
            QStyleOptionTabV2 tabV2 =
                    new QStyleOptionTabV2(tabOption);

            // draw the tab using tabV2
       }
    
In the example above: If tabOption's version is 1, the extra member (iconSize) will be set to an invalid size for tabV2. If tabOption's version is 2, the constructor will simply copy the tab's iconSize.

For an example demonstrating how style options can be used, see the Styles example.

See also:
QStyleOptionTab, and QStyleOption.


Nested Class Summary
static class QStyleOptionTabV3.StyleOptionVersion
          This enum is used to hold information about the version of the style option, and is defined for each QStyleOption subclass.
 
Nested classes/interfaces inherited from class com.trolltech.qt.gui.QStyleOptionTab
QStyleOptionTab.CornerWidget, QStyleOptionTab.CornerWidgets, QStyleOptionTab.SelectedPosition, QStyleOptionTab.StyleOptionType, QStyleOptionTab.TabPosition
 
Nested classes/interfaces inherited from class com.trolltech.qt.gui.QStyleOption
QStyleOption.OptionType
 
Nested classes/interfaces inherited from class com.trolltech.qt.QSignalEmitter
QSignalEmitter.AbstractSignal, QSignalEmitter.PrivateSignal0, QSignalEmitter.PrivateSignal1, QSignalEmitter.PrivateSignal2, QSignalEmitter.PrivateSignal3, QSignalEmitter.PrivateSignal4, QSignalEmitter.PrivateSignal5, QSignalEmitter.PrivateSignal6, QSignalEmitter.PrivateSignal7, QSignalEmitter.PrivateSignal8, QSignalEmitter.PrivateSignal9, QSignalEmitter.Signal0, QSignalEmitter.Signal1, QSignalEmitter.Signal2, QSignalEmitter.Signal3, QSignalEmitter.Signal4, QSignalEmitter.Signal5, QSignalEmitter.Signal6, QSignalEmitter.Signal7, QSignalEmitter.Signal8, QSignalEmitter.Signal9
 
Nested classes/interfaces inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
com.trolltech.qt.internal.QSignalEmitterInternal.AbstractSignalInternal
 
Field Summary
 
Fields inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
currentSender
 
Constructor Summary
QStyleOptionTabV3()
          Constructs a QStyleOptionTabV3.
QStyleOptionTabV3(QStyleOptionTab other)
          Constructs a QStyleOptionTabV3 copy of the other style option which can be either of the QStyleOptionTabV3, QStyleOptionTabV2 or QStyleOptionTab types.
QStyleOptionTabV3(QStyleOptionTabV2 other)
          Constructs a copy of the other style option.
QStyleOptionTabV3(QStyleOptionTabV3 other)
          Constructs a copy of the other style option.
 
Method Summary
 QStyleOptionTabV3 clone()
          This method is reimplemented for internal reasons
 boolean documentMode()
          This variable holds whether the tabbar is in document mode.
 QSize leftButtonSize()
          This variable holds the size for the left widget on the tab.
 QSize rightButtonSize()
          This variable holds the size for the right widget on the tab.
 void setDocumentMode(boolean documentMode)
          This variable holds whether the tabbar is in document mode.
 void setLeftButtonSize(QSize leftButtonSize)
          This variable holds the size for the left widget on the tab.
 void setRightButtonSize(QSize rightButtonSize)
          This variable holds the size for the right widget on the tab.
 
Methods inherited from class com.trolltech.qt.gui.QStyleOptionTabV2
iconSize, setIconSize
 
Methods inherited from class com.trolltech.qt.gui.QStyleOptionTab
cornerWidgets, icon, position, row, selectedPosition, setCornerWidgets, setCornerWidgets, setIcon, setPosition, setRow, setSelectedPosition, setShape, setText, shape, text
 
Methods inherited from class com.trolltech.qt.gui.QStyleOption
direction, fontMetrics, initFrom, palette, rect, setDirection, setFontMetrics, setPalette, setRect, setState, setState, setType, setVersion, state, type, version
 
Methods inherited from class com.trolltech.qt.QtJambiObject
dispose, disposed, equals, finalize, reassignNativeResources, tr, tr, tr
 
Methods inherited from class com.trolltech.qt.QSignalEmitter
blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread
 
Methods inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
__qt_signalInitialization
 
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.trolltech.qt.QtJambiInterface
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership
 

Constructor Detail

QStyleOptionTabV3

public QStyleOptionTabV3()
Constructs a QStyleOptionTabV3.


QStyleOptionTabV3

public QStyleOptionTabV3(QStyleOptionTab other)
Constructs a QStyleOptionTabV3 copy of the other style option which can be either of the QStyleOptionTabV3, QStyleOptionTabV2 or QStyleOptionTab types.

If the other style option's version is 1 or 2, the new style option's leftButtonSize and rightButtonSize is set to an invalid value. If its version is 3, its leftButtonSize and rightButtonSize values are simply copied to the new style option.


QStyleOptionTabV3

public QStyleOptionTabV3(QStyleOptionTabV2 other)
Constructs a copy of the other style option.


QStyleOptionTabV3

public QStyleOptionTabV3(QStyleOptionTabV3 other)
Constructs a copy of the other style option.

Method Detail

setDocumentMode

public final void setDocumentMode(boolean documentMode)
This variable holds whether the tabbar is in document mode. The default value is false;


documentMode

public final boolean documentMode()
This variable holds whether the tabbar is in document mode. The default value is false;


setRightButtonSize

public final void setRightButtonSize(QSize rightButtonSize)
This variable holds the size for the right widget on the tab. The default value is QSize(-1, -1), i.e. an invalid size;


rightButtonSize

public final QSize rightButtonSize()
This variable holds the size for the right widget on the tab. The default value is QSize(-1, -1), i.e. an invalid size;


setLeftButtonSize

public final void setLeftButtonSize(QSize leftButtonSize)
This variable holds the size for the left widget on the tab. The default value is QSize(-1, -1), i.e. an invalid size;


leftButtonSize

public final QSize leftButtonSize()
This variable holds the size for the left widget on the tab. The default value is QSize(-1, -1), i.e. an invalid size;


clone

public QStyleOptionTabV3 clone()
This method is reimplemented for internal reasons

Overrides:
clone in class QStyleOptionTabV2