gtkeditable.html

该压缩包包含了GTK+的大量API函数

&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24736"
></A
><H3
><A
NAME="GTK-EDITABLE-CLAIM-SELECTION"
></A
>gtk_editable_claim_selection ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_editable_claim_selection    (<A
HREF="gtkeditable.html"
>GtkEditable</A
> *editable,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> claim,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT32
>guint32</A> time);</PRE
></TD
></TR
></TABLE
><P
>Claim or disclaim ownership of the PRIMARY X selection.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24744"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>editable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtkeditable.html"
>GtkEditable</A
> widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>claim</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>if <TT
CLASS="LITERAL"
>TRUE</TT
>, claim the selection, otherwise, disclaim it.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>time</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the timestamp for claiming the selection.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24763"
></A
><H3
><A
NAME="GTK-EDITABLE-DELETE-SELECTION"
></A
>gtk_editable_delete_selection ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_editable_delete_selection   (<A
HREF="gtkeditable.html"
>GtkEditable</A
> *editable);</PRE
></TD
></TR
></TABLE
><P
>Deletes the current contents of the widgets selection and
disclaims the selection.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24769"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>editable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtkeditable.html"
>GtkEditable</A
> widget.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24779"
></A
><H3
><A
NAME="GTK-EDITABLE-CHANGED"
></A
>gtk_editable_changed ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_editable_changed            (<A
HREF="gtkeditable.html"
>GtkEditable</A
> *editable);</PRE
></TD
></TR
></TABLE
><P
>Causes the "changed" signal to be emitted.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24785"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>editable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtkeditable.html"
>GtkEditable</A
> widget.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24795"
></A
><H3
><A
NAME="GTK-EDITABLE-SET-POSITION"
></A
>gtk_editable_set_position ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_editable_set_position       (<A
HREF="gtkeditable.html"
>GtkEditable</A
> *editable,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> position);</PRE
></TD
></TR
></TABLE
><P
>Sets the cursor position.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24802"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>editable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtkeditable.html"
>GtkEditable</A
> widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>position</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the position of the cursor. The cursor is displayed
           before the character with the given (base 0) index
           in the widget. The value must be less than or
           equal to the number of characters in the widget.
           A value of -1 indicates that the position should
           be set after the last character in the entry.
           Note that this position is in characters, not in
           bytes.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24816"
></A
><H3
><A
NAME="GTK-EDITABLE-GET-POSITION"
></A
>gtk_editable_get_position ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../glib/glib-basic-types.html#GINT
>gint</A>        gtk_editable_get_position       (<A
HREF="gtkeditable.html"
>GtkEditable</A
> *editable);</PRE
></TD
></TR
></TABLE
><P
>Retrieves the current cursor position.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24823"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>editable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtkeditable.html"
>GtkEditable</A
> widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the position of the cursor. The cursor is displayed
           before the character with the given (base 0) index
           in the widget. The value will be less than or
           equal to the number of characters in the widget.
           Note that this position is in characters, not in
           bytes.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24837"
></A
><H3
><A
NAME="GTK-EDITABLE-SET-EDITABLE"
></A
>gtk_editable_set_editable ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_editable_set_editable       (<A
HREF="gtkeditable.html"
>GtkEditable</A
> *editable,
                                             <A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> is_editable);</PRE
></TD
></TR
></TABLE
><P
>Determines if the user can edit the text in the editable
widget or not.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24844"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>editable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtkeditable.html"
>GtkEditable</A
> widget.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>is_editable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="LITERAL"
>TRUE</TT
> if the user is allowed to edit the text
  in the widget.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24859"
></A
><H2
>Args</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
NAME="GTKEDITABLE--TEXT-POSITION"
></A
>&quot;<TT
CLASS="LITERAL"
>text-position</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> : Read / Write)</DT
><DD
><P
></P
></DD
><DT
><A
NAME="GTKEDITABLE--EDITABLE"
></A
>&quot;<TT
CLASS="LITERAL"
>editable</TT
>&quot; (<A
HREF=../glib/glib-basic-types.html#GBOOLEAN
>gboolean</A> : Read / Write)</DT
><DD
><P
>A boolean indicating whether the widget is editable by
the user.</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN24876"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN24878"
></A
><H3
><A
NAME="GTKEDITABLE-CHANGED"
></A
>The &quot;changed&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gtkeditable.html"
>GtkEditable</A
> *editable,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>Indicates that the user has changed the contents
of the widget.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24885"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>editable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.&#13;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>user data set when the signal handler was connected.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN24898"
></A
><H3
><A
NAME="GTKEDITABLE-INSERT-TEXT"
></A
>The &quot;insert-text&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="gtkeditable.html"
>GtkEditable</A
> *editable,
                                            <A
HREF=../glib/glib-basic-types.html#GCHAR
>gchar</A> *new_text,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> new_text_length,
                                            <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> *position,
                                            <A
HREF=../glib/glib-basic-types.html#GPOINTER
>gpointer</A> user_data);</PRE
></TD
></TR
></TABLE
><P
>This signal is emitted when text is inserted into
the widget by the user. The default handler for
this signal will normally be responsible for inserting
the text, so by connecting to this signal and then
stopping the signal with <A
HREF="gtk-signals.html#GTK-SIGNAL-EMIT-STOP"
>gtk_signal_emit_stop</A
>(), it
is possible to modify the inserted text, or prevent
it from being inserted entirely.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN24909"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>editable</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the object which received the signal.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the new text to insert.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_text_length</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the length of the new text.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>position</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the position at which to insert the new text.
           this is an in-out paramter. After the signal
           emission is finished, it should point after   
           the newly inserted text.&#13;</TD
></TR
><TR
><TD