gtk2hsContentsIndex
Entry
Description
  • This widget lets the user enter a single line of text.
  • TODO
  • A couple of signals are not bound because I could not figure out what they mean. Some of them do not seem to be emitted at all.
Synopsis
entryNew :: IO Entry
entrySetText :: EntryClass ec => ec -> String -> IO ()
entryGetText :: EntryClass ec => ec -> IO String
entryAppendText :: EntryClass ec => ec -> String -> IO ()
entryPrependText :: EntryClass ec => ec -> String -> IO ()
entrySetVisibility :: EntryClass ec => ec -> Bool -> IO ()
entryGetVisibility :: EntryClass ec => ec -> IO Bool
entrySetInvisibleChar :: EntryClass ec => ec -> Char -> IO ()
entryGetInvisibleChar :: EntryClass ec => ec -> IO Char
entrySetMaxLength :: EntryClass ec => ec -> Int -> IO ()
entryGetActivatesDefault :: EntryClass ec => ec -> IO Bool
entrySetActivatesDefault :: EntryClass ec => ec -> Bool -> IO ()
entryGetHasFrame :: EntryClass ec => ec -> IO Bool
entrySetHasFrame :: EntryClass ec => ec -> Bool -> IO ()
entryGetWidthChars :: EntryClass ec => ec -> IO Int
entrySetWidthChars :: EntryClass ec => ec -> Int -> IO ()
entrySetAlignment :: EntryClass ec => ec -> Float -> IO ()
entryGetAlignment :: EntryClass ec => ec -> IO Float
entrySetCompletion :: EntryClass ec => ec -> EntryCompletion -> IO ()
entryGetCompletion :: EntryClass ec => ec -> IO EntryCompletion
onEntryActivate :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
afterEntryActivate :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
onCopyClipboard :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
afterCopyClipboard :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
onCutClipboard :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
afterCutClipboard :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
onPasteClipboard :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
afterPasteClipboard :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
onInsertAtCursor :: EntryClass ec => ec -> (String -> IO ()) -> IO (ConnectId ec)
afterInsertAtCursor :: EntryClass ec => ec -> (String -> IO ()) -> IO (ConnectId ec)
onToggleOverwrite :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
afterToggleOverwrite :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
Documentation
entryNew :: IO Entry
Create a new Entry widget.
entrySetText :: EntryClass ec => ec -> String -> IO ()
Set the text of the Entry widget.
entryGetText :: EntryClass ec => ec -> IO String
Get the text of the Entry widget.
entryAppendText :: EntryClass ec => ec -> String -> IO ()
Append to the text of the Entry widget.
entryPrependText :: EntryClass ec => ec -> String -> IO ()
Prepend the text of the Entry widget.
entrySetVisibility :: EntryClass ec => ec -> Bool -> IO ()

Set whether to use password mode (display stars instead of the text).

entryGetVisibility :: EntryClass ec => ec -> IO Bool
Get whether widget is in password mode.
entrySetInvisibleChar :: EntryClass ec => ec -> Char -> IO ()
Set the replacement character for invisible text.
entryGetInvisibleChar :: EntryClass ec => ec -> IO Char
Get the current replacement character for invisible text, or 0 if not in password mode.
entrySetMaxLength :: EntryClass ec => ec -> Int -> IO ()

Sets a maximum length the text may grow to.

  • A negative number resets the restriction.
entryGetActivatesDefault :: EntryClass ec => ec -> IO Bool
Query whether pressing return will activate the default widget.
entrySetActivatesDefault :: EntryClass ec => ec -> Bool -> IO ()

Specify if pressing return will activate the default widget.

  • This setting is useful in Dialog boxes where enter should press the default button.
entryGetHasFrame :: EntryClass ec => ec -> IO Bool
Query if the text Entry is displayed with a frame around it.
entrySetHasFrame :: EntryClass ec => ec -> Bool -> IO ()
Specifies whehter the Entry should be in an etched-in frame.
entryGetWidthChars :: EntryClass ec => ec -> IO Int
Retrieve the number of characters the widget should ask for.
entrySetWidthChars :: EntryClass ec => ec -> Int -> IO ()

Specifies how large the Entry should be in characters.

  • This setting is only considered when the widget formulates its size request. Make sure that it is not mapped (shown) before you change this value.
entrySetAlignment :: EntryClass ec => ec -> Float -> IO ()

Sets the alignment for the contents of the entry. This controls the horizontal positioning of the contents when the displayed text is shorter than the width of the entry.

  • Since gtk 2.4
entryGetAlignment :: EntryClass ec => ec -> IO Float

Gets the value set by entrySetAlignment.

  • Since gtk 2.4
entrySetCompletion :: EntryClass ec => ec -> EntryCompletion -> IO ()

Sets the auxiliary completion object to use with the entry. All further configuration of the completion mechanism is done on completion using the EntryCompletion API.

  • Since gtk 2.4
entryGetCompletion :: EntryClass ec => ec -> IO EntryCompletion

Returns the auxiliary completion object currently in use by the entry.

  • Since gtk 2.4
onEntryActivate :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
Emitted when the user presses return within the Entry field.
afterEntryActivate :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
onCopyClipboard :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
Emitted when the current selection has been copied to the clipboard.
afterCopyClipboard :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
onCutClipboard :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
Emitted when the current selection has been cut to the clipboard.
afterCutClipboard :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
onPasteClipboard :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
Emitted when the current selection has been pasted from the clipboard.
afterPasteClipboard :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
onInsertAtCursor :: EntryClass ec => ec -> (String -> IO ()) -> IO (ConnectId ec)
Emitted when a piece of text is inserted at the cursor position.
afterInsertAtCursor :: EntryClass ec => ec -> (String -> IO ()) -> IO (ConnectId ec)
onToggleOverwrite :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
Emitted when the user changes from overwriting to inserting.
afterToggleOverwrite :: EntryClass ec => ec -> IO () -> IO (ConnectId ec)
Produced by Haddock version 0.6