EZ
Up Prev Next Contents


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


Up Prev Next Contents

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