GI.Gtk.Objects.EntryBuffer

The EntryBuffer class contains the actual text displayed in a Entry widget.

A single EntryBuffer object can be shared by multiple Entry widgets which will then share the same text content, but not the cursor position, visibility attributes, icon etc.

EntryBuffer may be derived from. Such a derived class might allow text to be stored in an alternate location, such as non-pageable memory, useful in the case of important passwords. Or a derived class could integrate with an application’s concept of undo/redo.

Exported types

newtype EntryBuffer

Constructors

EntryBuffer (ManagedPtr EntryBuffer)

Instances

GObject EntryBuffer

Methods

gobjectType :: EntryBuffer -> IO GType

IsObject EntryBuffer

IsEntryBuffer EntryBuffer

((~) * info (ResolveEntryBufferMethod t EntryBuffer), MethodInfo * info EntryBuffer p) => IsLabel t (EntryBuffer -> p)

Methods

fromLabel :: Proxy# Symbol t -> EntryBuffer -> p

((~) * info (ResolveEntryBufferMethod t EntryBuffer), MethodInfo * info EntryBuffer p) => IsLabelProxy t (EntryBuffer -> p)

Methods

fromLabelProxy :: Proxy Symbol t -> EntryBuffer -> p

HasAttributeList * EntryBuffer

type AttributeList EntryBuffer

type AttributeList EntryBuffer

type SignalList EntryBuffer

type SignalList EntryBuffer

class GObject o => IsEntryBuffer o

Instances

(GObject a, UnknownAncestorError Constraint EntryBuffer a) => IsEntryBuffer a

IsEntryBuffer EntryBuffer

toEntryBuffer :: IsEntryBuffer o => o -> IO EntryBuffer

noEntryBuffer :: Maybe EntryBuffer

Methods

deleteText

data EntryBufferDeleteTextMethodInfo

Instances

((~) * signature (Word32 -> Int32 -> m Word32), MonadIO m, IsEntryBuffer a) => MethodInfo * EntryBufferDeleteTextMethodInfo a signature

Methods

overloadedMethod :: MethodProxy EntryBufferDeleteTextMethodInfo a -> signature -> s

entryBufferDeleteText

Arguments

:: (HasCallStack, MonadIO m, IsEntryBuffer a)

=> a

buffer: a EntryBuffer

-> Word32

position: position at which to delete text

-> Int32

nChars: number of characters to delete

-> m Word32

Returns: The number of characters deleted.

Deletes a sequence of characters from the buffer. nChars characters are deleted starting at position. If nChars is negative, then all characters until the end of the text are deleted.

If position or nChars are out of bounds, then they are coerced to sane values.

Note that the positions are specified in characters, not bytes.

Since: 2.18

emitDeletedText

data EntryBufferEmitDeletedTextMethodInfo

Instances

((~) * signature (Word32 -> Word32 -> m ()), MonadIO m, IsEntryBuffer a) => MethodInfo * EntryBufferEmitDeletedTextMethodInfo a signature

Methods

overloadedMethod :: MethodProxy EntryBufferEmitDeletedTextMethodInfo a -> signature -> s

entryBufferEmitDeletedText

Arguments

:: (HasCallStack, MonadIO m, IsEntryBuffer a)

=> a

buffer: a EntryBuffer

-> Word32

position: position at which text was deleted

-> Word32

nChars: number of characters deleted

-> m ()

Used when subclassing EntryBuffer

Since: 2.18

emitInsertedText

data EntryBufferEmitInsertedTextMethodInfo

Instances

((~) * signature (Word32 -> Text -> Word32 -> m ()), MonadIO m, IsEntryBuffer a) => MethodInfo * EntryBufferEmitInsertedTextMethodInfo a signature

Methods

overloadedMethod :: MethodProxy EntryBufferEmitInsertedTextMethodInfo a -> signature -> s

entryBufferEmitInsertedText

Arguments

:: (HasCallStack, MonadIO m, IsEntryBuffer a)

=> a

buffer: a EntryBuffer

-> Word32

position: position at which text was inserted

-> Text

chars: text that was inserted

-> Word32

nChars: number of characters inserted

-> m ()

Used when subclassing EntryBuffer

Since: 2.18

getBytes

data EntryBufferGetBytesMethodInfo

Instances

((~) * signature (m Word64), MonadIO m, IsEntryBuffer a) => MethodInfo * EntryBufferGetBytesMethodInfo a signature

Methods

overloadedMethod :: MethodProxy EntryBufferGetBytesMethodInfo a -> signature -> s

entryBufferGetBytes

Arguments

:: (HasCallStack, MonadIO m, IsEntryBuffer a)

=> a

buffer: a EntryBuffer

-> m Word64

Returns: The byte length of the buffer.

Retrieves the length in bytes of the buffer. See entryBufferGetLength.

Since: 2.18

getLength

data EntryBufferGetLengthMethodInfo

Instances

((~) * signature (m Word32), MonadIO m, IsEntryBuffer a) => MethodInfo * EntryBufferGetLengthMethodInfo a signature

Methods

overloadedMethod :: MethodProxy EntryBufferGetLengthMethodInfo a -> signature -> s

entryBufferGetLength

Arguments

:: (HasCallStack, MonadIO m, IsEntryBuffer a)

=> a

buffer: a EntryBuffer

-> m Word32

Returns: The number of characters in the buffer.

Retrieves the length in characters of the buffer.

Since: 2.18

getMaxLength

data EntryBufferGetMaxLengthMethodInfo

Instances

((~) * signature (m Int32), MonadIO m, IsEntryBuffer a) => MethodInfo * EntryBufferGetMaxLengthMethodInfo a signature

Methods

overloadedMethod :: MethodProxy EntryBufferGetMaxLengthMethodInfo a -> signature -> s

entryBufferGetMaxLength

Arguments

:: (HasCallStack, MonadIO m, IsEntryBuffer a)

=> a

buffer: a EntryBuffer

-> m Int32

Returns: the maximum allowed number of characters in EntryBuffer, or 0 if there is no maximum.

Retrieves the maximum allowed length of the text in buffer. See entryBufferSetMaxLength.

Since: 2.18

getText

data EntryBufferGetTextMethodInfo

Instances

((~) * signature (m Text), MonadIO m, IsEntryBuffer a) => MethodInfo * EntryBufferGetTextMethodInfo a signature

Methods

overloadedMethod :: MethodProxy EntryBufferGetTextMethodInfo a -> signature -> s

entryBufferGetText

Arguments

:: (HasCallStack, MonadIO m, IsEntryBuffer a)

=> a

buffer: a EntryBuffer

-> m Text

Returns: a pointer to the contents of the widget as a string. This string points to internally allocated storage in the buffer and must not be freed, modified or stored.

Retrieves the contents of the buffer.

The memory pointer returned by this call will not change unless this object emits a signal, or is finalized.

Since: 2.18

insertText

data EntryBufferInsertTextMethodInfo

Instances

((~) * signature (Word32 -> Text -> Int32 -> m Word32), MonadIO m, IsEntryBuffer a) => MethodInfo * EntryBufferInsertTextMethodInfo a signature

Methods

overloadedMethod :: MethodProxy EntryBufferInsertTextMethodInfo a -> signature -> s

entryBufferInsertText

Arguments

:: (HasCallStack, MonadIO m, IsEntryBuffer a)

=> a

buffer: a EntryBuffer

-> Word32

position: the position at which to insert text.

-> Text

chars: the text to insert into the buffer.

-> Int32

nChars: the length of the text in characters, or -1

-> m Word32

Returns: The number of characters actually inserted.

Inserts nChars characters of chars into the contents of the buffer, at position position.

If nChars is negative, then characters from chars will be inserted until a null-terminator is found. If position or nChars are out of bounds, or the maximum buffer text length is exceeded, then they are coerced to sane values.

Note that the position and length are in characters, not in bytes.

Since: 2.18

new

entryBufferNew

Arguments

:: (HasCallStack, MonadIO m)

=> Maybe Text

initialChars: initial buffer text, or Nothing

-> Int32

nInitialChars: number of characters in initialChars, or -1

-> m EntryBuffer

Returns: A new GtkEntryBuffer object.

Create a new GtkEntryBuffer object.

Optionally, specify initial text to set in the buffer.

Since: 2.18

setMaxLength

data EntryBufferSetMaxLengthMethodInfo

Instances

((~) * signature (Int32 -> m ()), MonadIO m, IsEntryBuffer a) => MethodInfo * EntryBufferSetMaxLengthMethodInfo a signature

Methods

overloadedMethod :: MethodProxy EntryBufferSetMaxLengthMethodInfo a -> signature -> s

entryBufferSetMaxLength

Arguments

:: (HasCallStack, MonadIO m, IsEntryBuffer a)

=> a

buffer: a EntryBuffer

-> Int32

maxLength: the maximum length of the entry buffer, or 0 for no maximum. (other than the maximum length of entries.) The value passed in will be clamped to the range 0-65536.

-> m ()

Sets the maximum allowed length of the contents of the buffer. If the current contents are longer than the given length, then they will be truncated to fit.

Since: 2.18

setText

data EntryBufferSetTextMethodInfo

Instances

((~) * signature (Text -> Int32 -> m ()), MonadIO m, IsEntryBuffer a) => MethodInfo * EntryBufferSetTextMethodInfo a signature

Methods

overloadedMethod :: MethodProxy EntryBufferSetTextMethodInfo a -> signature -> s

entryBufferSetText

Arguments

:: (HasCallStack, MonadIO m, IsEntryBuffer a)

=> a

buffer: a EntryBuffer

-> Text

chars: the new text

-> Int32

nChars: the number of characters in text, or -1

-> m ()

Sets the text in the buffer.

This is roughly equivalent to calling entryBufferDeleteText and entryBufferInsertText.

Note that nChars is in characters, not in bytes.

Since: 2.18

Properties

length

data EntryBufferLengthPropertyInfo

Instances

AttrInfo EntryBufferLengthPropertyInfo

Associated Types

type AttrAllowedOps EntryBufferLengthPropertyInfo :: [AttrOpTag]

type AttrSetTypeConstraint EntryBufferLengthPropertyInfo :: * -> Constraint

type AttrBaseTypeConstraint EntryBufferLengthPropertyInfo :: * -> Constraint

type AttrGetType EntryBufferLengthPropertyInfo :: *

type AttrLabel EntryBufferLengthPropertyInfo :: Symbol

type AttrOrigin EntryBufferLengthPropertyInfo :: *

Methods

attrGet :: AttrBaseTypeConstraint EntryBufferLengthPropertyInfo o => Proxy * EntryBufferLengthPropertyInfo -> o -> IO (AttrGetType EntryBufferLengthPropertyInfo)

attrSet :: (AttrBaseTypeConstraint EntryBufferLengthPropertyInfo o, AttrSetTypeConstraint EntryBufferLengthPropertyInfo b) => Proxy * EntryBufferLengthPropertyInfo -> o -> b -> IO ()

attrClear :: AttrBaseTypeConstraint EntryBufferLengthPropertyInfo o => Proxy * EntryBufferLengthPropertyInfo -> o -> IO ()

attrConstruct :: (AttrBaseTypeConstraint EntryBufferLengthPropertyInfo o, AttrSetTypeConstraint EntryBufferLengthPropertyInfo b) => Proxy * EntryBufferLengthPropertyInfo -> b -> IO (GValueConstruct o)

type AttrOrigin EntryBufferLengthPropertyInfo

type AttrOrigin EntryBufferLengthPropertyInfo = EntryBuffer

type AttrLabel EntryBufferLengthPropertyInfo

type AttrLabel EntryBufferLengthPropertyInfo = "length"

type AttrGetType EntryBufferLengthPropertyInfo

type AttrGetType EntryBufferLengthPropertyInfo = Word32

type AttrBaseTypeConstraint EntryBufferLengthPropertyInfo

type AttrBaseTypeConstraint EntryBufferLengthPropertyInfo = IsEntryBuffer

type AttrSetTypeConstraint EntryBufferLengthPropertyInfo

type AttrSetTypeConstraint EntryBufferLengthPropertyInfo = * ~ ()

type AttrAllowedOps EntryBufferLengthPropertyInfo

type AttrAllowedOps EntryBufferLengthPropertyInfo = (:) AttrOpTag AttrGet ([] AttrOpTag)

entryBufferLength :: AttrLabelProxy "length"

getEntryBufferLength :: (MonadIO m, IsEntryBuffer o) => o -> m Word32

maxLength

data EntryBufferMaxLengthPropertyInfo

Instances

AttrInfo EntryBufferMaxLengthPropertyInfo

Associated Types

type AttrAllowedOps EntryBufferMaxLengthPropertyInfo :: [AttrOpTag]

type AttrSetTypeConstraint EntryBufferMaxLengthPropertyInfo :: * -> Constraint

type AttrBaseTypeConstraint EntryBufferMaxLengthPropertyInfo :: * -> Constraint

type AttrGetType EntryBufferMaxLengthPropertyInfo :: *

type AttrLabel EntryBufferMaxLengthPropertyInfo :: Symbol

type AttrOrigin EntryBufferMaxLengthPropertyInfo :: *

Methods

attrGet :: AttrBaseTypeConstraint EntryBufferMaxLengthPropertyInfo o => Proxy * EntryBufferMaxLengthPropertyInfo -> o -> IO (AttrGetType EntryBufferMaxLengthPropertyInfo)

attrSet :: (AttrBaseTypeConstraint EntryBufferMaxLengthPropertyInfo o, AttrSetTypeConstraint EntryBufferMaxLengthPropertyInfo b) => Proxy * EntryBufferMaxLengthPropertyInfo -> o -> b -> IO ()

attrClear :: AttrBaseTypeConstraint EntryBufferMaxLengthPropertyInfo o => Proxy * EntryBufferMaxLengthPropertyInfo -> o -> IO ()

attrConstruct :: (AttrBaseTypeConstraint EntryBufferMaxLengthPropertyInfo o, AttrSetTypeConstraint EntryBufferMaxLengthPropertyInfo b) => Proxy * EntryBufferMaxLengthPropertyInfo -> b -> IO (GValueConstruct o)

type AttrOrigin EntryBufferMaxLengthPropertyInfo

type AttrOrigin EntryBufferMaxLengthPropertyInfo = EntryBuffer

type AttrLabel EntryBufferMaxLengthPropertyInfo

type AttrLabel EntryBufferMaxLengthPropertyInfo = "max-length"

type AttrGetType EntryBufferMaxLengthPropertyInfo

type AttrGetType EntryBufferMaxLengthPropertyInfo = Int32

type AttrBaseTypeConstraint EntryBufferMaxLengthPropertyInfo

type AttrBaseTypeConstraint EntryBufferMaxLengthPropertyInfo = IsEntryBuffer

type AttrSetTypeConstraint EntryBufferMaxLengthPropertyInfo

type AttrSetTypeConstraint EntryBufferMaxLengthPropertyInfo = * ~ Int32

type AttrAllowedOps EntryBufferMaxLengthPropertyInfo

type AttrAllowedOps EntryBufferMaxLengthPropertyInfo = (:) AttrOpTag AttrSet ((:) AttrOpTag AttrConstruct ((:) AttrOpTag AttrGet ([] AttrOpTag)))

constructEntryBufferMaxLength :: IsEntryBuffer o => Int32 -> IO (GValueConstruct o)

entryBufferMaxLength :: AttrLabelProxy "maxLength"

getEntryBufferMaxLength :: (MonadIO m, IsEntryBuffer o) => o -> m Int32

setEntryBufferMaxLength :: (MonadIO m, IsEntryBuffer o) => o -> Int32 -> m ()

text

data EntryBufferTextPropertyInfo

Instances

AttrInfo EntryBufferTextPropertyInfo

Associated Types

type AttrAllowedOps EntryBufferTextPropertyInfo :: [AttrOpTag]

type AttrSetTypeConstraint EntryBufferTextPropertyInfo :: * -> Constraint

type AttrBaseTypeConstraint EntryBufferTextPropertyInfo :: * -> Constraint

type AttrGetType EntryBufferTextPropertyInfo :: *

type AttrLabel EntryBufferTextPropertyInfo :: Symbol

type AttrOrigin EntryBufferTextPropertyInfo :: *

Methods

attrGet :: AttrBaseTypeConstraint EntryBufferTextPropertyInfo o => Proxy * EntryBufferTextPropertyInfo -> o -> IO (AttrGetType EntryBufferTextPropertyInfo)

attrSet :: (AttrBaseTypeConstraint EntryBufferTextPropertyInfo o, AttrSetTypeConstraint EntryBufferTextPropertyInfo b) => Proxy * EntryBufferTextPropertyInfo -> o -> b -> IO ()

attrClear :: AttrBaseTypeConstraint EntryBufferTextPropertyInfo o => Proxy * EntryBufferTextPropertyInfo -> o -> IO ()

attrConstruct :: (AttrBaseTypeConstraint EntryBufferTextPropertyInfo o, AttrSetTypeConstraint EntryBufferTextPropertyInfo b) => Proxy * EntryBufferTextPropertyInfo -> b -> IO (GValueConstruct o)

type AttrOrigin EntryBufferTextPropertyInfo

type AttrOrigin EntryBufferTextPropertyInfo = EntryBuffer

type AttrLabel EntryBufferTextPropertyInfo

type AttrLabel EntryBufferTextPropertyInfo = "text"

type AttrGetType EntryBufferTextPropertyInfo

type AttrGetType EntryBufferTextPropertyInfo = Text

type AttrBaseTypeConstraint EntryBufferTextPropertyInfo

type AttrBaseTypeConstraint EntryBufferTextPropertyInfo = IsEntryBuffer

type AttrSetTypeConstraint EntryBufferTextPropertyInfo

type AttrSetTypeConstraint EntryBufferTextPropertyInfo = * ~ Text

type AttrAllowedOps EntryBufferTextPropertyInfo

type AttrAllowedOps EntryBufferTextPropertyInfo = (:) AttrOpTag AttrSet ((:) AttrOpTag AttrConstruct ((:) AttrOpTag AttrGet ((:) AttrOpTag AttrClear ([] AttrOpTag))))

clearEntryBufferText :: (MonadIO m, IsEntryBuffer o) => o -> m ()

constructEntryBufferText :: IsEntryBuffer o => Text -> IO (GValueConstruct o)

entryBufferText :: AttrLabelProxy "text"

getEntryBufferText :: (MonadIO m, IsEntryBuffer o) => o -> m Text

setEntryBufferText :: (MonadIO m, IsEntryBuffer o) => o -> Text -> m ()

Signals

deletedText

type C_EntryBufferDeletedTextCallback = Ptr () -> Word32 -> Word32 -> Ptr () -> IO ()

type EntryBufferDeletedTextCallback = Word32 -> Word32 -> IO ()

data EntryBufferDeletedTextSignalInfo

Instances

SignalInfo EntryBufferDeletedTextSignalInfo

Associated Types

type HaskellCallbackType EntryBufferDeletedTextSignalInfo :: *

Methods

connectSignal :: GObject o => SignalProxy o EntryBufferDeletedTextSignalInfo -> o -> HaskellCallbackType EntryBufferDeletedTextSignalInfo -> SignalConnectMode -> IO SignalHandlerId

type HaskellCallbackType EntryBufferDeletedTextSignalInfo

type HaskellCallbackType EntryBufferDeletedTextSignalInfo = EntryBufferDeletedTextCallback

afterEntryBufferDeletedText :: (GObject a, MonadIO m) => a -> EntryBufferDeletedTextCallback -> m SignalHandlerId

genClosure_EntryBufferDeletedText :: EntryBufferDeletedTextCallback -> IO Closure

mk_EntryBufferDeletedTextCallback :: C_EntryBufferDeletedTextCallback -> IO (FunPtr C_EntryBufferDeletedTextCallback)

noEntryBufferDeletedTextCallback :: Maybe EntryBufferDeletedTextCallback

onEntryBufferDeletedText :: (GObject a, MonadIO m) => a -> EntryBufferDeletedTextCallback -> m SignalHandlerId

wrap_EntryBufferDeletedTextCallback :: EntryBufferDeletedTextCallback -> Ptr () -> Word32 -> Word32 -> Ptr () -> IO ()

insertedText

type C_EntryBufferInsertedTextCallback = Ptr () -> Word32 -> CString -> Word32 -> Ptr () -> IO ()

type EntryBufferInsertedTextCallback = Word32 -> Text -> Word32 -> IO ()

data EntryBufferInsertedTextSignalInfo

Instances

SignalInfo EntryBufferInsertedTextSignalInfo

Associated Types

type HaskellCallbackType EntryBufferInsertedTextSignalInfo :: *

Methods

connectSignal :: GObject o => SignalProxy o EntryBufferInsertedTextSignalInfo -> o -> HaskellCallbackType EntryBufferInsertedTextSignalInfo -> SignalConnectMode -> IO SignalHandlerId

type HaskellCallbackType EntryBufferInsertedTextSignalInfo

type HaskellCallbackType EntryBufferInsertedTextSignalInfo = EntryBufferInsertedTextCallback

afterEntryBufferInsertedText :: (GObject a, MonadIO m) => a -> EntryBufferInsertedTextCallback -> m SignalHandlerId

genClosure_EntryBufferInsertedText :: EntryBufferInsertedTextCallback -> IO Closure

mk_EntryBufferInsertedTextCallback :: C_EntryBufferInsertedTextCallback -> IO (FunPtr C_EntryBufferInsertedTextCallback)

noEntryBufferInsertedTextCallback :: Maybe EntryBufferInsertedTextCallback

onEntryBufferInsertedText :: (GObject a, MonadIO m) => a -> EntryBufferInsertedTextCallback -> m SignalHandlerId

wrap_EntryBufferInsertedTextCallback :: EntryBufferInsertedTextCallback -> Ptr () -> Word32 -> CString -> Word32 -> Ptr () -> IO ()