org.kde.koala
Class KJanusWidget

java.lang.Object
  extended by org.kde.qt.Qt
      extended by org.kde.qt.QObject
          extended by org.kde.qt.QWidget
              extended by org.kde.koala.KJanusWidget
All Implemented Interfaces:
org.kde.qt.QPaintDeviceInterface, org.kde.qt.QtSupport

public class KJanusWidget
extends org.kde.qt.QWidget

Provides a number of ready to use layouts (faces). It is used as an internal widget in KDialogBase, but can also used as a widget of its own. This class provides KJanusWidget.TreeList, KJanusWidget.IconList, KJanusWidget.Tabbed, KJanusWidget.Plain and KJanusWidget.Swallow layouts. For all modes it is important that you specify the QWidget.minimumSize() on the page, plain widget or the swallowed widget. If you use a QLayout on the page, plain widget or the swallowed widget this will be taken care of automatically. The size is used when the KJanusWidget determines its own minimum size. You get the minimum size by using the minimumSizeHint() or sizeHint() methods. Pages that have been added in TreeList, IconList or Tabbed mode can be removed by simply deleting the page. However, it would be preferable to use the QObject.deleteLater() function on the page as the main event loop may have optimized UI update events of the page by scheduling them for later. See KJanusWidgetSignals for signals emitted by KJanusWidget

Author:
Espen Sand (espen@kde.org)

Field Summary
static int IconList
           
static int Plain
           
static int Swallow
           
static int Tabbed
           
static int TreeList
           
 
Fields inherited from class org.kde.qt.QWidget
AncestorOrigin, ClickFocus, NoFocus, ParentOrigin, StrongFocus, TabFocus, WheelFocus, WidgetOrigin, WindowOrigin
 
Fields inherited from class org.kde.qt.Qt
AlignAuto, AlignBottom, AlignCenter, AlignHCenter, AlignHorizontal_Mask, AlignJustify, AlignLeft, AlignRight, AlignTop, AlignVCenter, AlignVertical_Mask, AlphaDither_Mask, ALT, AltButton, AnchorHref, AnchorName, AndNotROP, AndROP, ArrowCursor, Ascending, ASCII_ACCEL, AutoColor, AutoDither, AutoText, AvoidDither, BDiagPattern, BeginsWith, BevelJoin, BitmapCursor, BlankCursor, Bottom, BottomLeft, BottomRight, BreakAnywhere, BusyCursor, CaseSensitive, ClearROP, ColorMode_Mask, ColorOnly, Contains, ControlButton, CopyROP, CrossCursor, CrossPattern, CTRL, CustomPattern, DashDotDotLine, DashDotLine, DashLine, Dense1Pattern, Dense2Pattern, Dense3Pattern, Dense4Pattern, Dense5Pattern, Dense6Pattern, Dense7Pattern, Descending, DiagCrossPattern, DiffuseAlphaDither, DiffuseDither, Dither_Mask, DitherMode_Mask, DockBottom, DockLeft, DockMinimized, DockRight, DockTop, DockTornOff, DockUnmanaged, DontClip, DontPrint, DotLine, DownArrow, EndsWith, EraseROP, ExactMatch, ExpandTabs, FDiagPattern, FixedColor, FixedPixmap, FlatCap, ForbiddenCursor, HiEnglishUnit, HiMetricUnit, Horizontal, HorPattern, IbeamCursor, Identical, IncludeTrailingSpaces, ISODate, Key_0, Key_1, Key_2, Key_3, Key_4, Key_5, Key_6, Key_7, Key_8, Key_9, Key_A, Key_aacute, Key_Aacute, Key_acircumflex, Key_Acircumflex, Key_acute, Key_adiaeresis, Key_Adiaeresis, Key_ae, Key_AE, Key_agrave, Key_Agrave, Key_Alt, Key_Ampersand, Key_Any, Key_Apostrophe, Key_aring, Key_Aring, Key_AsciiCircum, Key_AsciiTilde, Key_Asterisk, Key_At, Key_atilde, Key_Atilde, Key_B, Key_Back, Key_Backslash, Key_Backspace, Key_BackSpace, Key_Backtab, Key_BackTab, Key_Bar, Key_BassBoost, Key_BassDown, Key_BassUp, Key_BraceLeft, Key_BraceRight, Key_BracketLeft, Key_BracketRight, Key_brokenbar, Key_C, Key_CapsLock, Key_ccedilla, Key_Ccedilla, Key_cedilla, Key_cent, Key_Clear, Key_Colon, Key_Comma, Key_Control, Key_copyright, Key_currency, Key_D, Key_degree, Key_Delete, Key_diaeresis, Key_Direction_L, Key_Direction_R, Key_division, Key_Dollar, Key_Down, Key_E, Key_eacute, Key_Eacute, Key_ecircumflex, Key_Ecircumflex, Key_ediaeresis, Key_Ediaeresis, Key_egrave, Key_Egrave, Key_End, Key_Enter, Key_Equal, Key_Escape, Key_eth, Key_ETH, Key_Exclam, Key_exclamdown, Key_F, Key_F1, Key_F10, Key_F11, Key_F12, Key_F13, Key_F14, Key_F15, Key_F16, Key_F17, Key_F18, Key_F19, Key_F2, Key_F20, Key_F21, Key_F22, Key_F23, Key_F24, Key_F25, Key_F26, Key_F27, Key_F28, Key_F29, Key_F3, Key_F30, Key_F31, Key_F32, Key_F33, Key_F34, Key_F35, Key_F4, Key_F5, Key_F6, Key_F7, Key_F8, Key_F9, Key_Favorites, Key_Forward, Key_G, Key_Greater, Key_guillemotleft, Key_guillemotright, Key_H, Key_Help, Key_Home, Key_HomePage, Key_Hyper_L, Key_Hyper_R, Key_hyphen, Key_I, Key_iacute, Key_Iacute, Key_icircumflex, Key_Icircumflex, Key_idiaeresis, Key_Idiaeresis, Key_igrave, Key_Igrave, Key_Insert, Key_J, Key_K, Key_L, Key_Launch0, Key_Launch1, Key_Launch2, Key_Launch3, Key_Launch4, Key_Launch5, Key_Launch6, Key_Launch7, Key_Launch8, Key_Launch9, Key_LaunchA, Key_LaunchB, Key_LaunchC, Key_LaunchD, Key_LaunchE, Key_LaunchF, Key_LaunchMail, Key_LaunchMedia, Key_Left, Key_Less, Key_M, Key_macron, Key_masculine, Key_MediaLast, Key_MediaNext, Key_MediaPlay, Key_MediaPrev, Key_MediaRecord, Key_MediaStop, Key_Menu, Key_Meta, Key_Minus, Key_mu, Key_multiply, Key_N, Key_Next, Key_nobreakspace, Key_notsign, Key_ntilde, Key_Ntilde, Key_NumberSign, Key_NumLock, Key_O, Key_oacute, Key_Oacute, Key_ocircumflex, Key_Ocircumflex, Key_odiaeresis, Key_Odiaeresis, Key_ograve, Key_Ograve, Key_onehalf, Key_onequarter, Key_onesuperior, Key_Ooblique, Key_OpenUrl, Key_ordfeminine, Key_oslash, Key_otilde, Key_Otilde, Key_P, Key_PageDown, Key_PageUp, Key_paragraph, Key_ParenLeft, Key_ParenRight, Key_Pause, Key_Percent, Key_Period, Key_periodcentered, Key_Plus, Key_plusminus, Key_Print, Key_Prior, Key_Q, Key_Question, Key_questiondown, Key_QuoteDbl, Key_QuoteLeft, Key_R, Key_Refresh, Key_registered, Key_Return, Key_Right, Key_S, Key_ScrollLock, Key_Search, Key_section, Key_Semicolon, Key_Shift, Key_Slash, Key_Space, Key_ssharp, Key_Standby, Key_sterling, Key_Stop, Key_Super_L, Key_Super_R, Key_SysReq, Key_T, Key_Tab, Key_thorn, Key_THORN, Key_threequarters, Key_threesuperior, Key_TrebleDown, Key_TrebleUp, Key_twosuperior, Key_U, Key_uacute, Key_Uacute, Key_ucircumflex, Key_Ucircumflex, Key_udiaeresis, Key_Udiaeresis, Key_ugrave, Key_Ugrave, Key_Underscore, Key_unknown, Key_Up, Key_V, Key_VolumeDown, Key_VolumeMute, Key_VolumeUp, Key_W, Key_X, Key_Y, Key_yacute, Key_Yacute, Key_ydiaeresis, Key_yen, Key_Z, KeyButtonMask, Keypad, LastCursor, LastROP, Left, LeftArrow, LeftButton, LocalDate, LocalTime, LoEnglishUnit, LogText, LoMetricUnit, MacStyle, META, MetaButton, MidButton, Minimized, MiterJoin, MODIFIER_MASK, MonoOnly, MotifStyle, MouseButtonMask, MPenCapStyle, MPenJoinStyle, MPenStyle, MV_10_DOT_0, MV_10_DOT_1, MV_10_DOT_2, MV_10_DOT_3, MV_10_DOT_4, MV_9, MV_CHEETAH, MV_JAGUAR, MV_PANTHER, MV_PUMA, MV_TIGER, MV_Unknown, NandROP, NoAccel, NoAlpha, NoBackground, NoBrush, NoButton, NoMatch, NoPen, NopROP, NorROP, NotAndROP, NotCopyROP, NotEraseROP, NotOrROP, NotROP, NotXorROP, OpaqueMode, OrderedAlphaDither, OrderedDither, OrNotROP, OrROP, Overline, PaletteBackground, PaletteBase, PaletteBrightText, PaletteButton, PaletteButtonText, PaletteDark, PaletteForeground, PaletteHighlight, PaletteHighlightedText, PaletteLight, PaletteLink, PaletteLinkVisited, PaletteMid, PaletteMidlight, PaletteShadow, PaletteText, PartialMatch, PixelUnit, PlainText, PMStyle, PointingHandCursor, PreferDither, RichText, Right, RightArrow, RightButton, RoundCap, RoundJoin, SetROP, SHIFT, ShiftButton, ShowPrefix, SingleLine, SizeAllCursor, SizeBDiagCursor, SizeFDiagCursor, SizeHorCursor, SizeVerCursor, SolidLine, SolidPattern, SplitHCursor, SplitVCursor, SquareCap, StrikeOut, TextDate, ThresholdAlphaDither, ThresholdDither, Top, TopLeft, TopRight, TornOff, TransparentMode, TwipsUnit, UI_AnimateCombo, UI_AnimateMenu, UI_AnimateToolBox, UI_AnimateTooltip, UI_FadeMenu, UI_FadeTooltip, UI_General, Underline, UNICODE_ACCEL, Unmanaged, UpArrow, UpArrowCursor, UTC, VerPattern, Vertical, WaitCursor, WDestructiveClose, WGroupLeader, WhatsThisCursor, Win3Style, WindowActive, WindowFullScreen, WindowMaximized, WindowMinimized, WindowNoState, WindowsStyle, WMacDrawer, WMacNoSheet, WMouseNoMask, WNoAutoErase, WNoMousePropagation, WNorthWestGravity, WordBreak, WPaintClever, WPaintDesktop, WPaintUnclipped, WRepaintNoErase, WResizeNoErase, WShowModal, WState_AutoMask, WState_BlockUpdates, WState_CompressKeys, WState_ConfigPending, WState_Created, WState_CreatedHidden, WState_Disabled, WState_DND, WState_Exposed, WState_ForceDisabled, WState_ForceHide, WState_FullScreen, WState_HasMouse, WState_InPaintEvent, WState_Maximized, WState_Minimized, WState_MouseTracking, WState_OwnCursor, WState_OwnSizePolicy, WState_Polished, WState_Reparented, WState_Reserved0, WState_Resized, WState_Visible, WStaticContents, WStyle_ContextHelp, WStyle_Customize, WStyle_Dialog, WStyle_DialogBorder, WStyle_Mask, WStyle_Maximize, WStyle_Minimize, WStyle_MinMax, WStyle_NoBorder, WStyle_NoBorderEx, WStyle_NormalBorder, WStyle_Reserved, WStyle_Splash, WStyle_StaysOnTop, WStyle_SysMenu, WStyle_Title, WStyle_Tool, WSubWindow, WType_Desktop, WType_Dialog, WType_Mask, WType_Modal, WType_Popup, WType_TopLevel, WV_2000, WV_2003, WV_32s, WV_95, WV_98, WV_CE, WV_CE_based, WV_CENET, WV_DOS_based, WV_Me, WV_NT, WV_NT_based, WV_XP, WWinOwnDC, WX11BypassWM, X11ParentRelative, XorROP
 
Constructor Summary
  KJanusWidget()
           
protected KJanusWidget(java.lang.Class dummy)
           
  KJanusWidget(org.kde.qt.QWidget parent)
           
  KJanusWidget(org.kde.qt.QWidget parent, java.lang.String name)
           
  KJanusWidget(org.kde.qt.QWidget parent, java.lang.String name, int face)
          Constructor where you specify the face.
 
Method Summary
 int activePageIndex()
          Returns the index of the page that are currently displayed.
 void addButtonBelowList(KGuiItem guiitem, org.kde.qt.QObject recv, java.lang.String slot)
          The same as the above function, but with a KGuiItem providing the text and icon for the button at the bottom of the TreeList/IconList.
 void addButtonBelowList(java.lang.String text, org.kde.qt.QObject recv, java.lang.String slot)
          Add a button at the bottom of the TreeList/IconList.
 org.kde.qt.QGrid addGridPage(int n, int dir, java.lang.String itemName)
           
 org.kde.qt.QGrid addGridPage(int n, int dir, java.lang.String[] items)
           
 org.kde.qt.QGrid addGridPage(int n, int dir, java.lang.String[] items, java.lang.String header)
           
 org.kde.qt.QGrid addGridPage(int n, int dir, java.lang.String[] items, java.lang.String header, org.kde.qt.QPixmap pixmap)
          This is like addGridPage just above, with the difference that the first element is a list of strings.
 org.kde.qt.QGrid addGridPage(int n, int dir, java.lang.String itemName, java.lang.String header)
           
 org.kde.qt.QGrid addGridPage(int n, int dir, java.lang.String itemName, java.lang.String header, org.kde.qt.QPixmap pixmap)
          Add a new page when the class is used in either TreeList or Tabbed mode.
 org.kde.qt.QHBox addHBoxPage(java.lang.String itemName)
           
 org.kde.qt.QHBox addHBoxPage(java.lang.String[] items)
           
 org.kde.qt.QHBox addHBoxPage(java.lang.String[] items, java.lang.String header)
           
 org.kde.qt.QHBox addHBoxPage(java.lang.String[] items, java.lang.String header, org.kde.qt.QPixmap pixmap)
          This is like addHBoxPage just above, with the difference that the first element is a list of strings.
 org.kde.qt.QHBox addHBoxPage(java.lang.String itemName, java.lang.String header)
           
 org.kde.qt.QHBox addHBoxPage(java.lang.String itemName, java.lang.String header, org.kde.qt.QPixmap pixmap)
          Add a new page when the class is used in TreeList, IconList or Tabbed mode.
 org.kde.qt.QFrame addPage(java.lang.String item)
           
 org.kde.qt.QFrame addPage(java.lang.String[] items)
           
 org.kde.qt.QFrame addPage(java.lang.String[] items, java.lang.String header)
           
 org.kde.qt.QFrame addPage(java.lang.String[] items, java.lang.String header, org.kde.qt.QPixmap pixmap)
          This is like addPage just above, with the difference that the first element is a list of strings.
 org.kde.qt.QFrame addPage(java.lang.String item, java.lang.String header)
           
 org.kde.qt.QFrame addPage(java.lang.String item, java.lang.String header, org.kde.qt.QPixmap pixmap)
          Add a new page when the class is used in TreeList, IconList or Tabbed mode.
protected  void addPageWidget(org.kde.qt.QFrame page, java.lang.String[] items, java.lang.String header, org.kde.qt.QPixmap pixmap)
           
 org.kde.qt.QVBox addVBoxPage(java.lang.String item)
           
 org.kde.qt.QVBox addVBoxPage(java.lang.String[] items)
           
 org.kde.qt.QVBox addVBoxPage(java.lang.String[] items, java.lang.String header)
           
 org.kde.qt.QVBox addVBoxPage(java.lang.String[] items, java.lang.String header, org.kde.qt.QPixmap pixmap)
          This is like addVBoxPage just above, with the difference that the first element is a list of strings.
 org.kde.qt.QVBox addVBoxPage(java.lang.String item, java.lang.String header)
           
 org.kde.qt.QVBox addVBoxPage(java.lang.String item, java.lang.String header, org.kde.qt.QPixmap pixmap)
          Add a new page when the class is used in TreeList, IconList or Tabbed mode.
 void addWidgetBelowList(org.kde.qt.QWidget widget)
          Add a widget at the bottom of the TreeList/IconList.
 java.lang.String className()
           
 void dispose()
          Delete the wrapped C++ instance ahead of finalize()
 boolean eventFilter(org.kde.qt.QObject o, org.kde.qt.QEvent e)
          This function is used internally when in IconList mode.
 int face()
          Returns the face type.
protected  void finalize()
          Deletes the wrapped C++ instance
protected  org.kde.qt.QWidget FindParent()
           
protected  void InsertTreeListItem(java.lang.String[] items, org.kde.qt.QPixmap pixmap, org.kde.qt.QFrame page)
           
 boolean isDisposed()
          Has the wrapped C++ instance been deleted?
 boolean isValid()
          Use this to verify that no memory allocation failed.
 org.kde.qt.QMetaObject metaObject()
           
 org.kde.qt.QSize minimumSizeHint()
          Returns the minimum size that must be made available for the widget so that UIs can be displayed properly
 int pageIndex(org.kde.qt.QWidget widget)
          Returns the index of a page created with addPage , addVBoxPage , addHBoxPage or addGridPage .
 java.lang.String pageTitle(int index)
          Returns the title string associated with a page index in TreeList or IconList mode.
 org.kde.qt.QWidget pageWidget(int index)
          Returns the page widget associated with a page index or null if there is no such page.
 org.kde.qt.QFrame plainPage()
          Returns the empty widget that is available in Plain mode.
 void removePage(org.kde.qt.QWidget page)
           
 void setFocus()
          Give the keyboard input focus to the widget.
 void setFolderIcon(java.lang.String[] path, org.kde.qt.QPixmap pixmap)
          Sets the icon used in TreeList Mode for the given path.
 void setIconListAllVisible(boolean state)
          This function has only effect in IconList mode.
 void setRootIsDecorated(boolean state)
          This function has only effect in TreeList mode.
 void setShowIconsInTreeList(boolean state)
          This function has only effect in TreeList mode.
 boolean setSwallowedWidget(org.kde.qt.QWidget widget)
          Defines the widget to be swallowed.
 void setTreeListAutoResize(boolean state)
          This function has only effect in TreeList mode.
 void showEvent(org.kde.qt.QShowEvent arg1)
          Reimplemented to handle the splitter width when the the face is TreeList
 boolean showPage(int index)
          Raises the page which was added by addPage().
protected  boolean showPage(org.kde.qt.QWidget w)
           
 org.kde.qt.QSize sizeHint()
          Returns the recommended size for the widget in order to be displayed properly.
 void unfoldTreeList()
           
 void unfoldTreeList(boolean persist)
          This function has only effect in TreeList mode.
 
Methods inherited from class org.kde.qt.QWidget
acceptDrops, adjustSize, autoMask, backgroundBrush, backgroundColor, backgroundMode, backgroundOffset, backgroundOrigin, backgroundPixmap, baseSize, caption, childAt, childAt, childAt, childAt, childrenRect, childrenRegion, clearFocus, clearMask, clearWFlags, clearWState, clipRegion, close, close, closeEvent, colorGroup, constPolish, contextMenuEvent, create, create, create, create, cursor, customWhatsThis, destroy, destroy, destroy, devType, dragEnterEvent, dragLeaveEvent, dragMoveEvent, drawText, drawText, dropEvent, enabledChange, enterEvent, erase, erase, erase, erase, eraseColor, erasePixmap, event, find, focusData, focusInEvent, focusNextPrevChild, focusOutEvent, focusPolicy, focusProxy, focusWidget, font, fontChange, fontInf, fontInfo, fontMet, fontMet, fontMet, fontMetrics, foregroundColor, frameGeometry, frameSize, geometry, getWFlags, getWState, grabKeyboard, grabMouse, grabMouse, hasFocus, hasMouse, hasMouseTracking, height, heightForWidth, hide, hideEvent, icon, iconify, iconText, imComposeEvent, imEndEvent, imStartEvent, isActiveWindow, isDesktop, isDialog, isEnabled, isEnabledTo, isEnabledToTLW, isExtDev, isFocusEnabled, isFullScreen, isHidden, isInputMethodEnabled, isMaximized, isMinimized, isModal, isPopup, isShown, isTopLevel, isUpdatesEnabled, isVisible, isVisibleTo, isVisibleToTLW, keyboardGrabber, keyPressEvent, keyReleaseEvent, layout, leaveEvent, lower, mapFrom, mapFromGlobal, mapFromParent, mapTo, mapToGlobal, mapToParent, maximumHeight, maximumSize, maximumWidth, metric, microFocusHint, minimumHeight, minimumSize, minimumWidth, mouseDoubleClickEvent, mouseGrabber, mouseMoveEvent, mousePressEvent, mouseReleaseEvent, move, move, moveEvent, ownCursor, ownFont, ownPalette, paintDevice, paintEvent, paintingActive, palette, paletteBackgroundColor, paletteBackgroundPixmap, paletteChange, paletteForegroundColor, parentWidget, parentWidget, polish, pos, raise, recreate, recreate, rect, releaseKeyboard, releaseMouse, repaint, repaint, repaint, repaint, repaint, repaint, repaint, repaint, reparent, reparent, reparent, reparent, resetInputContext, resize, resize, resizeEvent, resolution, scroll, scroll, setAcceptDrops, setActiveWindow, setAutoMask, setBackgroundColor, setBackgroundMode, setBackgroundMode, setBackgroundOrigin, setBackgroundPixmap, setBaseSize, setBaseSize, setCaption, setCursor, setDisabled, setEnabled, setEraseColor, setErasePixmap, setFixedHeight, setFixedSize, setFixedSize, setFixedWidth, setFocusPolicy, setFocusProxy, setFont, setFont, setGeometry, setGeometry, setHidden, setIcon, setIconText, setInputMethodEnabled, setKeyCompression, setMask, setMask, setMaximumHeight, setMaximumSize, setMaximumSize, setMaximumWidth, setMicroFocusHint, setMicroFocusHint, setMicroFocusHint, setMinimumHeight, setMinimumSize, setMinimumSize, setMinimumWidth, setMouseTracking, setName, setPalette, setPalette, setPaletteBackgroundColor, setPaletteBackgroundPixmap, setPaletteForegroundColor, setResolution, setShown, setSizeIncrement, setSizeIncrement, setSizePolicy, setSizePolicy, setSizePolicy, setStyle, setStyle, setTabOrder, setUpdatesEnabled, setWFlags, setWindowOpacity, setWindowState, setWState, show, showFullScreen, showMaximized, showMinimized, showNormal, size, sizeIncrement, sizePolicy, stackUnder, style, styleChange, tabletEvent, testWFlags, testWState, topLevelWidget, tr, tr, unsetCursor, unsetFont, unsetPalette, update, update, update, updateGeometry, updateMask, visibleRect, wheelEvent, width, windowActivationChange, windowOpacity, windowState, winId, x, y
 
Methods inherited from class org.kde.qt.QObject
activate_filters, activate_signal_bool, activate_signal, activate_signal, activate_signal, activate_signal, blockSignals, checkConnectArgs, child, child, child, childEvent, children, connect, connect, connectInternal, connectNotify, customEvent, deleteLater, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnectInternal, disconnectNotify, dumpObjectInfo, dumpObjectTree, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, emit, highPriority, i18n, inherits, insertChild, installEventFilter, isA, isWidgetType, killTimer, killTimers, name, name, normalizeSignalSlot, objectTrees, parent, property, queryList, queryList, queryList, queryList, queryList, registerUserData, removeChild, removeEventFilter, sender, setProperty, signalsBlocked, startTimer, timerEvent
 
Methods inherited from class org.kde.qt.Qt
arrowCursor, bin, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, bitBlt, black, blankCursor, blue, color0, color1, copyBlt, copyBlt, copyBlt, copyBlt, copyBlt, crossCursor, cyan, darkBlue, darkCyan, darkGray, darkGreen, darkMagenta, darkRed, darkYellow, dec, dynamicCast, endl, flush, forbiddenCursor, fromUtf8, gray, green, hex, ibeamCursor, lightGray, magenta, oct, op_div, op_div, op_div, op_div, op_equals, op_equals, op_equals, op_equals, op_minus, op_minus, op_minus, op_mult, op_mult, op_mult, op_mult, op_mult, op_mult, op_mult, op_mult, op_mult, op_not_equals, op_not_equals, op_not_equals, op_not_equals, op_plus, op_plus, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_read, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, op_write, pointingHandCursor, qAlpha, qApp, qAppName, qBlue, qCompress, qCompress, qDebug, qDebug, qDrawArrow, qDrawItem, qDrawItem, qDrawItem, qDrawPlainRect, qDrawPlainRect, qDrawPlainRect, qDrawPlainRect, qDrawPlainRect, qDrawPlainRect, qDrawShadeLine, qDrawShadeLine, qDrawShadeLine, qDrawShadeLine, qDrawShadeLine, qDrawShadeLine, qDrawShadeLine, qDrawShadeLine, qDrawShadePanel, qDrawShadePanel, qDrawShadePanel, qDrawShadePanel, qDrawShadePanel, qDrawShadePanel, qDrawShadePanel, qDrawShadePanel, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawShadeRect, qDrawWinButton, qDrawWinButton, qDrawWinButton, qDrawWinButton, qDrawWinButton, qDrawWinButton, qDrawWinPanel, qDrawWinPanel, qDrawWinPanel, qDrawWinPanel, qDrawWinPanel, qDrawWinPanel, qFatal, qFatal, qGLVersion, qGray, qGray, qGreen, qInitNetworkProtocols, qInstallPath, qInstallPathBins, qInstallPathData, qInstallPathDocs, qInstallPathHeaders, qInstallPathLibs, qInstallPathPlugins, qInstallPathSysconf, qInstallPathTranslations, qItemRect, qItemRect, qObsolete, qObsolete, qObsolete, qRed, qRgb, qRgba, qRound, qSharedBuild, qSuppressObsoleteWarnings, qSuppressObsoleteWarnings, qSysInfo, qSystemWarning, qSystemWarning, qUncompress, qUncompress, qVersion, qWarning, qWarning, red, reset, SIGNAL, sizeAllCursor, sizeBDiagCursor, sizeFDiagCursor, sizeHorCursor, sizeVerCursor, SLOT, splitHCursor, splitVCursor, upArrowCursor, waitCursor, whatsThisCursor, white, ws, yellow
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

TreeList

public static final int TreeList
See Also:
Constant Field Values

Tabbed

public static final int Tabbed
See Also:
Constant Field Values

Plain

public static final int Plain
See Also:
Constant Field Values

Swallow

public static final int Swallow
See Also:
Constant Field Values

IconList

public static final int IconList
See Also:
Constant Field Values
Constructor Detail

KJanusWidget

protected KJanusWidget(java.lang.Class dummy)

KJanusWidget

public KJanusWidget(org.kde.qt.QWidget parent,
                    java.lang.String name,
                    int face)
Constructor where you specify the face.

Parameters:
parent - Parent of the widget.
name - Widget name.
face - The kind of dialog, Use TreeList, Tabbed, Plain or Swallow.

KJanusWidget

public KJanusWidget(org.kde.qt.QWidget parent,
                    java.lang.String name)

KJanusWidget

public KJanusWidget(org.kde.qt.QWidget parent)

KJanusWidget

public KJanusWidget()
Method Detail

metaObject

public org.kde.qt.QMetaObject metaObject()
Overrides:
metaObject in class org.kde.qt.QWidget

className

public java.lang.String className()
Overrides:
className in class org.kde.qt.QWidget

showPage

public boolean showPage(int index)
Raises the page which was added by addPage().

Parameters:
index - The index of the page you want to raise.

activePageIndex

public int activePageIndex()
Returns the index of the page that are currently displayed.

Returns:
The index or -1 if the face is not Tabbed, TreeList or IconList.

isValid

public boolean isValid()
Use this to verify that no memory allocation failed.

Returns:
true if the widget was properly created.

face

public int face()
Returns the face type.

Returns:
The face type.

minimumSizeHint

public org.kde.qt.QSize minimumSizeHint()
Returns the minimum size that must be made available for the widget so that UIs can be displayed properly

Overrides:
minimumSizeHint in class org.kde.qt.QWidget
Returns:
The minimum size.

sizeHint

public org.kde.qt.QSize sizeHint()
Returns the recommended size for the widget in order to be displayed properly.

Overrides:
sizeHint in class org.kde.qt.QWidget
Returns:
The recommended size.

plainPage

public org.kde.qt.QFrame plainPage()
Returns the empty widget that is available in Plain mode.

Returns:
The widget or 0 if the face in not Plain.

addPage

public org.kde.qt.QFrame addPage(java.lang.String item,
                                 java.lang.String header,
                                 org.kde.qt.QPixmap pixmap)
Add a new page when the class is used in TreeList, IconList or Tabbed mode. The returned widget is empty and you must add your widgets as children to this widget. In most cases you must create a layout manager and associate it with this widget as well. Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later.

Parameters:
item - String used in the list or Tab item.
header - A longer string used in TreeList and IconList mode to describe the contents of a page. If empty, the item string will be used instead.
pixmap - Used in IconList mode or in TreeList mode. You should prefer a pixmap with size 32x32 pixels.
Returns:
The empty page or 0 if the face is not TreeList, IconList or Tabbed.

addPage

public org.kde.qt.QFrame addPage(java.lang.String item,
                                 java.lang.String header)

addPage

public org.kde.qt.QFrame addPage(java.lang.String item)

addPage

public org.kde.qt.QFrame addPage(java.lang.String[] items,
                                 java.lang.String header,
                                 org.kde.qt.QPixmap pixmap)
This is like addPage just above, with the difference that the first element is a list of strings. These strings are used to form a path of folders down to the given page. The initial elements are names for the folders, while the last element is the name of the page. Note: This does yet only work for the TreeList face. Later this may be added for the IconList face too. In other faces than the TreeList, all the strings except the last one is ignored. Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later. Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later.


addPage

public org.kde.qt.QFrame addPage(java.lang.String[] items,
                                 java.lang.String header)

addPage

public org.kde.qt.QFrame addPage(java.lang.String[] items)

addVBoxPage

public org.kde.qt.QVBox addVBoxPage(java.lang.String item,
                                    java.lang.String header,
                                    org.kde.qt.QPixmap pixmap)
Add a new page when the class is used in TreeList, IconList or Tabbed mode. The returned widget is empty and you must add your widgets as children to this widget. The returned widget is a QVBox so it contains a QVBoxLayout layout that lines up the child widgets are vertically. Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later.

Parameters:
item - String used in the list or Tab item.
header - A longer string used in TreeList and IconList mode to describe the contents of a page. If empty, the item string will be used instead.
pixmap - Used in IconList mode or in TreeList mode. You should prefer a pixmap with size 32x32 pixels.
Returns:
The empty page or 0 if the face is not TreeList, IconList or Tabbed.

addVBoxPage

public org.kde.qt.QVBox addVBoxPage(java.lang.String item,
                                    java.lang.String header)

addVBoxPage

public org.kde.qt.QVBox addVBoxPage(java.lang.String item)

addVBoxPage

public org.kde.qt.QVBox addVBoxPage(java.lang.String[] items,
                                    java.lang.String header,
                                    org.kde.qt.QPixmap pixmap)
This is like addVBoxPage just above, with the difference that the first element is a list of strings. These strings are used to form a path of folders down to the given page. The initial elements are names for the folders, while the last element is the name of the page. Note: This does yet only work for the TreeList face. Later this may be added for the IconList face too. In other faces than the TreeList, all the strings except the last one is ignored. Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later.


addVBoxPage

public org.kde.qt.QVBox addVBoxPage(java.lang.String[] items,
                                    java.lang.String header)

addVBoxPage

public org.kde.qt.QVBox addVBoxPage(java.lang.String[] items)

addHBoxPage

public org.kde.qt.QHBox addHBoxPage(java.lang.String itemName,
                                    java.lang.String header,
                                    org.kde.qt.QPixmap pixmap)
Add a new page when the class is used in TreeList, IconList or Tabbed mode. The returned widget is empty and you must add your widgets as children to this widget. The returned widget is a QHBox so it contains a QHBoxLayout layout that lines up the child widgets are horizontally. Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later.

Parameters:
itemName - String used in the list or Tab item.
header - A longer string used in TreeList and IconList mode to describe the contents of a page. If empty, the item string will be used instead.
pixmap - Used in IconList mode or in TreeList mode. You should prefer a pixmap with size 32x32 pixels.
Returns:
The empty page or 0 if the face is not TreeList, IconList or Tabbed.

addHBoxPage

public org.kde.qt.QHBox addHBoxPage(java.lang.String itemName,
                                    java.lang.String header)

addHBoxPage

public org.kde.qt.QHBox addHBoxPage(java.lang.String itemName)

addHBoxPage

public org.kde.qt.QHBox addHBoxPage(java.lang.String[] items,
                                    java.lang.String header,
                                    org.kde.qt.QPixmap pixmap)
This is like addHBoxPage just above, with the difference that the first element is a list of strings. These strings are used to form a path of folders down to the given page. The initial elements are names for the folders, while the last element is the name of the page. Note: This does yet only work for the TreeList face. Later this may be added for the IconList face too. In other faces than the TreeList, all the strings except the last one is ignored. Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later.


addHBoxPage

public org.kde.qt.QHBox addHBoxPage(java.lang.String[] items,
                                    java.lang.String header)

addHBoxPage

public org.kde.qt.QHBox addHBoxPage(java.lang.String[] items)

addGridPage

public org.kde.qt.QGrid addGridPage(int n,
                                    int dir,
                                    java.lang.String itemName,
                                    java.lang.String header,
                                    org.kde.qt.QPixmap pixmap)
Add a new page when the class is used in either TreeList or Tabbed mode. The returned widget is empty and you must add your widgets as children to this widget. The returned widget is a QGrid so it contains a QGridLayout layout that places up the child widgets in a grid. Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later.

Parameters:
n - Specifies the number of columns if 'dir' is QGrid.Horizontal or the number of rows if 'dir' is QGrid.Vertical.
dir - Can be QGrid.Horizontal or QGrid.Vertical.
itemName - String used in the list or Tab item.
header - A longer string used in TreeList and IconList mode to describe the contents of a page. If empty, the item string will be used instead.
pixmap - Used in IconList mode or in TreeList mode. You should prefer a pixmap with size 32x32 pixels.
Returns:
The empty page or 0 if the face is not TreeList, IconList or Tabbed.

addGridPage

public org.kde.qt.QGrid addGridPage(int n,
                                    int dir,
                                    java.lang.String itemName,
                                    java.lang.String header)

addGridPage

public org.kde.qt.QGrid addGridPage(int n,
                                    int dir,
                                    java.lang.String itemName)

addGridPage

public org.kde.qt.QGrid addGridPage(int n,
                                    int dir,
                                    java.lang.String[] items,
                                    java.lang.String header,
                                    org.kde.qt.QPixmap pixmap)
This is like addGridPage just above, with the difference that the first element is a list of strings. These strings are used to form a path of folders down to the given page. The initial elements are names for the folders, while the last element is the name of the page. Note: This does yet only work for the TreeList face. Later this may be added for the IconList face too. In other faces than the TreeList, all the strings except the last one is ignored. Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later.


addGridPage

public org.kde.qt.QGrid addGridPage(int n,
                                    int dir,
                                    java.lang.String[] items,
                                    java.lang.String header)

addGridPage

public org.kde.qt.QGrid addGridPage(int n,
                                    int dir,
                                    java.lang.String[] items)

removePage

public void removePage(org.kde.qt.QWidget page)
Parameters:
page - The widget returned by addPage , addVBoxPage , addHBoxPage or addGridPage .

pageIndex

public int pageIndex(org.kde.qt.QWidget widget)
Returns the index of a page created with addPage , addVBoxPage , addHBoxPage or addGridPage . You can can compare this index with the value returned from activePageIndex if you need to do some page specific actions in your code. The returned index will never change so you can safely use this function once and save the value.

Parameters:
widget - The widget returned by addPage , addVBoxPage , addHBoxPage or addGridPage .
Returns:
The index or -1 if the face is not Tabbed, TreeList or IconList

setSwallowedWidget

public boolean setSwallowedWidget(org.kde.qt.QWidget widget)
Defines the widget to be swallowed. This method can be used several times. Only the latest defined widget will be shown.

Parameters:
widget - The widget to be swallowed. If 0, then an empty rectangle is displayed.

setTreeListAutoResize

public void setTreeListAutoResize(boolean state)
This function has only effect in TreeList mode. Defines how the tree list is resized when the widget is resized horizontally. By default the tree list keeps its width when the widget becomes wider.

Parameters:
state - The resize mode. If false (default) the TreeList keeps its current width when the widget becomes wider.

setShowIconsInTreeList

public void setShowIconsInTreeList(boolean state)
This function has only effect in TreeList mode. This tells the widgets whether the icons given in the addPage, addVBoxPage, addHBoxPage, or addGridPage methods should be shown in the TreeList. Note: This method must be called before calling any of the methods which add icons to the page.

Parameters:
state - If true the icons are shown.

setRootIsDecorated

public void setRootIsDecorated(boolean state)
This function has only effect in TreeList mode. This tells the widgets whether the root should be decorated. For details see QListView.setRootIsDecorated

Parameters:
state - Root will be decorated if true.

unfoldTreeList

public void unfoldTreeList(boolean persist)
This function has only effect in TreeList mode. This tells the TreeList to unfold the whole tree so that all entries are visible. If the list is empty when you call this method newly created entries will not automatically be opened. If the persist flag is set opened entries cannot be closed again, though.

Parameters:
persist - If true the tree always stays unfolded.

unfoldTreeList

public void unfoldTreeList()

addWidgetBelowList

public void addWidgetBelowList(org.kde.qt.QWidget widget)
Add a widget at the bottom of the TreeList/IconList.

Parameters:
widget - The widget to be added. It will be reparented into the KJanusWidget, therefor it will be deleted with the KJanusWidget, too. To be on the save side just don't keep the pointer to this widget.

addButtonBelowList

public void addButtonBelowList(java.lang.String text,
                               org.kde.qt.QObject recv,
                               java.lang.String slot)
Add a button at the bottom of the TreeList/IconList.

Parameters:
text - The text on the PushButton.
recv - The object that is to receive the signal when the button is clicked.
slot - The slot to connect to the clicked signal of the button.

addButtonBelowList

public void addButtonBelowList(KGuiItem guiitem,
                               org.kde.qt.QObject recv,
                               java.lang.String slot)
The same as the above function, but with a KGuiItem providing the text and icon for the button at the bottom of the TreeList/IconList.

Parameters:
guiitem - The text and icon on the PushButton.
recv - The object that is to receive the signal when the button is clicked.
slot - The slot to connect to the clicked signal of the button.

setIconListAllVisible

public void setIconListAllVisible(boolean state)
This function has only effect in IconList mode. Defines how the icon list widget is displayed. By default it is the widgets in the pages that decide the minimum height of the toplevel widget. A vertical scrollbar can be used in the icon list area.

Parameters:
state - The visibility mode. If true, the minimum height is adjusted so that every icon in the list is visible at the same time. The vertical scrollbar will never be visible.

setFolderIcon

public void setFolderIcon(java.lang.String[] path,
                          org.kde.qt.QPixmap pixmap)
Sets the icon used in TreeList Mode for the given path.

Parameters:
path - The path for which this icon should be shown.
pixmap - The icon used.

pageTitle

public java.lang.String pageTitle(int index)
Returns the title string associated with a page index in TreeList or IconList mode.

Parameters:
index - The index of the page or null if there is no such page.
See Also:
pageIndex(org.kde.qt.QWidget)

pageWidget

public org.kde.qt.QWidget pageWidget(int index)
Returns the page widget associated with a page index or null if there is no such page.

Parameters:
index - The index of the page.
See Also:
pageIndex(org.kde.qt.QWidget)

setFocus

public void setFocus()
Give the keyboard input focus to the widget.

Overrides:
setFocus in class org.kde.qt.QWidget

showEvent

public void showEvent(org.kde.qt.QShowEvent arg1)
Reimplemented to handle the splitter width when the the face is TreeList

Overrides:
showEvent in class org.kde.qt.QWidget

eventFilter

public boolean eventFilter(org.kde.qt.QObject o,
                           org.kde.qt.QEvent e)
This function is used internally when in IconList mode. If you reimplement this class a make your own event filter, make sure to call this function from your filter.

Overrides:
eventFilter in class org.kde.qt.QObject
Parameters:
o - Object that has received an event.
e - The event.

showPage

protected boolean showPage(org.kde.qt.QWidget w)

addPageWidget

protected void addPageWidget(org.kde.qt.QFrame page,
                             java.lang.String[] items,
                             java.lang.String header,
                             org.kde.qt.QPixmap pixmap)

InsertTreeListItem

protected void InsertTreeListItem(java.lang.String[] items,
                                  org.kde.qt.QPixmap pixmap,
                                  org.kde.qt.QFrame page)

FindParent

protected org.kde.qt.QWidget FindParent()

finalize

protected void finalize()
                 throws java.lang.InternalError
Deletes the wrapped C++ instance

Overrides:
finalize in class org.kde.qt.QWidget
Throws:
java.lang.InternalError

dispose

public void dispose()
Delete the wrapped C++ instance ahead of finalize()

Overrides:
dispose in class org.kde.qt.QWidget

isDisposed

public boolean isDisposed()
Has the wrapped C++ instance been deleted?

Overrides:
isDisposed in class org.kde.qt.QWidget