ryujinx-archive/GtkSharp
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Fix typos, add info for Button

Browse source 
svn path=/trunk/gtk-sharp/; revision=15002
This commit is contained in:
John Luke 2003-05-30 04:30:12 +00:00
parent 53ed8e5386
commit 775cae7bb2
5 changed files with 98 additions and 65 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
doc/ChangeLog
View file

@ -1,3 +1,10 @@
2003-05-30 John Luke <jluke@cfl.rr.com>
* en/Gtk/ToggleButton.xml: Fix typo.
* en/Gtk/Progress.xml: Fix typo.
* en/Gtk/Tooltips.xml: Fix method signature.
* en/Gtk/Button.xml: Add some info.
2003-05-29 Lee Mallabone <gnome@fonicmonkey.net> 2003-05-29 Lee Mallabone <gnome@fonicmonkey.net>
* en/*Sharp/*.xml: Remove the internal void*.xml signal docs. * en/*Sharp/*.xml: Remove the internal void*.xml signal docs.

148
doc/en/Gtk/Button.xml
View file

@ -10,11 +10,46 @@
<summary>A widget that creates a signal when clicked on.</summary> <summary>A widget that creates a signal when clicked on.</summary>
<remarks> <remarks>
<para> <para>
The GtkButton widget is generally used to attach a function to that is called when the button is pressed. The various signals and how to use them are outlined below. The <see cref="T:Gtk.Button"/> widget is generally used to attach to a function that is called when the button is pressed.
</para> The <see cref="T:Gtk.Button"/> widget can hold any valid child widget.
<para> That is, it can hold most any other standard <see cref="T:Gtk.Widget" />. The most commonly used child is the <see cref="T:Gtk.Label" />.
The GtkButton widget can hold any valid child widget. That is it can hold most any other standard <see cref="T:Gtk.Widget" />. The most commonly used child is the <see cref="T:Gtk.Label" />.
</para> </para>
<example>
<code lang="C#">
using Gtk;
using GtkSharp;
using System;
public class ButtonApp {
public static int Main (string[] args)
{
Application.Init ();
Window win = new Window ("Button Tester");
win.DefaultSize = new Size (200, 150);
win.DeleteEvent += new DeleteEventHandler (Window_Delete);
Button btn = new Button ("Click Me");
btn.Clicked += new EventHandler (btn_click);
win.Add (btn);
win.ShowAll ();
Application.Run ();
return 0;
}
static void btn_click (object obj, EventArgs args)
{
Console.WriteLine ("Button Clicked");
}
static void Window_Delete (object obj, DeleteEventArgs args)
{
Application.Quit ();
args.RetVal = true;
}
}
</code>
</example>
</remarks> </remarks>
</Docs> </Docs>
<Base> <Base>
@ -43,8 +78,8 @@
<ReturnType>System.UInt32</ReturnType> <ReturnType>System.UInt32</ReturnType>
</ReturnValue> </ReturnValue>
<Docs> <Docs>
<summary>The GLib type for Gtk.Button.</summary> <summary>The <see cref="T:GLib.Type"/> for <see cref="T:Gtk.Button"/>.</summary>
<returns>The GLib type for the Gtk.Button <see langword="class" />.</returns> <returns>The <see cref="T:GLib.Type"/> for the <see cref="T:Gtk.Button"/> class.</returns>
<remarks /> <remarks />
</Docs> </Docs>
</Member> </Member>
@ -58,11 +93,11 @@
<Parameter Name="value" Type="System.Boolean" /> <Parameter Name="value" Type="System.Boolean" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>Gets or sets if wether the Button should use a <see cref="T:Gtk.Stock" /> or not.</summary> <summary>Whether the <see cref="T:Gtk.Button"/> should use a <see cref="T:Gtk.Stock" />.</summary>
<param name="value">Boolean value to select if the <param name="value">Boolean value to select if the
Button uses a <see cref="T:Gtk.Stock" /> or not.</param> <see cref="T:Gtk.Button"/> uses a <see cref="T:Gtk.Stock" /> or not.</param>
<returns>Gets a value indicating if the Button uses a <see cref="T:Gtk.Stock" />.</returns> <returns>Gets a value indicating if the <see cref="T:Gtk.Button"/> uses a <see cref="T:Gtk.Stock" />.</returns>
<remarks>It's possible to create a Button from <see cref="T:Gtk.Stock" />, which is recommended for consistency in Gnome <remarks>It's possible to create a <see cref="T:Gtk.Button"/> from <see cref="T:Gtk.Stock" />, which is recommended for consistency in <see cref="N:Gnome"/>
apps. They also provide a <see cref="T:Gtk.Label" /> and a key shortcut. apps. They also provide a <see cref="T:Gtk.Label" /> and a key shortcut.
</remarks> </remarks>
</Docs> </Docs>
@ -77,12 +112,10 @@
<Parameter Name="value" Type="System.Boolean" /> <Parameter Name="value" Type="System.Boolean" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>Gets or sets if the Button uses or not an embedded <summary>Indicates if a mnemonic is associated with the <see cref="T:Gtk.Button"/>.</summary>
underline in the Button <see cref="T:Gtk.Label" /> indicating if a <param name="value">Boolean value to select if the <see cref="T:Gtk.Button"/> uses
mnemonic is associated to the Button.</summary>
<param name="value">Boolean value to select if the Button uses
underline or not.</param> underline or not.</param>
<returns>Gets a value indicating if the Button uses underline <returns>Gets a value indicating if the <see cref="T:Gtk.Button"/> uses underline
or not.</returns> or not.</returns>
<remarks /> <remarks />
</Docs> </Docs>
@ -97,11 +130,11 @@
<Parameter Name="value" Type="Gtk.ReliefStyle" /> <Parameter Name="value" Type="Gtk.ReliefStyle" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>Gets or sets the <see cref="T:Gtk.ReliefStyle" /> for the Button.</summary> <summary>The <see cref="T:Gtk.ReliefStyle" /> for the <see cref="T:Gtk.Button"/>.</summary>
<param name="value">The <see cref="T:Gtk.ReliefStyle" /> for <param name="value">The <see cref="T:Gtk.ReliefStyle" /> for
the Button.</param> the <see cref="T:Gtk.Button"/>.</param>
<returns>An instance of <see cref="T:Gtk.ReliefStyle" /> that <returns>An instance of <see cref="T:Gtk.ReliefStyle" /> that
represents the relief style of the Button.</returns> represents the relief style of the <see cref="T:Gtk.Button"/>.</returns>
<remarks /> <remarks />
</Docs> </Docs>
</Member> </Member>
@ -115,12 +148,10 @@
<Parameter Name="value" Type="System.String" /> <Parameter Name="value" Type="System.String" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>Gets or sets the <see langword="string" /> used to be <summary>The text of the <see cref="T:Gtk.Label" /> in the <see cref="T:Gtk.Button"/>.</summary>
represented with a <see cref="T:Gtk.Label" /> contained by the <param name="value">A <see cref="T:System.String" /> to be used for
Button.</summary> the <see cref="T:Gtk.Button"/>'s <see cref="T:Gtk.Label" /></param>
<param name="value">A <see langword="string" /> to be used for <returns>The <see cref="T:System.String" /> contained by the <see cref="T:Gtk.Button"/>.</returns>
the Button's <see cref="T:Gtk.Label" /></param>
<returns>The <see langword="string" /> contained by the Button.</returns>
<remarks /> <remarks />
</Docs> </Docs>
</Member> </Member>
@ -131,7 +162,7 @@
<Parameters /> <Parameters />
<Docs> <Docs>
<summary> <summary>
<see langword="event" /> launched when the button is activated.</summary> Event launched when the <see cref="T:Gtk.Button"/> is activated.</summary>
<remarks /> <remarks />
</Docs> </Docs>
</Member> </Member>
@ -142,7 +173,7 @@
<Parameters /> <Parameters />
<Docs> <Docs>
<summary> <summary>
<see langword="event" /> launched when the button is clicked.</summary> Event launched when the <see cref="T:Gtk.Button"/> is clicked.</summary>
<remarks /> <remarks />
</Docs> </Docs>
</Member> </Member>
@ -153,8 +184,7 @@
<Parameters /> <Parameters />
<Docs> <Docs>
<summary> <summary>
<see langword="event" /> launched when the cursor Event launched when the cursor leaves the <see cref="T:Gtk.Button"/> area.</summary>
leaves the button area.</summary>
<remarks /> <remarks />
</Docs> </Docs>
</Member> </Member>
@ -165,7 +195,7 @@
<Parameters /> <Parameters />
<Docs> <Docs>
<summary> <summary>
<see langword="event" /> launched when the button is pressed.</summary> Event launched when the <see cref="T:Gtk.Button"/> is pressed.</summary>
<remarks /> <remarks />
</Docs> </Docs>
</Member> </Member>
@ -176,7 +206,7 @@
<Parameters /> <Parameters />
<Docs> <Docs>
<summary> <summary>
<see langword="event" /> launched when the button is released.</summary> Event launched when the <see cref="T:Gtk.Button"/> is released.</summary>
<remarks /> <remarks />
</Docs> </Docs>
</Member> </Member>
@ -187,8 +217,7 @@
<Parameters /> <Parameters />
<Docs> <Docs>
<summary> <summary>
<see langword="event" /> launched when the cursor Event launched when the cursor enters the <see cref="T:Gtk.Button"/> area.</summary>
enters the button area.</summary>
<remarks /> <remarks />
</Docs> </Docs>
</Member> </Member>
@ -201,7 +230,7 @@
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary>To be added</summary>
<returns>To be added: an object of type 'uint'</returns> <returns>an object of type <see cref="T:System.UInt32"/></returns>
<remarks>To be added</remarks> <remarks>To be added</remarks>
</Docs> </Docs>
</Member> </Member>
@ -216,8 +245,8 @@
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>To be added</summary>
<param name="label">To be added: an object of type 'string'</param> <param name="label">an object of type <see cref="T:System.String"/></param>
<returns>To be added: an object of type 'Gtk.Button'</returns> <returns>an object of type <see cref="T:Gtk.Button"/></returns>
<remarks>To be added</remarks> <remarks>To be added</remarks>
</Docs> </Docs>
</Member> </Member>
@ -232,8 +261,8 @@
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>To be added</summary>
<param name="stock_id">To be added: an object of type 'string'</param> <param name="stock_id">an object of type <see cref="System.String"/></param>
<returns>To be added: an object of type 'Gtk.Button'</returns> <returns>an object of type <see cref="T:Gtk.Button"/></returns>
<remarks>To be added</remarks> <remarks>To be added</remarks>
</Docs> </Docs>
</Member> </Member>
@ -245,8 +274,8 @@
</ReturnValue> </ReturnValue>
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary>Emits a <see cref="E:Gtk.Button.Left"/> signal to the given <see cref="T:Gtk.Button"/>.</summary>
<remarks>To be added</remarks> <remarks>Emits a <see cref="E:Gtk.Button.Left"/> signal to the given <see cref="T:Gtk.Button"/>.</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Press"> <Member MemberName="Press">
@ -257,8 +286,8 @@
</ReturnValue> </ReturnValue>
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary>Emits a <see cref="E:Gtk.Button.Pressed"/> signal to the given <see cref="T:Gtk.Button"/>.</summary>
<remarks>To be added</remarks> <remarks>Emits a <see cref="E:Gtk.Button.Pressed"/> signal to the given <see cref="T:Gtk.Button"/>.</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Release"> <Member MemberName="Release">
@ -269,8 +298,8 @@
</ReturnValue> </ReturnValue>
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary>Emits a <see cref="E:Gtk.Button.Released"/> signal to the given <see cref="T:Gtk.Button"/>.</summary>
<remarks>To be added</remarks> <remarks>Emits a <see cref="E:Gtk.Button.Released"/> signal to the given <see cref="T:Gtk.Button"/>.</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Click"> <Member MemberName="Click">
@ -281,8 +310,8 @@
</ReturnValue> </ReturnValue>
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary>Emits a <see cref="E:Gtk.Button.Clicked"/> signal to the given <see cref="T:Gtk.Button"/>.</summary>
<remarks>To be added</remarks> <remarks>Emits a <see cref="E:Gtk.Button.Clicked"/> signal to the given <see cref="T:Gtk.Button"/>.</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Enter"> <Member MemberName="Enter">
@ -293,8 +322,8 @@
</ReturnValue> </ReturnValue>
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>To be added</summary> <summary>Emits a <see cref="E:Gtk.Button.Entered"/> signal to the given <see cref="T:Gtk.Button"/>.</summary>
<remarks>To be added</remarks> <remarks>Emits a <see cref="E:Gtk.Button.Entered"/> signal to the given <see cref="T:Gtk.Button"/>.</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Finalize"> <Member MemberName="Finalize">
@ -319,8 +348,7 @@
<Docs> <Docs>
<summary>Internal constructor</summary> <summary>Internal constructor</summary>
<param name="gtype">GLib type for the type.</param> <param name="gtype">GLib type for the type.</param>
<returns>Creates a new instance of Button, using the GLib <returns>Creates a new instance of <see cref="T:Gtk.Button"/>, using the GLib provided type.</returns>
provided type.</returns>
<remarks>This is a constructor used by derivative types of <remarks>This is a constructor used by derivative types of
<see cref="T:Gtk.Button" /> that would have their own GLib type <see cref="T:Gtk.Button" /> that would have their own GLib type
assigned to it. This is not typically used by C# code.</remarks> assigned to it. This is not typically used by C# code.</remarks>
@ -333,9 +361,8 @@
<Parameters /> <Parameters />
<Docs> <Docs>
<summary>Default parameterless constructor.</summary> <summary>Default parameterless constructor.</summary>
<returns>An instance of type Gtk.Button.</returns> <returns>An instance of <see cref="T:Gtk.Button"/>.</returns>
<remarks>This is the default constructor for the Gtk.Button <remarks>This is the default constructor for the <see cref="T:Gtk.Button"/> class.</remarks>
<see langword="class" />.</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName=".ctor"> <Member MemberName=".ctor">
@ -346,13 +373,12 @@
<Parameter Name="label" Type="System.String" /> <Parameter Name="label" Type="System.String" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>Constructor that creates a labeled Button. The label <summary>Constructor that creates a labeled <see cref="T:Gtk.Button"/>.</summary>
shows the string passed as parameter.</summary> <param name="label">A <see cref="T:System.String" /> that will be
<param name="label">A <see langword="string" /> that will be used to create a <see cref="T:Gtk.Label" /> for the <see cref="T:Gtk.Button"/></param>
used to create a <see cref="T:Gtk.Label" /> for the Gtk.Button</param> <returns>A <see cref="T:Gtk.Button"/> containing a <see cref="T:Gtk.Label" />
<returns>A Gtk.Button containing a <see cref="T:Gtk.Label" /> with the specified <see cref="T:System.String"/>.</returns>
with the <see langword="string">string</see> passed.</returns> <remarks>Constructor that creates a labeled <see cref="T:Gtk.Button"/>. The label
<remarks>Constructor that creates a labeled button. The label
shows the string passed as parameter.</remarks> shows the string passed as parameter.</remarks>
</Docs> </Docs>
</Member> </Member>
@ -365,8 +391,8 @@
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>To be added</summary>
<param name="raw">To be added: an object of type 'IntPtr'</param> <param name="raw">an object of type <see cref="T:System.IntPtr"/></param>
<returns>To be added: an object of type 'Gtk.Button'</returns> <returns>an object of type <see cref="T:Gtk.Button"/></returns>
<remarks>To be added</remarks> <remarks>To be added</remarks>
</Docs> </Docs>
</Member> </Member>

2
doc/en/Gtk/Progress.xml
View file

@ -8,7 +8,7 @@
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement> <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
<Docs> <Docs>
<summary>The base class for <see cref="T:Gtk.ProgressBar"/>.</summary> <summary>The base class for <see cref="T:Gtk.ProgressBar"/>.</summary>
<remarks>A <see cref="T:Gtk.Progress"/> is the abstract base class used to derive a <see cref="T:Gtk.ProgressBar"/>which provides a visual representation of the progress of a long running operation.</remarks> <remarks>A <see cref="T:Gtk.Progress"/> is the abstract base class used to derive a <see cref="T:Gtk.ProgressBar"/> which provides a visual representation of the progress of a long running operation.</remarks>
</Docs> </Docs>
<Base> <Base>
<BaseTypeName>Gtk.Widget</BaseTypeName> <BaseTypeName>Gtk.Widget</BaseTypeName>

2
doc/en/Gtk/ToggleButton.xml
View file

@ -176,7 +176,7 @@ btn.Add(label);
<Docs> <Docs>
<summary>Creates a new <see cref="T:Gtk.ToggleButton" /> with a text label.</summary> <summary>Creates a new <see cref="T:Gtk.ToggleButton" /> with a text label.</summary>
<param name="label">a <see cref="T:System.String" /> containing the message to be placed in the toggle button.</param> <param name="label">a <see cref="T:System.String" /> containing the message to be placed in the toggle button.</param>
<returns>an object of type '<see cref="T:Gtk.ToggleButton" /></returns> <returns>an object of type <see cref="T:Gtk.ToggleButton" /></returns>
<remarks>Creates a new <see cref="T:Gtk.ToggleButton" /> with a text label. <remarks>Creates a new <see cref="T:Gtk.ToggleButton" /> with a text label.
<example> <example>
<code lang="C#">ToggleButton btn = new ToggleButton ("ToggleButton");</code> <code lang="C#">ToggleButton btn = new ToggleButton ("ToggleButton");</code>

2
doc/en/Gtk/Tooltips.xml
View file

@ -14,7 +14,7 @@
<para>An individual tooltip belongs to a group of tooltips. <para>An individual tooltip belongs to a group of tooltips.
A group is created by calling the constructor <see cref="C:Gtk.Tooltips()"/>. A group is created by calling the constructor <see cref="C:Gtk.Tooltips()"/>.
Every tooltip in the group can then be turned off with <see cref="M:Gtk.Tooltips.Disable()"/> and on with <see cref="M:Gtk.Tooltips.Enable()"/>.</para> Every tooltip in the group can then be turned off with <see cref="M:Gtk.Tooltips.Disable()"/> and on with <see cref="M:Gtk.Tooltips.Enable()"/>.</para>
<para>To assign a tip to a particular <see cref="T:Gtk.Widget"/>, <see cref="M:Gtk.Tooltips.SetTip(widget, string, string)"/> is used.</para> <para>To assign a tip to a particular <see cref="T:Gtk.Widget"/>, <see cref="M:Gtk.Tooltips.SetTip(Gtk.Widget,System.String,System.String)"/> is used.</para>
<para>Note: Tooltips can only be set on widgets which have their own X window. <para>Note: Tooltips can only be set on widgets which have their own X window.
To add a tooltip to a <see cref="T:Gtk.Widget"/> that does not have its own <see cref="T:Gtk.Window"/>, place the widget inside a <see cref="T:Gtk.EventBox"/> and add a tooltip to that instead.</para> To add a tooltip to a <see cref="T:Gtk.Widget"/> that does not have its own <see cref="T:Gtk.Window"/>, place the widget inside a <see cref="T:Gtk.EventBox"/> and add a tooltip to that instead.</para>
<para>The default appearance of all tooltips in a program is determined by the current Gtk theme that the user has selected.</para> <para>The default appearance of all tooltips in a program is determined by the current Gtk theme that the user has selected.</para>