GI.Gtk.Objects.PasswordEntry

PasswordEntry is entry that has been tailored for entering secrets. It does not show its contents in clear text, does not allow to copy it to the clipboard, and it shows a warning when Caps Lock is engaged. If the underlying platform allows it, GtkPasswordEntry will also place the text in a non-pageable memory area, to avoid it being written out to disk by the operating system.

Optionally, it can offer a way to reveal the contents in clear text.

GtkPasswordEntry provides only minimal API and should be used with the Editable API.

CSS Nodes

plain code

entry.password
╰── text
    ├── image.caps-lock-indicator
    ┊

GtkPasswordEntry has a single CSS node with name entry that carries a .passwordstyle class. The text Css node below it has a child with name image and style class .caps-lock-indicator for the Caps Lock icon, and possibly other children.

Accessibility

GtkPasswordEntry uses the GTK_ACCESSIBLE_ROLE_TEXT_BOX role.

Exported types

newtype PasswordEntry

Memory-managed wrapper type.

Constructors

PasswordEntry (ManagedPtr PasswordEntry)

Instances

Eq PasswordEntry

Defined in GI.Gtk.Objects.PasswordEntry

Methods

(==) :: PasswordEntry -> PasswordEntry -> Bool

(/=) :: PasswordEntry -> PasswordEntry -> Bool

GObject PasswordEntry

Defined in GI.Gtk.Objects.PasswordEntry

ManagedPtrNewtype PasswordEntry

Defined in GI.Gtk.Objects.PasswordEntry

Methods

toManagedPtr :: PasswordEntry -> ManagedPtr PasswordEntry

TypedObject PasswordEntry

Defined in GI.Gtk.Objects.PasswordEntry

Methods

glibType :: IO GType

HasParentTypes PasswordEntry

Defined in GI.Gtk.Objects.PasswordEntry

IsGValue (Maybe PasswordEntry)

Convert PasswordEntry to and from GValue. See toGValue and fromGValue.

Defined in GI.Gtk.Objects.PasswordEntry

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe PasswordEntry -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe PasswordEntry)

type ParentTypes PasswordEntry

Defined in GI.Gtk.Objects.PasswordEntry

type ParentTypes PasswordEntry = '[Widget, Object, Accessible, Buildable, ConstraintTarget, Editable]

class (GObject o, IsDescendantOf PasswordEntry o) => IsPasswordEntry o

Type class for types which can be safely cast to PasswordEntry, for instance with toPasswordEntry.

Instances

(GObject o, IsDescendantOf PasswordEntry o) => IsPasswordEntry o

Defined in GI.Gtk.Objects.PasswordEntry

toPasswordEntry :: (MonadIO m, IsPasswordEntry o) => o -> m PasswordEntry

Cast to PasswordEntry, for types for which this is known to be safe. For general casts, use castTo.

Methods

Click to display all available methods, including inherited ones

Methods

actionSetEnabled, activate, activateAction, activateDefault, addController, addCssClass, addMnemonicLabel, addTickCallback, allocate, bindProperty, bindPropertyFull, childFocus, computeBounds, computeExpand, computePoint, computeTransform, contains, createPangoContext, createPangoLayout, deleteSelection, deleteText, dragCheckThreshold, errorBell, finishDelegate, forceFloating, freezeNotify, getv, grabFocus, hasCssClass, hasDefault, hasFocus, hasVisibleFocus, hide, inDestruction, initDelegate, initTemplate, insertActionGroup, insertAfter, insertBefore, insertText, isAncestor, isDrawable, isFloating, isFocus, isSensitive, isVisible, keynavFailed, listMnemonicLabels, map, measure, mnemonicActivate, notify, notifyByPspec, observeChildren, observeControllers, pick, queueAllocate, queueDraw, queueResize, realize, ref, refSink, removeController, removeCssClass, removeMnemonicLabel, removeTickCallback, resetProperty, resetRelation, resetState, runDispose, selectRegion, shouldLayout, show, sizeAllocate, snapshotChild, stealData, stealQdata, thawNotify, translateCoordinates, triggerTooltipQuery, unmap, unparent, unrealize, unref, unsetStateFlags, updateProperty, updateRelation, updateState, watchClosure.

Getters

getAccessibleRole, getAlignment, getAllocatedBaseline, getAllocatedHeight, getAllocatedWidth, getAllocation, getAncestor, getBuildableId, getCanFocus, getCanTarget, getChars, getChildVisible, getClipboard, getCssClasses, getCssName, getCursor, getData, getDelegate, getDirection, getDisplay, getEditable, getEnableUndo, getExtraMenu, getFirstChild, getFocusChild, getFocusOnClick, getFocusable, getFontMap, getFontOptions, getFrameClock, getHalign, getHasTooltip, getHeight, getHexpand, getHexpandSet, getLastChild, getLayoutManager, getMapped, getMarginBottom, getMarginEnd, getMarginStart, getMarginTop, getMaxWidthChars, getName, getNative, getNextSibling, getOpacity, getOverflow, getPangoContext, getParent, getPosition, getPreferredSize, getPrevSibling, getPrimaryClipboard, getProperty, getQdata, getRealized, getReceivesDefault, getRequestMode, getRoot, getScaleFactor, getSelectionBounds, getSensitive, getSettings, getShowPeekIcon, getSize, getSizeRequest, getStateFlags, getStyleContext, getTemplateChild, getText, getTooltipMarkup, getTooltipText, getValign, getVexpand, getVexpandSet, getVisible, getWidth, getWidthChars.

Setters

setAlignment, setCanFocus, setCanTarget, setChildVisible, setCssClasses, setCursor, setCursorFromName, setData, setDataFull, setDirection, setEditable, setEnableUndo, setExtraMenu, setFocusChild, setFocusOnClick, setFocusable, setFontMap, setFontOptions, setHalign, setHasTooltip, setHexpand, setHexpandSet, setLayoutManager, setMarginBottom, setMarginEnd, setMarginStart, setMarginTop, setMaxWidthChars, setName, setOpacity, setOverflow, setParent, setPosition, setProperty, setReceivesDefault, setSensitive, setShowPeekIcon, setSizeRequest, setStateFlags, setText, setTooltipMarkup, setTooltipText, setValign, setVexpand, setVexpandSet, setVisible, setWidthChars.

getExtraMenu

passwordEntryGetExtraMenu

Arguments

:: (HasCallStack, MonadIO m, IsPasswordEntry a)

=> a

entry: a Text

-> m MenuModel

Returns: (nullable): the menu model

Gets the menu model set with passwordEntrySetExtraMenu.

getShowPeekIcon

passwordEntryGetShowPeekIcon

Arguments

:: (HasCallStack, MonadIO m, IsPasswordEntry a)

=> a

entry: a PasswordEntry

-> m Bool

Returns: True if an icon is shown

Returns whether the entry is showing a clickable icon to reveal the contents of the entry in clear text.

new

passwordEntryNew

Arguments

:: (HasCallStack, MonadIO m)

=> m PasswordEntry

Returns: a new PasswordEntry

Creates a PasswordEntry.

setExtraMenu

passwordEntrySetExtraMenu

Arguments

:: (HasCallStack, MonadIO m, IsPasswordEntry a, IsMenuModel b)

=> a

entry: a PasswordEntry

-> Maybe b

model: a MenuModel

-> m ()

Sets a menu model to add when constructing the context menu for entry.

setShowPeekIcon

passwordEntrySetShowPeekIcon

Arguments

:: (HasCallStack, MonadIO m, IsPasswordEntry a)

=> a

entry: a PasswordEntry

-> Bool

showPeekIcon: whether to show the peek icon

-> m ()

Sets whether the entry should have a clickable icon to show the contents of the entry in clear text.

Setting this to False also hides the text again.

Properties

activatesDefault

No description available in the introspection data.

constructPasswordEntryActivatesDefault :: (IsPasswordEntry o, MonadIO m) => Bool -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “activates-default” property. This is rarely needed directly, but it is used by new.

getPasswordEntryActivatesDefault :: (MonadIO m, IsPasswordEntry o) => o -> m Bool

Get the value of the “activates-default” property. When overloading is enabled, this is equivalent to

get passwordEntry #activatesDefault

setPasswordEntryActivatesDefault :: (MonadIO m, IsPasswordEntry o) => o -> Bool -> m ()

Set the value of the “activates-default” property. When overloading is enabled, this is equivalent to

set passwordEntry [ #activatesDefault := value ]

extraMenu

A menu model whose contents will be appended to the context menu.

clearPasswordEntryExtraMenu :: (MonadIO m, IsPasswordEntry o) => o -> m ()

Set the value of the “extra-menu” property to Nothing. When overloading is enabled, this is equivalent to

clear #extraMenu

constructPasswordEntryExtraMenu :: (IsPasswordEntry o, MonadIO m, IsMenuModel a) => a -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “extra-menu” property. This is rarely needed directly, but it is used by new.

getPasswordEntryExtraMenu :: (MonadIO m, IsPasswordEntry o) => o -> m MenuModel

Get the value of the “extra-menu” property. When overloading is enabled, this is equivalent to

get passwordEntry #extraMenu

setPasswordEntryExtraMenu :: (MonadIO m, IsPasswordEntry o, IsMenuModel a) => o -> a -> m ()

Set the value of the “extra-menu” property. When overloading is enabled, this is equivalent to

set passwordEntry [ #extraMenu := value ]

placeholderText

No description available in the introspection data.

clearPasswordEntryPlaceholderText :: (MonadIO m, IsPasswordEntry o) => o -> m ()

Set the value of the “placeholder-text” property to Nothing. When overloading is enabled, this is equivalent to

clear #placeholderText

constructPasswordEntryPlaceholderText :: (IsPasswordEntry o, MonadIO m) => Text -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “placeholder-text” property. This is rarely needed directly, but it is used by new.

getPasswordEntryPlaceholderText :: (MonadIO m, IsPasswordEntry o) => o -> m (Maybe Text)

Get the value of the “placeholder-text” property. When overloading is enabled, this is equivalent to

get passwordEntry #placeholderText

setPasswordEntryPlaceholderText :: (MonadIO m, IsPasswordEntry o) => o -> Text -> m ()

Set the value of the “placeholder-text” property. When overloading is enabled, this is equivalent to

set passwordEntry [ #placeholderText := value ]

showPeekIcon

No description available in the introspection data.

constructPasswordEntryShowPeekIcon :: (IsPasswordEntry o, MonadIO m) => Bool -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “show-peek-icon” property. This is rarely needed directly, but it is used by new.

getPasswordEntryShowPeekIcon :: (MonadIO m, IsPasswordEntry o) => o -> m Bool

Get the value of the “show-peek-icon” property. When overloading is enabled, this is equivalent to

get passwordEntry #showPeekIcon

setPasswordEntryShowPeekIcon :: (MonadIO m, IsPasswordEntry o) => o -> Bool -> m ()

Set the value of the “show-peek-icon” property. When overloading is enabled, this is equivalent to

set passwordEntry [ #showPeekIcon := value ]

Signals

activate

type C_PasswordEntryActivateCallback = Ptr () -> Ptr () -> IO ()

Type for the callback on the (unwrapped) C side.

type PasswordEntryActivateCallback = IO ()

No description available in the introspection data.

afterPasswordEntryActivate :: (IsPasswordEntry a, MonadIO m) => a -> PasswordEntryActivateCallback -> m SignalHandlerId

Connect a signal handler for the activate signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after passwordEntry #activate callback

genClosure_PasswordEntryActivate :: MonadIO m => PasswordEntryActivateCallback -> m (GClosure C_PasswordEntryActivateCallback)

Wrap the callback into a GClosure.

mk_PasswordEntryActivateCallback :: C_PasswordEntryActivateCallback -> IO (FunPtr C_PasswordEntryActivateCallback)

Generate a function pointer callable from C code, from a C_PasswordEntryActivateCallback.

noPasswordEntryActivateCallback :: Maybe PasswordEntryActivateCallback

A convenience synonym for Nothing :: Maybe PasswordEntryActivateCallback.

onPasswordEntryActivate :: (IsPasswordEntry a, MonadIO m) => a -> PasswordEntryActivateCallback -> m SignalHandlerId

Connect a signal handler for the activate signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on passwordEntry #activate callback

wrap_PasswordEntryActivateCallback :: PasswordEntryActivateCallback -> C_PasswordEntryActivateCallback

Wrap a PasswordEntryActivateCallback into a C_PasswordEntryActivateCallback.