ryujinx/GtkSharp
1
0
Fork 0
mirror of https://github.com/Ryujinx/GtkSharp.git synced 2025-02-28 16:16:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

* en/Gtk/Label.xml: Finished documentation for the Gtk.Label

Browse source 
class.

* sources/Gtk.metadata:
* api/gtk-api.xml: Marked the arguments to GetSelectionBounds and
GetLayoutOffsets as out params.

svn path=/trunk/gtk-sharp/; revision=16861
This commit is contained in:
Duncan Mak 2003-07-29 23:02:50 +00:00
parent 8793c62f3b
commit 51ae478c43
5 changed files with 175 additions and 125 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
ChangeLog
View file

@ -1,3 +1,9 @@
2003-07-29 Duncan Mak <duncan@ximian.com>
* sources/Gtk.metadata:
* api/gtk-api.xml: Marked the arguments to GetSelectionBounds and
GetLayoutOffsets as out params.
2003-07-28 Duncan Mak <duncan@ximian.com> 2003-07-28 Duncan Mak <duncan@ximian.com>
* glade/XML.custom: Added new convenience factory methods, * glade/XML.custom: Added new convenience factory methods,

8
api/gtk-api.xml
View file

@ -4101,8 +4101,8 @@
<method name="GetLayoutOffsets" cname="gtk_label_get_layout_offsets"> <method name="GetLayoutOffsets" cname="gtk_label_get_layout_offsets">
<return-type type="void"/> <return-type type="void"/>
<parameters> <parameters>
<parameter type="gint*" name="x"/> <parameter type="gint*" name="x" pass_as="out"/>
<parameter type="gint*" name="y"/> <parameter type="gint*" name="y" pass_as="out"/>
</parameters> </parameters>
</method> </method>
<method name="GetLineWrap" cname="gtk_label_get_line_wrap"> <method name="GetLineWrap" cname="gtk_label_get_line_wrap">
@ -4120,8 +4120,8 @@
<method name="GetSelectionBounds" cname="gtk_label_get_selection_bounds"> <method name="GetSelectionBounds" cname="gtk_label_get_selection_bounds">
<return-type type="gboolean"/> <return-type type="gboolean"/>
<parameters> <parameters>
<parameter type="gint*" name="start"/> <parameter type="gint*" name="start" pass_as="out"/>
<parameter type="gint*" name="end"/> <parameter type="gint*" name="end" pass_as="out"/>
</parameters> </parameters>
</method> </method>
<method name="GetText" cname="gtk_label_get_text"> <method name="GetText" cname="gtk_label_get_text">

5
doc/ChangeLog
View file

@ -1,3 +1,8 @@
2003-07-29 Duncan Mak <duncan@ximian.com>
* en/Gtk/Label.xml: Finished documentation for the Gtk.Label
class.
2003-07-28 Duncan Mak <duncan@ximian.com> 2003-07-28 Duncan Mak <duncan@ximian.com>
* en/Glade/XML.xml: Added some documentation. * en/Glade/XML.xml: Added some documentation.

249
doc/en/Gtk/Label.xml
View file

@ -77,21 +77,21 @@
</Docs> </Docs>
</Member> </Member>
<Member MemberName="GetSelectionBounds"> <Member MemberName="GetSelectionBounds">
<MemberSignature Language="C#" Value="public bool GetSelectionBounds (int start, int end);" /> <MemberSignature Language="C#" Value="public bool GetSelectionBounds (out int start, out int end);" />
<MemberType>Method</MemberType> <MemberType>Method</MemberType>
<ReturnValue> <ReturnValue>
<ReturnType>System.Boolean</ReturnType> <ReturnType>System.Boolean</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters>
<Parameter Name="start" Type="System.Int32" /> <Parameter Name="start" Type="System.Int32" RefType="out" />
<Parameter Name="end" Type="System.Int32" /> <Parameter Name="end" Type="System.Int32" RefType="out" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Gets the selected range of characters in the label.</summary>
<param name="start">To be added: an object of type 'int'</param> <param name="start"> return location for start of selection, as a character offset</param>
<param name="end">To be added: an object of type 'int'</param> <param name="end"> return location for end of selection, as a character offset</param>
<returns>To be added: an object of type 'bool'</returns> <returns>returns <see langword="true" /> if there's a selection.</returns>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="SelectRegion"> <Member MemberName="SelectRegion">
@ -105,27 +105,55 @@
<Parameter Name="end_offset" Type="System.Int32" /> <Parameter Name="end_offset" Type="System.Int32" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Selects a range of characters in the label, if the label is selectable.</summary>
<param name="start_offset">To be added: an object of type 'int'</param> <param name="start_offset">start offset (in characters not bytes)</param>
<param name="end_offset">To be added: an object of type 'int'</param> <param name="end_offset">end offset (in characters not bytes)</param>
<remarks>To be added</remarks> <remarks>
<para>
Selects a range of characters in the label, if the label
is selectable. See <see cref="P:Gtk.Label.Selectable" />. If the
label is not selectable, this function has no effect. If
<see paramref="start_offset" /> or
<see paramref="end_offset" /> are -1, then the end of the
label will be substituted.
</para>
</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="GetLayoutOffsets"> <Member MemberName="GetLayoutOffsets">
<MemberSignature Language="C#" Value="public void GetLayoutOffsets (int x, int y);" /> <MemberSignature Language="C#" Value="public void GetLayoutOffsets (out int x, out int y);" />
<MemberType>Method</MemberType> <MemberType>Method</MemberType>
<ReturnValue> <ReturnValue>
<ReturnType>System.Void</ReturnType> <ReturnType>System.Void</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters>
<Parameter Name="x" Type="System.Int32" /> <Parameter Name="x" Type="System.Int32" RefType="out" />
<Parameter Name="y" Type="System.Int32" /> <Parameter Name="y" Type="System.Int32" RefType="out" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>
<param name="x">To be added: an object of type 'int'</param> Obtains the coordinates where the label will draw the <see cref="T:Pango.Layout" />
<param name="y">To be added: an object of type 'int'</param> representing the text in the label
<remarks>To be added</remarks> </summary>
<param name="x">
location to store X offset of layout, or <see langword="null" /></param>
<param name="y">
location to store Y offset of layout, or <see langword="null" /></param>
<remarks>
<para>
Obtains the coordinates where the label will draw the
<see cref="T:Pango.Layout" /> representing the text in the label; useful to
convert mouse events into coordinates inside the
<see cref="T:Pango.Layout" />, e.g. to take some action if some part of the
label is clicked. Of course you will need to create a
<see cref="T:Gtk.EventBox" /> to receive the events, and pack the label
inside it, since labels are a <see cref="F:Gtk.WindowType.NoWindow" />
widget. Remember when using the
<see cref="T:Pango.Layout" />functions you
need to convert to and from pixels using PANGO_PIXELS() or
PANGO_SCALE.
</para>
</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Finalize"> <Member MemberName="Finalize">
@ -186,9 +214,9 @@
<ReturnValue /> <ReturnValue />
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary>Constructor used to extending this class</summary>
<returns>To be added: an object of type 'Gtk.Label'</returns> <returns>the newly created <see cref="T:Gtk.Label" /></returns>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="GType"> <Member MemberName="GType">
@ -209,20 +237,18 @@
<ReturnValue> <ReturnValue>
<ReturnType>System.String</ReturnType> <ReturnType>System.String</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Sets the label's text</summary>
<param name="value">To be added: an object of type 'string'</param> <param name="value">the text for this label</param>
<returns>To be added: an object of type 'string'</returns>
<remarks> <remarks>
<para> <para>
Sets the label's text from the string <paramref name="str" />. If characters in <paramref name="str" /> are preceded by an Sets the label's text. If characters in <paramref name="value" />
underscore, they are underlined indicating that they are preceded by an underscore, they are
represent a keyboard accelerator called a mnemonic. The underlined indicating that they represent a keyboard
mnemonic key can be used to activate another widget, accelerator called a mnemonic. The mnemonic key can be
chosen automatically, or explicitly using used to activate another widget, chosen automatically, or
<see cref="M:Gtk.Label.MnemonicWidget" />. explicitly using <see cref="M:Gtk.Label.MnemonicWidget" />.
</para> </para>
</remarks> </remarks>
</Docs> </Docs>
@ -233,15 +259,14 @@
<ReturnValue> <ReturnValue>
<ReturnType>System.String</ReturnType> <ReturnType>System.String</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary>Parses str which is marked up with the Pango text markup language</summary> <summary>Parses str which is marked up with the Pango text markup language</summary>
<param name="value">a markup string (see Pango markup format)</param> <param name="value">a markup string (see Pango markup format)</param>
<returns>a GtkLabel</returns> <returns>a GtkLabel</returns>
<remarks> <remarks>
<para> <para>
Parses <paramref name="str" /> which is marked up with the Parses <paramref name="value" /> which is marked up with the
Pango text markup language, setting the label's text and Pango text markup language, setting the label's text and
attribute list based on the parse results. attribute list based on the parse results.
</para> </para>
@ -254,8 +279,7 @@
<ReturnValue> <ReturnValue>
<ReturnType>System.Boolean</ReturnType> <ReturnType>System.Boolean</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary>Toggles line wrapping within the GtkLabel widget.</summary> <summary>Toggles line wrapping within the GtkLabel widget.</summary>
<param name="value"> <param name="value">
@ -273,8 +297,7 @@
<ReturnValue> <ReturnValue>
<ReturnType>System.String</ReturnType> <ReturnType>System.String</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary>The text within the GtkLabel widget.</summary> <summary>The text within the GtkLabel widget.</summary>
<param name="value">The text you want to set.</param> <param name="value">The text you want to set.</param>
@ -293,11 +316,11 @@
<ReturnType>Pango.Layout</ReturnType> <ReturnType>Pango.Layout</ReturnType>
</ReturnValue> </ReturnValue>
<Docs> <Docs>
<summary>Gets the PangoLayout used to display the label.</summary> <summary>Gets the <see cref="T:Pango.Layout" /> used to display the label.</summary>
<returns> the PangoLayout for this label</returns> <returns> the <see cref="T:Pango.Layout" /> for this label</returns>
<remarks> <remarks>
<para> <para>
Gets the PangoLayout used to display the label. The layout Gets the <see cref="T:Pango.Layout" /> used to display the label. The layout
is useful to e.g. convert text positions to pixel is useful to e.g. convert text positions to pixel
positions, in combination with <see cref="M:Gtk.Label.GetLayoutOffset" />. The returned layout positions, in combination with <see cref="M:Gtk.Label.GetLayoutOffset" />. The returned layout
is owned by the label so need not be freed by the caller. is owned by the label so need not be freed by the caller.
@ -311,11 +334,10 @@
<ReturnValue> <ReturnValue>
<ReturnType>System.String</ReturnType> <ReturnType>System.String</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary> <summary>
Parses <paramref name="str" /> which is marked up with the Parses <paramref name="value" /> which is marked up with the
Pango text markup language, setting the label's text and Pango text markup language, setting the label's text and
attribute list based on the parse results. attribute list based on the parse results.
</summary> </summary>
@ -323,7 +345,7 @@
<returns>a new label widget</returns> <returns>a new label widget</returns>
<remarks> <remarks>
<para> <para>
Parses <paramref name="str" /> which is marked up with the Parses <paramref name="value" /> which is marked up with the
Pango text markup language, setting the label's text and Pango text markup language, setting the label's text and
attribute list based on the parse results. If characters attribute list based on the parse results. If characters
in str are preceded by an underscore, they are underlined in str are preceded by an underscore, they are underlined
@ -343,8 +365,7 @@
<ReturnValue> <ReturnValue>
<ReturnType>System.Boolean</ReturnType> <ReturnType>System.Boolean</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary>Toggle whether or not the label allow the user to select text from the label, for copy-and-paste.</summary> <summary>Toggle whether or not the label allow the user to select text from the label, for copy-and-paste.</summary>
<param name="value"> <param name="value">
@ -364,8 +385,7 @@
<ReturnValue> <ReturnValue>
<ReturnType>Gtk.Justification</ReturnType> <ReturnType>Gtk.Justification</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary>The alignment of the lines in the text of the label relative to each other</summary> <summary>The alignment of the lines in the text of the label relative to each other</summary>
<param name="value">a <see cref="T:Gtk.Justification" /></param> <param name="value">a <see cref="T:Gtk.Justification" /></param>
@ -388,9 +408,9 @@
<ReturnType>System.Int32</ReturnType> <ReturnType>System.Int32</ReturnType>
</ReturnValue> </ReturnValue>
<Docs> <Docs>
<summary>To be added</summary> <summary>The current position of the insertion cursor in characters.</summary>
<returns>To be added: an object of type 'int'</returns> <returns>The current position of the insertion cursor in characters</returns>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="SelectionBound"> <Member MemberName="SelectionBound">
@ -400,9 +420,9 @@
<ReturnType>System.Int32</ReturnType> <ReturnType>System.Int32</ReturnType>
</ReturnValue> </ReturnValue>
<Docs> <Docs>
<summary>To be added</summary> <summary>The position of the opposite end of the selection from the cursor in characters.</summary>
<returns>To be added: an object of type 'int'</returns> <returns>The position of the opposite end of the selection from the cursor in characters.</returns>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="MnemonicWidget"> <Member MemberName="MnemonicWidget">
@ -411,13 +431,12 @@
<ReturnValue> <ReturnValue>
<ReturnType>Gtk.Widget</ReturnType> <ReturnType>Gtk.Widget</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>The widget to be activated when the label's mnemonic key is pressed.</summary>
<param name="value">To be added: an object of type 'Gtk.Widget'</param> <param name="value">The widget to be activated when the label's mnemonic key is pressed.</param>
<returns>To be added: an object of type 'Gtk.Widget'</returns> <returns>The widget to be activated when the label's mnemonic key is pressed.</returns>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="LabelProp"> <Member MemberName="LabelProp">
@ -426,13 +445,12 @@
<ReturnValue> <ReturnValue>
<ReturnType>System.String</ReturnType> <ReturnType>System.String</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Thee text from a label widget including any embedded underlines indicating mnemonics and Pango markup.</summary>
<param name="value">To be added: an object of type 'string'</param> <param name="value">The text of the label widget</param>
<returns>To be added: an object of type 'string'</returns> <returns>The text of the label widget.</returns>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Pattern"> <Member MemberName="Pattern">
@ -441,13 +459,11 @@
<ReturnValue> <ReturnValue>
<ReturnType>System.String</ReturnType> <ReturnType>System.String</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>A string with _ characters in positions correspond to characters in the text to underline.</summary>
<param name="value">To be added: an object of type 'string'</param> <param name="value">A string with _ characters in positions correspond to characters in the text to underline.</param>
<returns>To be added: an object of type 'string'</returns> <remarks></remarks>
<remarks>To be added</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="MnemonicKeyval"> <Member MemberName="MnemonicKeyval">
@ -457,9 +473,9 @@
<ReturnType>System.UInt32</ReturnType> <ReturnType>System.UInt32</ReturnType>
</ReturnValue> </ReturnValue>
<Docs> <Docs>
<summary>To be added</summary> <summary>The mnemonic accelerator key for this label.</summary>
<returns>To be added: an object of type 'uint'</returns> <returns>The mnemonic accelerator key for this label.</returns>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Wrap"> <Member MemberName="Wrap">
@ -468,13 +484,13 @@
<ReturnValue> <ReturnValue>
<ReturnType>System.Boolean</ReturnType> <ReturnType>System.Boolean</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Whether lines should be wrapped if the text becomes too wide.</summary>
<param name="value">To be added: an object of type 'bool'</param> <param name="value">
<returns>To be added: an object of type 'bool'</returns> <see langword="true" /> to wrap lines</param>
<remarks>To be added</remarks> <returns>whether lines should be wrapped</returns>
<remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="UseUnderline"> <Member MemberName="UseUnderline">
@ -483,13 +499,19 @@
<ReturnValue> <ReturnValue>
<ReturnType>System.Boolean</ReturnType> <ReturnType>System.Boolean</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>
<param name="value">To be added: an object of type 'bool'</param> Whether an underline in the text indicates the next
<returns>To be added: an object of type 'bool'</returns> character should be used for the mnemonic accelerator key.
<remarks>To be added</remarks> </summary>
<param name="value">
<see langword="true" /> to use underline</param>
<returns>
Whether an underline in the text indicates the next
character should be used for the mnemonic accelerator key.
</returns>
<remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="UseMarkup"> <Member MemberName="UseMarkup">
@ -498,8 +520,7 @@
<ReturnValue> <ReturnValue>
<ReturnType>System.Boolean</ReturnType> <ReturnType>System.Boolean</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary>Whether the label's text is interpreted as marked up with the Pango text markup language.</summary> <summary>Whether the label's text is interpreted as marked up with the Pango text markup language.</summary>
<param name="value"> <param name="value">
@ -515,43 +536,57 @@
<ReturnValue> <ReturnValue>
<ReturnType>Pango.AttrList</ReturnType> <ReturnType>Pango.AttrList</ReturnType>
</ReturnValue> </ReturnValue>
<Parameters> <Parameters></Parameters>
</Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>The attribute list set on the label.</summary>
<param name="value">To be added: an object of type 'Pango.AttrList'</param> <param name="value">a <see cref="T:Pango.AttrList" /></param>
<returns>To be added: an object of type 'Pango.AttrList'</returns> <returns>the attribute list set on the label</returns>
<remarks>To be added</remarks> <remarks>
<para>
This function does not reflect attributes that come from
the labels markup (see <see cref="P:Gtk.Label.Markup" />). If you
want to get the effective attributes for the label, use
<see cref="T:Pango.Layout.Attribute" /> on the label's
<see cref="P:Gtk.Label.Layout" /> property.
</para>
<para></para>
</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="MoveCursor"> <Member MemberName="MoveCursor">
<MemberSignature Language="C#" Value="public event GtkSharp.MoveCursorHandler MoveCursor;" /> <MemberSignature Language="C#" Value="public event GtkSharp.MoveCursorHandler MoveCursor;" />
<MemberType>Event</MemberType> <MemberType>Event</MemberType>
<ReturnValue><ReturnType>GtkSharp.MoveCursorHandler</ReturnType></ReturnValue> <ReturnValue>
<ReturnType>GtkSharp.MoveCursorHandler</ReturnType>
</ReturnValue>
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary>Emitted when the cursor is moved.</summary>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="PopulatePopup"> <Member MemberName="PopulatePopup">
<MemberSignature Language="C#" Value="public event GtkSharp.PopulatePopupHandler PopulatePopup;" /> <MemberSignature Language="C#" Value="public event GtkSharp.PopulatePopupHandler PopulatePopup;" />
<MemberType>Event</MemberType> <MemberType>Event</MemberType>
<ReturnValue><ReturnType>GtkSharp.PopulatePopupHandler</ReturnType></ReturnValue> <ReturnValue>
<ReturnType>GtkSharp.PopulatePopupHandler</ReturnType>
</ReturnValue>
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary>Emitted when a right-click pop-up menu is displayed</summary>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="CopyClipboard"> <Member MemberName="CopyClipboard">
<MemberSignature Language="C#" Value="public event EventHandler CopyClipboard;" /> <MemberSignature Language="C#" Value="public event EventHandler CopyClipboard;" />
<MemberType>Event</MemberType> <MemberType>Event</MemberType>
<ReturnValue><ReturnType>System.EventHandler</ReturnType></ReturnValue> <ReturnValue>
<ReturnType>System.EventHandler</ReturnType>
</ReturnValue>
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary>Emitted when text is copied to the clipboard.</summary>
<remarks>To be added</remarks> <remarks></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName=".ctor"> <Member MemberName=".ctor">

4
sources/Gtk.metadata
View file

@ -283,6 +283,10 @@
<method>GetSelectionBounds</method> <method>GetSelectionBounds</method>
<method>GetLayoutOffsets</method> <method>GetLayoutOffsets</method>
</class> </class>
<class name="GtkLabel">
<method>GetSelectionBounds</method>
<method>GetLayoutOffsets</method>
</class>
<data> <data>
<attribute target="param"> <attribute target="param">
<filter level="type">gint*</filter> <filter level="type">gint*</filter>