eb05362005-11-05Henrik Grubbström (Grubba) /* -*- C -*- */
1a05542005-07-28Martin Nilsson class GTK2.Entry; inherit GTK2.Widget; //! Use this widget when you want the user to input a single line of text. //! IMG: GTK2.Entry()->set_text("Hello world")->set_editable(1) //! Properties: //! int activates-default //! int cursor-position //! int editable //! int has-frame //! int invisible-char //! int max-length //! int scroll-offset //! int selection-bound //! string text //! int visibility //! int width-chars //! float xalign signal activate; signal backspace; signal copy_clipboard; signal cut_clipboard; signal delete_from_cursor; signal insert_at_cursor; signal move_cursor; signal paste_clipboard; signal populate_popup; signal toggle_overwrite;
3d76632005-11-03Lance Dillon void create(int|mapping(string:mixed)|void maxlen_or_props)
1a05542005-07-28Martin Nilsson //! Create a new W(Entry) widget.
3d76632005-11-03Lance Dillon { pgtk_verify_not_inited(); pgtk_verify_setup(); if (args) { if (Pike_sp[-args].type==PIKE_T_INT) { int max; GtkWidget *ge; get_all_args("create",args,"%i",&max); ge=gtk_entry_new_with_max_length(max); THIS->obj=G_OBJECT(ge); } else { INIT_WITH_PROPS(GTK_TYPE_ENTRY); } my_pop_n_elems(args); } else { GtkWidget *ge; ge=gtk_entry_new(); THIS->obj=G_OBJECT(ge); } pgtk__init_this_object(); }
1a05542005-07-28Martin Nilsson  void set_text(string text); //! Set the text to the specified string, replacing the current contents. void set_visibility(int visiblep); //! 0 indicates invisible text (password boxes, as an example) void set_invisible_char(int ch); //! Sets the character to use in place of the actual text when //! set_invisibility() has been called to set text visibility to false. i.e. //! this is the character used in "password" mode to show the user how many //! characters have been type. The default invisible char is an asterisk //! ('*'). If you set the invisible char to 0, then the user will get no //! feedback at all; there will be no text on the screen as they type. void set_max_length(int maxlen); //! Sets the maximum allowed length of the contents. If the current contents //! are longer than the given length, then they will be truncated to fit. //! Range is 0-65536. 0 means no maximum. string get_text(); //! Returns the contents of the entry widget. int get_activates_default(); //! Retrieves the value set by set_activates_default(). int get_has_frame(); //! Gets the value set by set_has_frame(). int get_width_chars(); //! Gets the value set by set_width_chars(). void set_activates_default(int setting); //! If setting is true, pressing Enter will activate the default widget for //! the window containing the entry. This usually means that the dialog box //! containing the entry will be closed, since the default widget is usually //! one of the dialog buttons. void set_has_frame(int setting); //! Sets whether the entry has a beveled frame around it. void set_width_chars(int n_chars); //! changes the size request of the entry to be about the right size for //! n_chars characters. Note that it changes the size request, the size can //! still be affected by how you pack the widget into containers. If n_chars //! is -1, the size reverts to the default entry size. int get_invisible_char(); //! Retrieves the character displayed in place of the real characters for //! entries with visibility set to false. require gtk24; void set_alignment(float align); //! Sets the alignment for the ocntents of the entry. This controls the //! horizontal positioning of the contents when the displayed text is shorter //! than the width of the entry. float get_alignment(); //! Gets the value set by set_alignment(). endrequire; require pango; Pango.Layout get_layout(); //! Gets the Pango.Layout used to display the entry. The layout is useful to //! e.g. convert text positions to pixel positions, in combination with //! get_layout_offsets(). //! <p> //! Keep in mind that the layout text may contain a preedit string, so //! layout_index_to_text_index() and text_index_to_layout_index() are needed //! to convert byte indices in the layout to byte indices in the entry //! contents. int layout_index_to_text_index(int layout_index); //! Converts from a position in the entry contents (returned by get_text()) //! to a position in the entry's Pango.Layout (returned by get_layout()), //! with text retrieved via Pango.Layout->get_text(). int text_index_to_layout_index(int text_index); //! Opposite of layout_index_to_text_index(). endrequire; int get_max_length(); //! Retrieves the maximum allowed length of the text. int get_visibility(); //! Retrieves whether the text is visible. require gtk24; void set_completion(GTK2.EntryCompletion completion); //! Sets completion to be the auxiliary completion object to use. All further //! configuration of the completion mechanism is done on completion using //! the GTK2.EntryCompletion API. GTK2.EntryCompletion get_completion(); //! Returns the completion object. endrequire; #include "gtkcelleditable.inc" #include "gtkeditable.inc"