org.kde.koala
Class KPasswordDialog

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.QDialog
                  extended by org.kde.koala.KDialog
                      extended by org.kde.koala.KDialogBase
                          extended by org.kde.koala.KPasswordDialog
All Implemented Interfaces:
org.kde.qt.QPaintDeviceInterface, org.kde.qt.QtSupport

public class KPasswordDialog
extends KDialogBase

This dialog asks the user to enter a password. The functions you're probably interested in are the static methods, getPassword() and getNewPassword().

  • Usage example
  •  String password;
     int result = KPasswordDialog.getPassword(password, i18n("Prompt message"));
     if (result == KPasswordDialog.Accepted)
         use(password);
     
    \image html kpassworddialog.png "KDE Password Dialog"
  • Security notes:
  • Keeping passwords in memory can be a potential security hole. You should handle this situation with care.
  • You may want to use disableCoreDump() to disable core dumps. Core dumps are dangerous because they are an image of the process memory, and thus include any passwords that were in memory.
  • You should delete passwords as soon as they are not needed anymore. The functions getPassword() and getNewPassword() return the password as a String. I believe this is safer than a String. A String stores its characters internally as 16-bit wide values, so conversions are needed, both for creating the String and by using it. The temporary memory used for these conversion is probably not erased. This could lead to stray passwords in memory, even if you think you erased all of them.
  • Author:
    Geert Jansen

    Field Summary
    static int NewPassword
               
    static int Password
              This enum distinguishes the two operation modes of this dialog:
     
    Fields inherited from class org.kde.koala.KDialogBase
    ActionStyle0, ActionStyle1, ActionStyle2, ActionStyle3, ActionStyle4, ActionStyleMAX, Apply, Cancel, Close, Default, Details, Filler, Help, IconList, No, NoDefault, Ok, Plain, Stretch, Swallow, Tabbed, TreeList, Try, User1, User2, User3, Yes
     
    Fields inherited from class org.kde.qt.QDialog
    Accepted, Rejected
     
    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
    protected KPasswordDialog(java.lang.Class dummy)
               
      KPasswordDialog(int type, boolean enableKeep, int extraBttn)
               
      KPasswordDialog(int type, boolean enableKeep, int extraBttn, org.kde.qt.QWidget parent)
               
      KPasswordDialog(int type, boolean enableKeep, int extraBttn, org.kde.qt.QWidget parent, java.lang.String name)
              Constructs a password dialog.
      KPasswordDialog(int type, boolean enableKeep, int extraBttn, java.lang.String iconName)
               
      KPasswordDialog(int type, boolean enableKeep, int extraBttn, java.lang.String iconName, org.kde.qt.QWidget parent)
               
      KPasswordDialog(int type, boolean enableKeep, int extraBttn, java.lang.String iconName, org.kde.qt.QWidget parent, java.lang.String name)
              Construct a password dialog.
     
    Method Summary
     void addLine(java.lang.String key, java.lang.String value)
              Adds a line of information to the dialog.
     boolean allowEmptyPasswords()
              Allow empty passwords?
    protected  boolean checkPassword(java.lang.String arg1)
              Virtual function that can be overridden to provide password checking in derived classes.
     java.lang.String className()
               
     void clearPassword()
              Clears the password input field.
    static void disableCoreDumps()
              Static helper function that disables core dumps.
     void dispose()
              Delete the wrapped C++ instance ahead of finalize()
    protected  void finalize()
              Deletes the wrapped C++ instance
    static int getNewPassword(java.lang.StringBuffer password, java.lang.String prompt)
              Pops up the dialog, asks the user for a password and returns it.
    static int getPassword(java.lang.StringBuffer password, java.lang.String prompt)
               
    static int getPassword(java.lang.StringBuffer password, java.lang.String prompt, int[] keep)
              Pops up the dialog, asks the user for a password, and returns it.
     boolean isDisposed()
              Has the wrapped C++ instance been deleted?
     boolean keep()
              Returns true if the user wants to keep the password.
     int maximumPasswordLength()
              Maximum acceptable password length.
     org.kde.qt.QMetaObject metaObject()
               
     int minimumPasswordLength()
              Minimum acceptable password length.
     java.lang.String password()
              Returns the password entered.
     int passwordStrengthWarningLevel()
              Password strength level below which a warning is given
     java.lang.String prompt()
              Returns the password prompt.
     int reasonablePasswordLength()
              Password length that is expected to be reasonably safe.
     void setAllowEmptyPasswords(boolean allowed)
              Allow empty passwords? - Default: false
     void setMaximumPasswordLength(int maxLength)
              Maximum acceptable password length.
     void setMinimumPasswordLength(int minLength)
              Minimum acceptable password length.
     void setPasswordStrengthWarningLevel(int warningLevel)
              Set the password strength level below which a warning is given Value is in the range 0 to 99.
     void setPrompt(java.lang.String prompt)
              Sets the password prompt.
     void setReasonablePasswordLength(int reasonableLength)
              Password length that is expected to be reasonably safe.
    protected  void slotCancel()
              Activated when the Cancel button has been clicked.
    protected  void slotKeep(boolean arg1)
               
    protected  void slotOk()
              Activated when the Ok button has been clicked.
     
    Methods inherited from class org.kde.koala.KDialogBase
    actionButton, activePageIndex, addButtonBelowList, addButtonBelowList, addGridPage, addGridPage, addGridPage, addGridPage, addGridPage, addGridPage, addHBoxPage, addHBoxPage, addHBoxPage, addHBoxPage, addHBoxPage, addHBoxPage, addPage, addPage, addPage, addPage, addPage, addPage, addVBoxPage, addVBoxPage, addVBoxPage, addVBoxPage, addVBoxPage, addVBoxPage, addWidgetBelowList, adjustSize, backgroundTile, calculateSize, cancel, closeEvent, configDialogSize, configDialogSize, delayedDestruct, disableResize, enableButton, enableButtonApply, enableButtonCancel, enableButtonOK, enableButtonSeparator, enableLinkedHelp, haveBackgroundTile, helpClickedSlot, helpLinkText, hideEvent, incInitialSize, incInitialSize, keyPressEvent, mainWidget, makeGridMainWidget, makeHBoxMainWidget, makeMainWidget, makeVBoxMainWidget, minimumSizeHint, pageIndex, plainPage, saveDialogSize, saveDialogSize, saveDialogSize, saveDialogSize, setBackgroundTile, setButtonApply, setButtonApply, setButtonBoxOrientation, setButtonCancel, setButtonCancel, setButtonGuiItem, setButtonOK, setButtonOK, setButtonText, setButtonTip, setButtonWhatsThis, setDetails, setDetailsWidget, setEscapeButton, setFolderIcon, setHelp, setHelp, setHelpLinkText, setIconListAllVisible, setInitialSize, setInitialSize, setMainWidget, setRootIsDecorated, setShowIconsInTreeList, setTreeListAutoResize, showButton, showButtonApply, showButtonCancel, showButtonOK, showPage, showTile, sizeHint, slotApply, slotClose, slotDefault, slotDelayedDestruct, slotDetails, slotHelp, slotNo, slotTry, slotUser1, slotUser2, slotUser3, slotYes, unfoldTreeList, unfoldTreeList, updateBackground, updateGeometry
     
    Methods inherited from class org.kde.koala.KDialog
    avoidArea, avoidArea, centerOnScreen, centerOnScreen, marginHint, polish, resizeLayout, resizeLayout, setCaption, setPlainCaption, spacingHint
     
    Methods inherited from class org.kde.qt.QDialog
    accept, adjustPosition, contextMenuEvent, done, eventFilter, exec, extension, hide, isModal, isSizeGripEnabled, move, move, orientation, reject, resize, resize, resizeEvent, result, setExtension, setGeometry, setGeometry, setModal, setOrientation, setResult, setSizeGripEnabled, show, showExtension, tr, tr
     
    Methods inherited from class org.kde.qt.QWidget
    acceptDrops, autoMask, backgroundBrush, backgroundColor, backgroundMode, backgroundOffset, backgroundOrigin, backgroundPixmap, baseSize, caption, childAt, childAt, childAt, childAt, childrenRect, childrenRegion, clearFocus, clearMask, clearWFlags, clearWState, clipRegion, close, close, colorGroup, constPolish, 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, icon, iconify, iconText, imComposeEvent, imEndEvent, imStartEvent, isActiveWindow, isDesktop, isDialog, isEnabled, isEnabledTo, isEnabledToTLW, isExtDev, isFocusEnabled, isFullScreen, isHidden, isInputMethodEnabled, isMaximized, isMinimized, isPopup, isShown, isTopLevel, isUpdatesEnabled, isVisible, isVisibleTo, isVisibleToTLW, keyboardGrabber, keyReleaseEvent, layout, leaveEvent, lower, mapFrom, mapFromGlobal, mapFromParent, mapTo, mapToGlobal, mapToParent, maximumHeight, maximumSize, maximumWidth, metric, microFocusHint, minimumHeight, minimumSize, minimumWidth, mouseDoubleClickEvent, mouseGrabber, mouseMoveEvent, mousePressEvent, mouseReleaseEvent, moveEvent, ownCursor, ownFont, ownPalette, paintDevice, paintEvent, paintingActive, palette, paletteBackgroundColor, paletteBackgroundPixmap, paletteChange, paletteForegroundColor, parentWidget, parentWidget, pos, raise, recreate, recreate, rect, releaseKeyboard, releaseMouse, repaint, repaint, repaint, repaint, repaint, repaint, repaint, repaint, reparent, reparent, reparent, reparent, resetInputContext, resolution, scroll, scroll, setAcceptDrops, setActiveWindow, setAutoMask, setBackgroundColor, setBackgroundMode, setBackgroundMode, setBackgroundOrigin, setBackgroundPixmap, setBaseSize, setBaseSize, setCursor, setDisabled, setEnabled, setEraseColor, setErasePixmap, setFixedHeight, setFixedSize, setFixedSize, setFixedWidth, setFocus, setFocusPolicy, setFocusProxy, setFont, setFont, 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, showEvent, showFullScreen, showMaximized, showMinimized, showNormal, size, sizeIncrement, sizePolicy, stackUnder, style, styleChange, tabletEvent, testWFlags, testWState, topLevelWidget, unsetCursor, unsetFont, unsetPalette, update, update, update, 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

    Password

    public static final int Password
    This enum distinguishes the two operation modes of this dialog:

    See Also:
    Constant Field Values

    NewPassword

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

    KPasswordDialog

    protected KPasswordDialog(java.lang.Class dummy)

    KPasswordDialog

    public KPasswordDialog(int type,
                           boolean enableKeep,
                           int extraBttn,
                           org.kde.qt.QWidget parent,
                           java.lang.String name)
    Constructs a password dialog.

    Parameters:
    type - : if NewPassword is given here, the dialog contains two input fields, so that the user must confirm his password and possible typos are detected immediately.
    enableKeep - : if true, a check box is shown in the dialog which allows the user to keep his password input for later.
    extraBttn - : allows to show additional buttons, KDialogBase.
    parent - Passed to lower level constructor.
    name - Passed to lower level constructor

    KPasswordDialog

    public KPasswordDialog(int type,
                           boolean enableKeep,
                           int extraBttn,
                           org.kde.qt.QWidget parent)

    KPasswordDialog

    public KPasswordDialog(int type,
                           boolean enableKeep,
                           int extraBttn)

    KPasswordDialog

    public KPasswordDialog(int type,
                           boolean enableKeep,
                           int extraBttn,
                           java.lang.String iconName,
                           org.kde.qt.QWidget parent,
                           java.lang.String name)
    Construct a password dialog. Essentially the same as above but allows the icon in the password dialog to be set via iconName.

    Parameters:
    type - if NewPassword is given here, the dialog contains two input fields, so that the user must confirm his password and possible typos are detected immediately
    enableKeep - : if true, a check box is shown in the dialog which allows the user to keep his password input for later.
    extraBttn - : allows to show additional buttons.
    iconName - the name of the icon to be shown in the dialog. If empty, a default icon is used
    parent - Passed to lower level constructor.
    name - Passed to lower level constructor

    KPasswordDialog

    public KPasswordDialog(int type,
                           boolean enableKeep,
                           int extraBttn,
                           java.lang.String iconName,
                           org.kde.qt.QWidget parent)

    KPasswordDialog

    public KPasswordDialog(int type,
                           boolean enableKeep,
                           int extraBttn,
                           java.lang.String iconName)
    Method Detail

    metaObject

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

    className

    public java.lang.String className()
    Overrides:
    className in class KDialogBase

    setPrompt

    public void setPrompt(java.lang.String prompt)
    Sets the password prompt.


    prompt

    public java.lang.String prompt()
    Returns the password prompt.


    addLine

    public void addLine(java.lang.String key,
                        java.lang.String value)
    Adds a line of information to the dialog.


    setAllowEmptyPasswords

    public void setAllowEmptyPasswords(boolean allowed)
    Allow empty passwords? - Default: false


    allowEmptyPasswords

    public boolean allowEmptyPasswords()
    Allow empty passwords?


    setMinimumPasswordLength

    public void setMinimumPasswordLength(int minLength)
    Minimum acceptable password length. Default: If empty passwords are forbidden, 1; Otherwise, 0.

    Parameters:
    minLength - : The new minimum password length

    minimumPasswordLength

    public int minimumPasswordLength()
    Minimum acceptable password length.


    setMaximumPasswordLength

    public void setMaximumPasswordLength(int maxLength)
    Maximum acceptable password length. Limited to 199. Default: No limit, i.e. -1

    Parameters:
    maxLength - : The new maximum password length.

    maximumPasswordLength

    public int maximumPasswordLength()
    Maximum acceptable password length.


    setReasonablePasswordLength

    public void setReasonablePasswordLength(int reasonableLength)
    Password length that is expected to be reasonably safe. Default: 8 - the standard UNIX password length

    Parameters:
    reasonableLength - : The new reasonable password length.

    reasonablePasswordLength

    public int reasonablePasswordLength()
    Password length that is expected to be reasonably safe.


    setPasswordStrengthWarningLevel

    public void setPasswordStrengthWarningLevel(int warningLevel)
    Set the password strength level below which a warning is given Value is in the range 0 to 99. Empty passwords score 0; non-empty passwords score up to 100, depending on their length and whether they contain numbers, mixed case letters and punctuation. Default: 1 - warn if the password has no discernable strength whatsoever

    Parameters:
    warningLevel - : The level below which a warning should be given.

    passwordStrengthWarningLevel

    public int passwordStrengthWarningLevel()
    Password strength level below which a warning is given


    password

    public java.lang.String password()
    Returns the password entered. The memory is freed in the destructor, so you should make a copy.


    clearPassword

    public void clearPassword()
    Clears the password input field. You might want to use this after the user failed to enter the correct password.


    keep

    public boolean keep()
    Returns true if the user wants to keep the password.


    getPassword

    public static int getPassword(java.lang.StringBuffer password,
                                  java.lang.String prompt,
                                  int[] keep)
    Pops up the dialog, asks the user for a password, and returns it.

    Parameters:
    password - The password is returned in this reference parameter.
    prompt - A prompt for the password. This can be a few lines of information. The text is word broken to fit nicely in the dialog.
    keep - Enable/disable a checkbox controlling password keeping. If you pass a null pointer, or a pointer to the value 0, the checkbox is not shown. If you pass a pointer to a nonzero value, the checkbox is shown and the result is stored in keep.
    Returns:
    Result code: Accepted or Rejected.

    getPassword

    public static int getPassword(java.lang.StringBuffer password,
                                  java.lang.String prompt)

    getNewPassword

    public static int getNewPassword(java.lang.StringBuffer password,
                                     java.lang.String prompt)
    Pops up the dialog, asks the user for a password and returns it. The user has to enter the password twice to make sure it was entered correctly.

    Parameters:
    password - The password is returned in this reference parameter.
    prompt - A prompt for the password. This can be a few lines of information. The text is word broken to fit nicely in the dialog.
    Returns:
    Result code: Accepted or Rejected.

    disableCoreDumps

    public static void disableCoreDumps()
    Static helper function that disables core dumps.


    checkPassword

    protected boolean checkPassword(java.lang.String arg1)
    Virtual function that can be overridden to provide password checking in derived classes. It should return true if the password is valid, false otherwise.


    slotOk

    protected void slotOk()
    Description copied from class: KDialogBase
    Activated when the Ok button has been clicked. The QDialog.accept() is activated.

    Overrides:
    slotOk in class KDialogBase

    slotCancel

    protected void slotCancel()
    Description copied from class: KDialogBase
    Activated when the Cancel button has been clicked. The QDialog.reject() is activated in regular mode and QDialog.done( Cancel ) when in message box mode.

    Overrides:
    slotCancel in class KDialogBase

    slotKeep

    protected void slotKeep(boolean arg1)

    finalize

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

    Overrides:
    finalize in class KDialogBase
    Throws:
    java.lang.InternalError

    dispose

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

    Overrides:
    dispose in class KDialogBase

    isDisposed

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

    Overrides:
    isDisposed in class KDialogBase