2003-02-12 02:14:42 +00:00
<Type Name= "About" FullName= "Gnome.About" >
2003-07-17 03:39:14 +00:00
<TypeSignature Language= "C#" Value= "public class About : Gtk.Dialog, Implementor, IWrapper, IWrapper, IDisposable" Maintainer= "John Luke" />
2003-02-12 02:14:42 +00:00
<AssemblyInfo >
<AssemblyName > gnome-sharp</AssemblyName>
<AssemblyVersion > 0.0.0.0</AssemblyVersion>
<Attributes />
</AssemblyInfo>
2003-02-23 07:26:30 +00:00
<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>
2003-02-12 02:14:42 +00:00
<Docs >
2003-07-17 03:39:14 +00:00
<summary > Display author, documenter and translator credits for an application.</summary>
<remarks >
2003-07-17 06:38:40 +00:00
<para > The <see cref= "T:Gnome.About" /> widget is used as the standard way of displaying credits in an application.
2003-07-17 03:39:14 +00:00
Typically, it will be called when a user selects the About... option from the Help menu.
With one simple function call, the application can then display all of the appropriate information.</para>
2003-07-17 06:38:40 +00:00
<para > Compile the following example with: mcs GnomeAboutSample.cs -r gtk-sharp -r gnome-sharp -r gdk-sharp</para>
</remarks>
<example >
<code language= "C#" >
2003-07-17 03:39:14 +00:00
using System;
using Gtk;
using GtkSharp;
using Gnome;
class GnomeAboutSample
{
About ab;
Program program;
static void Main(string[] args)
{
new GnomeAboutSample(args);
}
GnomeAboutSample (string[] args)
{
program =
new Program("GnomeAboutSample", "0.1", Gnome.Modules.UI , args);
App app = new App("sample", "sample");
app.SetDefaultSize (250, 250);
app.DeleteEvent += new DeleteEventHandler (on_app_delete);
Button btn = new Button ("Show About");
btn.Clicked += new EventHandler (on_btn_clicked);
app.Contents = btn;
app.ShowAll();
program.Run();
}
private void on_btn_clicked (object obj, EventArgs args)
{
string[] authors = {"The Author", "Co-Author"};
string[] documenters = {"The Documenters", "Another Documenter"};
Gdk.Pixbuf pixbuf = new Gdk.Pixbuf ("MonoIcon.png");
ab = new Gnome.About ("GnomeAboutTest", "0.1", "Copyright", "Comments",
authors, documenters, "translator", pixbuf);
ab.Close += new EventHandler (OnAboutClose);
ab.Response += new ResponseHandler (OnAboutResponse);
ab.Run ();
}
private void OnAboutClose (object o, EventArgs args)
{
Console.WriteLine ("Close Event");
}
private void OnAboutResponse(object o, ResponseArgs args)
{
Console.WriteLine (args.ResponseId);
}
private void on_app_delete (object o, DeleteEventArgs args)
{
program.Quit ();
}
}
</code>
2003-07-17 06:38:40 +00:00
</example>
2003-02-12 02:14:42 +00:00
</Docs>
<Base >
<BaseTypeName > Gtk.Dialog</BaseTypeName>
</Base>
<Interfaces >
<Interface >
<InterfaceName > Atk.Implementor</InterfaceName>
</Interface>
<Interface >
<InterfaceName > GLib.IWrapper</InterfaceName>
</Interface>
<Interface >
<InterfaceName > GLib.IWrapper</InterfaceName>
</Interface>
<Interface >
<InterfaceName > System.IDisposable</InterfaceName>
</Interface>
</Interfaces>
<Attributes />
<Members >
<Member MemberName= "Construct" >
<MemberSignature Language= "C#" Value= "public void Construct (string name, string version, string copyright, string comments, string authors, string documenters, string translator_credits, Gdk.Pixbuf logo_pixbuf);" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > System.Void</ReturnType>
</ReturnValue>
<Parameters >
2003-07-21 00:13:00 +00:00
<Parameter Name= "name" Type= "System.String" />
<Parameter Name= "version" Type= "System.String" />
<Parameter Name= "copyright" Type= "System.String" />
<Parameter Name= "comments" Type= "System.String" />
<Parameter Name= "authors" Type= "System.String" />
<Parameter Name= "documenters" Type= "System.String" />
<Parameter Name= "translator_credits" Type= "System.String" />
<Parameter Name= "logo_pixbuf" Type= "Gdk.Pixbuf" />
</Parameters>
2003-02-12 02:14:42 +00:00
<Docs >
2003-07-17 06:38:40 +00:00
<summary > Construct a credits box for an <see cref= "T:Gnome.Application" /> .</summary>
<param name= "name" > an object of type <see cref= "T:System.String" /> </param>
<param name= "version" > an object of type <see cref= "T:System.String" /> </param>
<param name= "copyright" > an object of type <see cref= "T:System.String" /> </param>
<param name= "comments" > an object of type <see cref= "T:System.String" /> </param>
<param name= "authors" > an object of type <see cref= "T:System.String" /> </param>
<param name= "documenters" > an object of type <see cref= "T:System.String" /> </param>
<param name= "translator_credits" > an object of type <see cref= "T:System.String" /> </param>
<param name= "logo_pixbuf" > an object of type <see cref= "T:Gdk.Pixbuf" /> </param>
<remarks > The <paramref name= "authors" /> array cannot be empty.</remarks>
2003-02-12 02:14:42 +00:00
</Docs>
</Member>
<Member MemberName= "Finalize" >
<MemberSignature Language= "C#" Value= "protected virtual void Finalize ();" />
<MemberType > Method</MemberType>
<ReturnValue >
<ReturnType > System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs >
2003-02-23 07:26:30 +00:00
<summary > Disposes the resources associated with the object.</summary>
<remarks />
2003-02-12 02:14:42 +00:00
</Docs>
</Member>
<Member MemberName= ".ctor" >
<MemberSignature Language= "C#" Value= "public About (IntPtr raw);" />
<MemberType > Constructor</MemberType>
<ReturnValue />
<Parameters >
2003-07-21 00:13:00 +00:00
<Parameter Name= "raw" Type= "System.IntPtr" />
</Parameters>
2003-02-12 02:14:42 +00:00
<Docs >
2003-02-23 07:26:30 +00:00
<summary > Internal constructor</summary>
<param name= "raw" > Pointer to the C object.</param>
<returns > An instance of About, wrapping the C object.</returns>
<remarks >
<para > This is an internal constructor, and should not be used by user code.</para>
</remarks>
2003-02-12 02:14:42 +00:00
</Docs>
</Member>
<Member MemberName= ".ctor" >
2003-03-25 23:49:54 +00:00
<MemberSignature Language= "C#" Value= "public About (string name, string version, string copyright, string comments, string [] authors, string [] documenters, string translator_credits, Gdk.Pixbuf logo_pixbuf);" />
2003-02-12 02:14:42 +00:00
<MemberType > Constructor</MemberType>
<ReturnValue />
<Parameters >
2003-07-21 00:13:00 +00:00
<Parameter Name= "name" Type= "System.String" />
<Parameter Name= "version" Type= "System.String" />
<Parameter Name= "copyright" Type= "System.String" />
<Parameter Name= "comments" Type= "System.String" />
<Parameter Name= "authors" Type= "System.String []" />
<Parameter Name= "documenters" Type= "System.String []" />
<Parameter Name= "translator_credits" Type= "System.String" />
<Parameter Name= "logo_pixbuf" Type= "Gdk.Pixbuf" />
</Parameters>
2003-02-12 02:14:42 +00:00
<Docs >
2003-07-17 06:38:40 +00:00
<summary > Creates a new instance of <see cref= "Gnome.About" /> .</summary>
<param name= "name" > an object of type <see cref= "T:System.String" /> </param>
<param name= "version" > an object of type <see cref= "T:System.String" /> </param>
<param name= "copyright" > an object of type <see cref= "T:System.String" /> </param>
<param name= "comments" > an object of type <see cref= "T:System.String" /> </param>
<param name= "authors" > an object of type <see cref= "T:System.String []" /> </param>
<param name= "documenters" > an object of type <see cref= "T:System.String []" /> </param>
<param name= "translator_credits" > an object of type <see cref= "T:System.String" /> </param>
<param name= "logo_pixbuf" > an object of type <see cref= "T:Gdk.Pixbuf" /> </param>
<returns > an object of type <see cref= "T:Gnome.About" /> </returns>
2003-07-17 03:39:14 +00:00
<remarks />
2003-02-12 02:14:42 +00:00
</Docs>
</Member>
<Member MemberName= ".ctor" >
<MemberSignature Language= "C#" Value= "protected About ();" />
<MemberType > Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs >
2003-07-17 06:38:40 +00:00
<summary > Creates a new instance of <see cref= "T:Gnome.About" /> </summary>
<returns > an object of type <see cref= "T:Gnome.About" /> </returns>
2003-07-17 03:39:14 +00:00
<remarks > This is an internal constructor, and should not be used by user code.</remarks>
2003-02-12 02:14:42 +00:00
</Docs>
</Member>
<Member MemberName= "GType" >
<MemberSignature Language= "C#" Value= "public static uint GType { get; };" />
<MemberType > Property</MemberType>
<ReturnValue >
<ReturnType > System.UInt32</ReturnType>
</ReturnValue>
<Docs >
2003-07-17 06:38:40 +00:00
<summary > The <see cref= "T:GLib.Type" /> for <see cref= "T:Gnome.About" /> </summary>
<returns > The <see cref= "T:GLib.Type" /> for the <see cref= "T:Gnome.About" /> class.</returns>
2003-02-23 07:26:30 +00:00
<remarks />
2003-02-12 02:14:42 +00:00
</Docs>
</Member>
<Member MemberName= "Name" >
<MemberSignature Language= "C#" Value= "public string Name { set; get; };" />
<MemberType > Property</MemberType>
<ReturnValue >
<ReturnType > System.String</ReturnType>
</ReturnValue>
<Parameters >
2003-07-21 00:13:00 +00:00
</Parameters>
2003-02-12 02:14:42 +00:00
<Docs >
2003-07-17 03:39:14 +00:00
<summary > The name of the application.</summary>
2003-07-17 06:38:40 +00:00
<param name= "value" > an object of type <see cref= "T:System.String" /> </param>
<returns > an object of type <see cref= "T:System.String" /> </returns>
2003-07-17 03:39:14 +00:00
<remarks />
2003-02-12 02:14:42 +00:00
</Docs>
</Member>
<Member MemberName= "TranslatorCredits" >
<MemberSignature Language= "C#" Value= "public string TranslatorCredits { set; get; };" />
<MemberType > Property</MemberType>
<ReturnValue >
<ReturnType > System.String</ReturnType>
</ReturnValue>
<Parameters >
2003-07-21 00:13:00 +00:00
</Parameters>
2003-02-12 02:14:42 +00:00
<Docs >
2003-07-17 03:39:14 +00:00
<summary > The translator for the current locale.</summary>
2003-07-17 06:38:40 +00:00
<param name= "value" > an object of type <see cref= "T:System.String" /> </param>
<returns > an object of type <see cref= "T:System.String" /> </returns>
2003-07-17 03:39:14 +00:00
<remarks />
2003-02-12 02:14:42 +00:00
</Docs>
</Member>
<Member MemberName= "Copyright" >
<MemberSignature Language= "C#" Value= "public string Copyright { set; get; };" />
<MemberType > Property</MemberType>
<ReturnValue >
<ReturnType > System.String</ReturnType>
</ReturnValue>
<Parameters >
2003-07-21 00:13:00 +00:00
</Parameters>
2003-02-12 02:14:42 +00:00
<Docs >
2003-07-17 03:39:14 +00:00
<summary > The copyright statement of the application.</summary>
2003-07-17 06:38:40 +00:00
<param name= "value" > an object of type <see cref= "T:System.String" /> </param>
<returns > an object of type <see cref= "T:System.String" /> </returns>
2003-07-17 03:39:14 +00:00
<remarks />
2003-02-12 02:14:42 +00:00
</Docs>
</Member>
<Member MemberName= "Logo" >
<MemberSignature Language= "C#" Value= "public Gdk.Pixbuf Logo { set; };" />
<MemberType > Property</MemberType>
<ReturnValue >
<ReturnType > Gdk.Pixbuf</ReturnType>
</ReturnValue>
<Parameters >
2003-07-21 00:13:00 +00:00
</Parameters>
2003-02-12 02:14:42 +00:00
<Docs >
2003-07-17 03:39:14 +00:00
<summary > The logo for the application.</summary>
2003-07-17 06:38:40 +00:00
<param name= "value" > an object of type <see cref= "T:Gdk.Pixbuf" /> </param>
<returns > an object of type <see cref= "T:Gdk.Pixbuf" /> </returns>
2003-07-17 03:39:14 +00:00
<remarks />
2003-02-12 02:14:42 +00:00
</Docs>
</Member>
<Member MemberName= "Version" >
<MemberSignature Language= "C#" Value= "public string Version { set; get; };" />
<MemberType > Property</MemberType>
<ReturnValue >
<ReturnType > System.String</ReturnType>
</ReturnValue>
<Parameters >
2003-07-21 00:13:00 +00:00
</Parameters>
2003-02-12 02:14:42 +00:00
<Docs >
2003-07-17 03:39:14 +00:00
<summary > The version string of the application.</summary>
2003-07-17 06:38:40 +00:00
<param name= "value" > an object of type <see cref= "T:System.String" /> </param>
<returns > an object of type <see cref= "T:System.String" /> </returns>
2003-07-17 03:39:14 +00:00
<remarks />
2003-02-12 02:14:42 +00:00
</Docs>
</Member>
<Member MemberName= "Comments" >
<MemberSignature Language= "C#" Value= "public string Comments { set; get; };" />
<MemberType > Property</MemberType>
<ReturnValue >
<ReturnType > System.String</ReturnType>
</ReturnValue>
<Parameters >
2003-07-21 00:13:00 +00:00
</Parameters>
2003-02-12 02:14:42 +00:00
<Docs >
2003-07-17 03:39:14 +00:00
<summary > A short miscellaneous string.</summary>
2003-07-17 06:38:40 +00:00
<param name= "value" > an object of type <see cref= "T:System.String" /> </param>
<returns > an object of type <see cref= "T:System.String" /> </returns>
2003-07-17 03:39:14 +00:00
<remarks />
2003-02-12 02:14:42 +00:00
</Docs>
</Member>
2003-03-07 01:30:00 +00:00
<Member MemberName= ".ctor" >
<MemberSignature Language= "C#" Value= "protected About (GLib.Type gtype);" />
<MemberType > Constructor</MemberType>
<ReturnValue />
<Parameters >
2003-07-21 00:13:00 +00:00
<Parameter Name= "gtype" Type= "GLib.Type" />
</Parameters>
2003-03-07 01:30:00 +00:00
<Docs >
<summary > Internal constructor</summary>
<param name= "gtype" > GLib type for the type</param>
<returns > Creates a new instance of About, using the GLib-provided type</returns>
<remarks >
<para > This is a constructor used by derivative types of <see cref= "T:Gnome.About" /> that would have their own GLib type assigned to it. This is not typically used by C# code.</para>
</remarks>
</Docs>
</Member>
2003-02-12 02:14:42 +00:00
</Members>
2003-07-21 00:13:00 +00:00
</Type>