GtkSharp/doc/en/Gnome/About.xml

312 lines
12 KiB
XML
Raw Normal View History

<Type Name="About" FullName="Gnome.About">
<TypeSignature Language="C#" Maintainer="John Luke" Value="public class About : Gtk.Dialog" />
<AssemblyInfo>
<AssemblyName>gnome-sharp</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>2.6.0.0</AssemblyVersion>
</AssemblyInfo>
<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>
<summary>Display author, documenter and translator credits for an application.</summary>
<remarks>
<para>The <see cref="T:Gnome.About" /> widget is used as the standard way of displaying credits in an application.
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>
<para>NOTE: The <see cref="T:Gnome.About" /> widget is destroyed automatically when the close event is called. Therefore, it is not possible to use the same <see cref="T:Gnome.About" /> more than once.</para>
<para>Compile the following example with: mcs GnomeAboutSample.cs -r gtk-sharp -r gnome-sharp -r gdk-sharp</para>
</remarks>
<example>
<code language="C#">
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>
</example>
</Docs>
<Base>
<BaseTypeName>Gtk.Dialog</BaseTypeName>
</Base>
<Interfaces>
</Interfaces>
<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>
<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>
<Docs>
<summary>Construct a credits box for an <see cref="T:Gnome.Application" />.</summary>
<param name="name">a <see cref="T:System.String" /></param>
<param name="version">a <see cref="T:System.String" /></param>
<param name="copyright">a <see cref="T:System.String" /></param>
<param name="comments">a <see cref="T:System.String" /></param>
<param name="authors">a <see cref="T:System.String" /></param>
<param name="documenters">a <see cref="T:System.String" /></param>
<param name="translator_credits">a <see cref="T:System.String" /></param>
<param name="logo_pixbuf">a <see cref="T:Gdk.Pixbuf" /></param>
<remarks>The <paramref name="authors" /> array cannot be empty.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public About (IntPtr raw);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="raw" Type="System.IntPtr" />
</Parameters>
<Docs>
<summary>Internal constructor</summary>
<param name="raw">Pointer to the C object.</param>
<remarks>
<para>This is an internal constructor, and should not be used by user code.</para>
</remarks>
</Docs>
</Member>
<Member MemberName="Name">
<MemberSignature Language="C#" Value="public string Name { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The name of the application.</summary>
<value>an object of type <see cref="T:System.String" /></value>
<remarks />
</Docs>
<Attributes>
<Attribute>
<AttributeName>GLib.Property(Name="name")</AttributeName>
</Attribute>
</Attributes>
</Member>
<Member MemberName="TranslatorCredits">
<MemberSignature Language="C#" Value="public string TranslatorCredits { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The translator for the current locale.</summary>
<value>an object of type <see cref="T:System.String" /></value>
<remarks />
</Docs>
<Attributes>
<Attribute>
<AttributeName>GLib.Property(Name="translator_credits")</AttributeName>
</Attribute>
</Attributes>
</Member>
<Member MemberName="Copyright">
<MemberSignature Language="C#" Value="public string Copyright { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary> The copyright statement of the application.</summary>
<value>an object of type <see cref="T:System.String" /></value>
<remarks />
</Docs>
<Attributes>
<Attribute>
<AttributeName>GLib.Property(Name="copyright")</AttributeName>
</Attribute>
</Attributes>
</Member>
<Member MemberName="Logo">
<MemberSignature Language="C#" Value="public Gdk.Pixbuf Logo { set; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gdk.Pixbuf</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary> The logo for the application.</summary>
<value>an object of type <see cref="T:Gdk.Pixbuf" /></value>
<remarks />
</Docs>
<Attributes>
<Attribute>
<AttributeName>GLib.Property(Name="logo")</AttributeName>
</Attribute>
</Attributes>
</Member>
<Member MemberName="Version">
<MemberSignature Language="C#" Value="public string Version { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The version string of the application.</summary>
<value>an object of type <see cref="T:System.String" /></value>
<remarks />
</Docs>
<Attributes>
<Attribute>
<AttributeName>GLib.Property(Name="version")</AttributeName>
</Attribute>
</Attributes>
</Member>
<Member MemberName="Comments">
<MemberSignature Language="C#" Value="public string Comments { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>A short miscellaneous string.</summary>
<value>an object of type <see cref="T:System.String" /></value>
<remarks />
</Docs>
<Attributes>
<Attribute>
<AttributeName>GLib.Property(Name="comments")</AttributeName>
</Attribute>
</Attributes>
</Member>
<Member MemberName="GType">
<MemberSignature Language="C#" Value="public static GLib.GType GType { get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>GLib.GType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>GType Property.</summary>
<value>a <see cref="T:GLib.GType" /></value>
<remarks>Returns the native <see cref="T:GLib.GType" /> value for <see cref="T:Gnome.About" />.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected About (GLib.GType gtype);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="gtype" Type="GLib.GType" />
</Parameters>
<Docs>
<summary>Protected Constructor.</summary>
<param name="gtype">a <see cref="T:GLib.GType" /></param>
<remarks>Chain to this constructor if you have manually registered a native <see cref="T:GLib.GType" /> value for your subclass.</remarks>
</Docs>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete(Message=null, IsError=False)</AttributeName>
</Attribute>
</Attributes>
</Member>
<Member MemberName=".ctor">
<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);" />
<MemberType>Constructor</MemberType>
<Parameters>
<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>
<Docs>
<param name="name">To be added.</param>
<param name="version">To be added.</param>
<param name="copyright">To be added.</param>
<param name="comments">To be added.</param>
<param name="authors">To be added.</param>
<param name="documenters">To be added.</param>
<param name="translator_credits">To be added.</param>
<param name="logo_pixbuf">To be added.</param>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
</Members>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete(Message=null, IsError=False)</AttributeName>
</Attribute>
</Attributes>
</Type>