## 4.9 Entry

An entry is a one line text editor. It is typically used to obtain textual input from user, such as a file name.

To enter text into an entry the user moves the pointer into the entry, causing the entry to take focus and making a red cursor to appear. The user can then enter characters and they will be inserted at the point of the cursor. The cursor can be moved by clicking mouse button 1 anywhere in the entry's text. Text in an entry can be selected by pressing and dragging mouse button 1. Selections can be pasted into an entry by pressing mouse button 2 in the entry. The entry widget supports a few emacs like editing commands.

When the return key or the tab key is pressed in an entry, and if it has any callbacks, the callbacks are invoked.

If motion callbacks are registered to an entry widget, they are invoked whenever the text string in the entry field is modified.

### Widget Info

Symbolic widget type | EZ_WIDGET_ENTRY
Default class name | "Entry"
Default instance name | "entry"

### Widget Interface Routines

`void EZ_SetEntryString(EZ_Widget *widget, char *str);`

set or replace the text in an entry widget.

`char *EZ_GetEntryString(EZ_Widget *widget);`

return the text in an entry widget. Don't modify the returned text !

`void EZ_OnOffSecretEntry(EZ_Widget *widget, int onoff);`

toggle secret entry on and off.

Editing Routines

`void EZ_EntryEditDeleteChar(EZ_Widget *widget, int direction);`

`void EZ_EntryEditBeginOfInput(EZ_Widget *widget);`

`void EZ_EntryEditBeginningOfInput(EZ_Widget *widget);`

`void EZ_EntryEditEndOfInput(EZ_Widget *widget);`

`void EZ_EntryEditForeward(EZ_Widget *widget);`

`void EZ_EntryEditBackward(EZ_Widget *widget);`

`void EZ_EntryEditSetMarker(EZ_Widget *widget);`

`void EZ_EntryEditKillRegion(EZ_Widget *widget);`

`void EZ_EntryEditKillEndOfLine(EZ_Widget *widget, int flag);`

`void EZ_EntryCopySelectedText(EZ_Widget *widget, int start, int end);`

`void EZ_EntryPasteSelection(EZ_Widget *widget);`

`void EZ_EntryEditInsertString (EZ_Widget *widget, char *str);`

`void EZ_EntryEditForwardWord(EZ_Widget *widget);`

`void EZ_EntryEditBackwardWord(EZ_Widget *widget);`

`void EZ_EntryEditGotoPosition(EZ_Widget *widget, int p);`

### Screenshot

### Resources

Config_Option | ResourceName | DefaultValue
EZ_CLASS | class | `"Entry"`
EZ_NAME | name | `"entry"`

EZ_X | x |
EZ_Y | y |
EZ_WIDTH | width |
EZ_HEIGHT | height |

EZ_LOCATION | location |
EZ_SIZE | size |
EZ_GEOMETRY | geometry |

EZ_WIDTH_HINT | widthHint |
EZ_HEIGHT_HINT | heightHint |
EZ_SIZE_HINT | sizeHint |

EZ_BORDER_WIDTH | borderWidth | `0`
EZ_BORDER_TYPE | borderType | `none`
EZ_FOCUS_PAD | focusPad | `2`

EZ_PADX | padx | `0`
EZ_PADY | pady | `3`
EZ_IPADX | iPadx | `0`
EZ_IPADY | iPady | `0`

EZ_EXPAND | expand | `false`
EZ_PROPAGATE | propagate | `true`
EZ_TRANSIENT | transient | `false`

EZ_FONT_ID | fontID | `3`
EZ_FONT_NAME | fontName | `"*fixed*"`
EZ_LABEL_STRING | labelString | `null`
EZ_TEXT_LINE_LENGTH | textLineLength | `30`

EZ_CURSOR | cursor | `"XC_xterm"`
EZ_BUBBLE_STRING | bubbleString | `null`

EZ_CALLBACK | N/A | `null null`
EZ_MOTION_CALLBACK | N/A | `null null`
EZ_DESTROY_CALLBACK | N/A | `null null`
EZ_EVENT_HANDLER | N/A | `null null`

EZ_FOREGROUND | foreground | `"black"`
EZ_BACKGROUND | background | `"gray74`
EZ_BG_IMAGE_FILE | bgImageFile | `null`
EZ_BG_PIXMAP | N/A | `none`
EZ_HIGHLIGHT_BACKGROUND | highlightBackground |

EZ_CLIENT_PTR_DATA | N/A | `null`
EZ_CLIENT_INT_DATA | clientIntData | `0`

EZ_DND_DRAG_CURSOR | dndDragCursor | `none`
EZ_DND_BUBBLE_STRING | dndBubbleString | `null`

EZ_ENTRY_STRING | entryString | `null`
EZ_ENTRY_EDITABLE | entryEditable | `true`

EZ_GRID_CELL_GEOMETRY | gridCellGeometry |
EZ_GRID_CELL_PLACEMENT | gridCellPlacement |

HTML Documentation Maintainance:`Arturo Espinosa <arturo@nuclecu.unam.mx>`