org.kde.koala
Class KPanelApplet

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.qt.QFrame
                  extended by org.kde.koala.KPanelApplet
All Implemented Interfaces:
org.kde.qt.QPaintDeviceInterface, org.kde.qt.QtSupport

public class KPanelApplet
extends org.kde.qt.QFrame

Panel applets

  • Are small applications living in the %KDE panel.
  • Are implemented as DSOs (Dynamic Shared Objects).
  • Note: For security and stability reasons the panel won't load untrusted third party applets directly into its namespace but via an external wrapper process. The panel locates available applets by searching for applet desktop files in (ALL_DIRS)/share/apps/kicker/applets. Every panel applet should install a desktop file there to be recognized by the panel. Besides standard keys like "Name", "Comment" and "Icon" there are two panel applet specific keys:
  • X-KDE-Library
  • Used by the panel to locate the applet DSO (Dynamic Shared Object) Example: X-KDE-Library=libexampleapplet
  • X-KDE-UniqueApplet
  • Similar to KApplication and KUniqueApplication there are two types of panel applets. Use unique applets when it makes no sence to run more than one instance of a applet in the panel. A good example for unique applets is the taskbar applet. Use normal applets when you need instance specific configuration. An example is the koolclock applet where you might want to run two instances in your panel, one configured as analog clock, the other one as digital clock. X-KDE-UniqueApplet is a booleanean key which defaults to "false". Example: X-KDE-UniqueApplet=true Back to panel applet DSOs, the following conventions are used for %KDE: Name: libapplet.la LDFLAGS: -module -no-undefined To implement a panel applet it is not enough to write a class inheriting from KPanelApplet but you also have to provide a factory function in your DSO. A sample factory function could look like this:
     extern "C"
     {
         KPanelApplet init(QWidget parent, String configFile)
         {
             KGlobal.locale().insertCatalogue("exampleapplet");
             return new ExampleApplet(configFile, KPanelApplet.Normal,
                           KPanelApplet.About | KPanelApplet.Help | KPanelApplet.Preferences,
                           parent, "exampleapplet");
         }
     }
     
    Note: Don't change the factory function signature or the panel will fail to load your applet. See KPanelAppletSignals for signals emitted by KPanelApplet

    Author:
    Matthias Elter

    Field Summary
    static int About
              This enum holds flags which can be ORed together to describe which items the context menu over the applet handle contains.
    static int Center
               
    static int Down
               
    static int Help
               
    static int Left
               
    static int LeftTop
               
    static int Normal
              This enum describes the type of the applet.
    static int pBottom
               
    static int pLeft
               
    static int Preferences
               
    static int pRight
               
    static int pTop
               
    static int ReportBug
               
    static int Right
               
    static int RightBottom
               
    static int Stretch
               
    static int Up
               
     
    Fields inherited from class org.kde.qt.QFrame
    Box, GroupBoxPanel, HLine, LineEditPanel, MenuBarPanel, MShadow, MShape, NoFrame, Panel, Plain, PopupPanel, Raised, StyledPanel, Sunken, TabWidgetPanel, ToolBarPanel, VLine, WinPanel
     
    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, 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, 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
    protected KPanelApplet(java.lang.Class dummy)
               
      KPanelApplet(java.lang.String configFile)
               
      KPanelApplet(java.lang.String configFile, int t)
               
      KPanelApplet(java.lang.String configFile, int t, int actions)
               
      KPanelApplet(java.lang.String configFile, int t, int actions, org.kde.qt.QWidget parent)
               
      KPanelApplet(java.lang.String configFile, int t, int actions, org.kde.qt.QWidget parent, java.lang.String name)
               
      KPanelApplet(java.lang.String configFile, int t, int actions, org.kde.qt.QWidget parent, java.lang.String name, int f)
              Constructs a KPanelApplet just like any other widget.
     
    Method Summary
    protected  void about()
              Is called when the user selects "About" from the applet's RMB menu.
     void action(int a)
              Generic action dispatcher.
     int actions()
               
    protected  int alignment()
               
    protected  void alignmentChange(int arg1)
              The panel on which this applet resides has changed its alignment.
     java.lang.String className()
               
     KConfig config()
              Always use this KConfig object to save/load your applet's configuration.
     org.kde.qt.QPopupMenu customMenu()
               
     void dispose()
              Delete the wrapped C++ instance ahead of finalize()
     boolean eventFilter(org.kde.qt.QObject arg1, org.kde.qt.QEvent arg2)
               
    protected  void finalize()
              Deletes the wrapped C++ instance
     int heightForWidth(int width)
              Every applet should reimplement this function.
    protected  void help()
              Is called when the user selects "Help" from the applet's RMB menu.
     boolean isDisposed()
              Has the wrapped C++ instance been deleted?
     org.kde.qt.QMetaObject metaObject()
               
    protected  void needsFocus(boolean focus)
              Call this whenever focus is needed or not needed.
    protected  int orientation()
               
    protected  int popupDirection()
              A convenience method that translates the position of the applet into which direction to show a popup.
    protected  int position()
               
    protected  void positionChange(int p)
              The panel on which this applet resides has changed its position.
    protected  void preferences()
              Is called when the user selects "Preferences" from the applet's RMB menu.
    protected  void reportBug()
              Is called when the user selects "Report bug" from the applet's RMB menu.
     void setAlignment(int a)
               
    protected  void setCustomMenu(org.kde.qt.QPopupMenu arg1)
              Use this method to set the custom menu for this applet so that it can be shown in the applet handle menu and other appropriate places that the applet many not itself be aware of.
     void setPosition(int p)
               
     int type()
               
    protected  void watchForFocus(org.kde.qt.QWidget widget)
               
    protected  void watchForFocus(org.kde.qt.QWidget widget, boolean watch)
              Register widgets that can receive keyboard focus with this this method This call results in an eventFilter being places on the widget.
     int widthForHeight(int height)
              Returns a suggested width for a given height.
     
    Methods inherited from class org.kde.qt.QFrame
    contentsRect, drawContents, drawFrame, frameChanged, frameRect, frameShadow, frameShape, frameStyle, frameWidth, lineShapesOk, lineWidth, margin, midLineWidth, paintEvent, resizeEvent, setFrameRect, setFrameShadow, setFrameShape, setFrameStyle, setLineWidth, setMargin, setMidLineWidth, sizeHint, styleChange, tr, tr
     
    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, 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, minimumSizeHint, minimumWidth, mouseDoubleClickEvent, mouseGrabber, mouseMoveEvent, mousePressEvent, mouseReleaseEvent, move, move, moveEvent, ownCursor, ownFont, ownPalette, paintDevice, 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, resolution, scroll, scroll, setAcceptDrops, setActiveWindow, setAutoMask, setBackgroundColor, setBackgroundMode, setBackgroundMode, setBackgroundOrigin, setBackgroundPixmap, setBaseSize, setBaseSize, setCaption, setCursor, setDisabled, setEnabled, setEraseColor, setErasePixmap, setFixedHeight, setFixedSize, setFixedSize, setFixedWidth, setFocus, 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, showEvent, showFullScreen, showMaximized, showMinimized, showNormal, size, sizeIncrement, sizePolicy, stackUnder, style, tabletEvent, testWFlags, testWState, topLevelWidget, 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

    Normal

    public static final int Normal
    This enum describes the type of the applet.

    See Also:
    Constant Field Values

    Stretch

    public static final int Stretch
    See Also:
    Constant Field Values

    About

    public static final int About
    This enum holds flags which can be ORed together to describe which items the context menu over the applet handle contains.

    See Also:
    Constant Field Values

    Help

    public static final int Help
    See Also:
    Constant Field Values

    Preferences

    public static final int Preferences
    See Also:
    Constant Field Values

    ReportBug

    public static final int ReportBug
    See Also:
    Constant Field Values

    pLeft

    public static final int pLeft
    See Also:
    Constant Field Values

    pRight

    public static final int pRight
    See Also:
    Constant Field Values

    pTop

    public static final int pTop
    See Also:
    Constant Field Values

    pBottom

    public static final int pBottom
    See Also:
    Constant Field Values

    LeftTop

    public static final int LeftTop
    See Also:
    Constant Field Values

    Center

    public static final int Center
    See Also:
    Constant Field Values

    RightBottom

    public static final int RightBottom
    See Also:
    Constant Field Values

    Up

    public static final int Up
    See Also:
    Constant Field Values

    Down

    public static final int Down
    See Also:
    Constant Field Values

    Left

    public static final int Left
    See Also:
    Constant Field Values

    Right

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

    KPanelApplet

    protected KPanelApplet(java.lang.Class dummy)

    KPanelApplet

    public KPanelApplet(java.lang.String configFile,
                        int t,
                        int actions,
                        org.kde.qt.QWidget parent,
                        java.lang.String name,
                        int f)
    Constructs a KPanelApplet just like any other widget.

    Parameters:
    configFile - The configFile handed over in the factory function.
    t - The applet type().
    actions - Standard RMB menu actions supported by the applet (see action() ).
    parent - The pointer to the parent widget handed over in the factory function.
    name - A Qt object name for your applet.
    f - Window control flags

    KPanelApplet

    public KPanelApplet(java.lang.String configFile,
                        int t,
                        int actions,
                        org.kde.qt.QWidget parent,
                        java.lang.String name)

    KPanelApplet

    public KPanelApplet(java.lang.String configFile,
                        int t,
                        int actions,
                        org.kde.qt.QWidget parent)

    KPanelApplet

    public KPanelApplet(java.lang.String configFile,
                        int t,
                        int actions)

    KPanelApplet

    public KPanelApplet(java.lang.String configFile,
                        int t)

    KPanelApplet

    public KPanelApplet(java.lang.String configFile)
    Method Detail

    metaObject

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

    className

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

    widthForHeight

    public int widthForHeight(int height)
    Returns a suggested width for a given height. Every applet should reimplement this function. Depending on the panel orientation the height (horizontal panel) or the width (vertical panel) of the applets is fixed. The exact values of the fixed size component depend on the panel size. On a horizontal panel the applet height is fixed, the panel will call widthForHeight(int height) with height equal to 'the fixed applet height' when laying out the applets. The applet can now choose the other size component (width) based on the given height. The width you return is granted.


    heightForWidth

    public int heightForWidth(int width)
    Every applet should reimplement this function. Depending on the panel orientation the height (horizontal panel) or the width (vertical panel) of the applets is fixed. The exact values of the fixed size component depend on the panel size. On a vertical panel the applet width is fixed, the panel will call heightForWidth(int width) with width equal to 'the fixed applet width' when laying out the applets. The applet can now choose the other size component (height) based on the given width. The height you return is granted.

    Overrides:
    heightForWidth in class org.kde.qt.QWidget
    Returns:
    A suggested height for a given width.

    config

    public KConfig config()
    Always use this KConfig object to save/load your applet's configuration. For unique applets this config object will write to a config file called \rc in the user's local %KDE directory. For normal applets this config object will write to a instance specific config file called \\rc in the user's local %KDE directory.


    type

    public int type()
    Returns:
    Type indicating the applet's type. Type

    actions

    public int actions()
    Returns:
    int indicating the supported RMB menu actions. Action

    action

    public void action(int a)
    Generic action dispatcher. Called when the user selects an item from the applet's RMB menu. Reimplement this function to handle actions. For About, Help, Preferences and ReportBug, use the convenience handlers ref about(), help(), preferences(), reportBug()


    customMenu

    public org.kde.qt.QPopupMenu customMenu()
    Returns:
    the applet's custom menu, usually the same as the context menu, or 0 if none see setCustomMenu(QPopupMenu*)

    setPosition

    public void setPosition(int p)

    setAlignment

    public void setAlignment(int a)

    about

    protected void about()
    Is called when the user selects "About" from the applet's RMB menu. Reimplement this function to launch a about dialog. Note that this is called only when your applet supports the About action. See Action and KPanelApplet().


    help

    protected void help()
    Is called when the user selects "Help" from the applet's RMB menu. Reimplement this function to launch a manual or help page. Note that this is called only when your applet supports the Help action. See Action and KPanelApplet().


    preferences

    protected void preferences()
    Is called when the user selects "Preferences" from the applet's RMB menu. Reimplement this function to launch a preferences dialog or kcontrol module. Note that this is called only when your applet supports the preferences action. See Action and KPanelApplet().


    reportBug

    protected void reportBug()
    Is called when the user selects "Report bug" from the applet's RMB menu. Reimplement this function to launch a bug reporting dialog. Note that this is called only when your applet supports the ReportBug action. See Action and KPanelApplet()


    orientation

    protected int orientation()
    Returns:
    the applet's orientation. (horizontal or vertical)

    position

    protected int position()
    Returns:
    the applet's position. (top, left, bottom, or right)

    alignment

    protected int alignment()
    Returns:
    the applet's alignment. (top/left, center, or bottom/right)

    positionChange

    protected void positionChange(int p)
    The panel on which this applet resides has changed its position. Reimplement this change handler in order to adjust the look of your applet.


    alignmentChange

    protected void alignmentChange(int arg1)
    The panel on which this applet resides has changed its alignment. Reimplement this change handler in order to adjust the look of your applet.


    setCustomMenu

    protected void setCustomMenu(org.kde.qt.QPopupMenu arg1)
    Use this method to set the custom menu for this applet so that it can be shown in the applet handle menu and other appropriate places that the applet many not itself be aware of. The applet itself is still responsible for deleting and managing the the menu. If the menu is deleted during the life of the applet, be sure to call this method again with the new menu (or 0) to avoid crashes


    watchForFocus

    protected void watchForFocus(org.kde.qt.QWidget widget,
                                 boolean watch)
    Register widgets that can receive keyboard focus with this this method This call results in an eventFilter being places on the widget.

    Parameters:
    widget - the widget to watch for keyboard focus
    watch - whether to start watching the widget, or to stop doing so

    watchForFocus

    protected void watchForFocus(org.kde.qt.QWidget widget)

    needsFocus

    protected void needsFocus(boolean focus)
    Call this whenever focus is needed or not needed. You do not have to call this method for widgets that have been registered with watchForFocus

    Parameters:
    focus - whether to or not to request focus

    popupDirection

    protected int popupDirection()
    A convenience method that translates the position of the applet into which direction to show a popup.


    eventFilter

    public boolean eventFilter(org.kde.qt.QObject arg1,
                               org.kde.qt.QEvent arg2)
    Overrides:
    eventFilter in class org.kde.qt.QObject

    finalize

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

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

    dispose

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

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

    isDisposed

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

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