GtkSharp/doc/en/Gtk/AboutDialog.xml

494 lines
24 KiB
XML

<Type Name="AboutDialog" FullName="Gtk.AboutDialog">
<TypeSignature Language="C#" Maintainer="auto" Value="public class AboutDialog : Gtk.Dialog" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit AboutDialog extends Gtk.Dialog" />
<AssemblyInfo>
<AssemblyName>gtk-sharp</AssemblyName>
<AssemblyPublicKey>[00 24 00 00 04 80 00 00 94 00 00 00 06 02 00 00 00 24 00 00 52 53 41 31 00 04 00 00 01 00 01 00 71 EB 6C 55 75 52 9C BF 72 44 F7 A6 EA 05 62 84 F9 EA E0 3B CF F2 CC 13 2C 9C 49 0A B3 09 EA B0 B5 6B CE 44 9D F5 03 D9 C0 A8 1E 52 05 85 CD BE 70 E2 FB 90 43 4B AC 04 FA 62 22 A8 00 98 B7 A1 A7 B3 AF 99 1A 41 23 24 BB 43 25 F6 B8 65 BB 64 EB F6 D1 C2 06 D5 73 2D DF BC 70 A7 38 9E E5 3E 0C 24 6E 32 79 74 1A D0 05 03 E4 98 42 E1 9B F3 7B 19 8B 40 21 26 CB 36 89 C2 EA 64 96 A4 7C B4]</AssemblyPublicKey>
</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>
<Base>
<BaseTypeName>Gtk.Dialog</BaseTypeName>
</Base>
<Interfaces>
</Interfaces>
<Docs>
<summary>This class extends <see cref="T:Gtk.Dialog" />, providing a dialog to show information about a program.</summary>
<remarks>
<para>
The <see cref="T:Gtk.AboutDialog" /> offers a simple way to display information about a program like its logo, name, copyright, website and license. It is also possible to give credits to the authors, documenters, translators and artists who have worked on the program. An about dialog is typically opened when the user selects the About option from the Help menu. All parts of the dialog are optional.
</para>
<para>
About dialogs often contain links and email addresses. <see cref="T:Gtk.AboutDialog" /> supports this by offering global hooks, which are called when the user clicks on a link or email address, see <see cref="M:Gtk.AboutDialog.SetEmailHook()" /> and <see cref="M:Gtk.AboutDialog.SetUrlHook()" />. Email addresses in the authors, documenters and artists properties are recognized by looking for &lt;user@host&gt;, URLs are recognized by looking for http://url, with url extending to the next space, tab or line break.
</para>
<!--
<para>
To make constructing a <see cref="T:Gtk.AboutDialog" /> as convenient as possible, you can use the function <see cref="M:Gtk.ShowAboutDialog()" /> which constructs and shows a dialog and keeps it around so that it can be shown again.
</para>-->
<example>
<para>The following example creates and shows a <see cref="T:Gtk.AboutDialog" /> from both assembly attributes and stored values.</para>
<code lang="C#">using Gtk;
using System.Reflection;
[assembly:AssemblyTitleAttribute ("About Dialog Example")]
[assembly:AssemblyVersionAttribute ("1.0.0.0")]
[assembly:AssemblyDescriptionAttribute (
"An example of the Gtk# AboutDialog using assembly attributes.")]
[assembly:AssemblyCopyrightAttribute("Copyright 2007 Brian Nickel")]
static public class AboutDialogExample
{
public static void Main ()
{
Application.Init ();
AboutDialog dialog = new AboutDialog ();
Assembly asm = Assembly.GetExecutingAssembly ();
dialog.Name = (asm.GetCustomAttributes (
typeof (AssemblyTitleAttribute), false) [0]
as AssemblyTitleAttribute).Title;
dialog.Version = asm.GetName ().Version.ToString ();
dialog.Comments = (asm.GetCustomAttributes (
typeof (AssemblyDescriptionAttribute), false) [0]
as AssemblyDescriptionAttribute).Description;
dialog.Copyright = (asm.GetCustomAttributes (
typeof (AssemblyCopyrightAttribute), false) [0]
as AssemblyCopyrightAttribute).Copyright;
dialog.License = license;
dialog.Authors = authors;
dialog.Run ();
}
private static string [] authors = new string [] {
"Brian Nickel &lt;name@domain.ext&gt;",
"Rupert T. Monkey &lt;name@domain.ext&gt;"
};
private static string license =
@"Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
""Software""), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED ""AS IS"", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.";
}</code>
</example>
</remarks>
<since version="Gtk# 2.6" />
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public AboutDialog ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs>
<summary>Constructs and initializes a new instance of <see cref="T:Gtk.AboutDialog" /> for the executing assembly.</summary>
<remarks>With no properties set, the <see cref="T:Gtk.AboutDialog" /> window will display only the name of the executing assembly.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public AboutDialog (IntPtr raw);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(native int raw) cil managed" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="raw" Type="System.IntPtr" />
</Parameters>
<Docs>
<param name="raw">A <see cref="T:System.IntPtr" /> pointing to the raw object to be managed by the new instance.</param>
<summary>Constructs and initializes a new instance of <see cref="T:Gtk.AboutDialog" /> using an existing unmanaged object as its base.</summary>
<remarks>This is not typically used by managed code. It is primarily used for enclosing an existing object, created by unmanaged code, in a managed wrapper.</remarks>
</Docs>
</Member>
<Member MemberName="ActivateLink">
<MemberSignature Language="C#" Value="public event Gtk.ActivateLinkHandler ActivateLink;" />
<MemberSignature Language="ILAsm" Value=".event class Gtk.ActivateLinkHandler ActivateLink" />
<MemberType>Event</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Signal("activate-link")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>Gtk.ActivateLinkHandler</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<since version="Gtk# 3.0" />
</Docs>
</Member>
<Member MemberName="Artists">
<MemberSignature Language="C#" Value="public string[] Artists { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string[] Artists" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("artists")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String[]</ReturnType>
</ReturnValue>
<Docs>
<summary>Gets and sets the list of people who contributed artwork to the program.</summary>
<value>A <see cref="T:System.String[]" /> containing the list of people who contributed artwork to the program.</value>
<remarks>Each string may contain email addresses and URLs, which will be displayed as links. See the remarks on <see cref="T:Gtk.AboutDialog" /> for more details.</remarks>
</Docs>
</Member>
<Member MemberName="Authors">
<MemberSignature Language="C#" Value="public string[] Authors { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string[] Authors" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("authors")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String[]</ReturnType>
</ReturnValue>
<Docs>
<summary>Gets and sets the list of people who authored the program.</summary>
<value>A <see cref="T:System.String[]" /> containing the list of people who authored the program.</value>
<remarks>Each string may contain email addresses and URLs, which will be displayed as links. See the remarks on <see cref="T:Gtk.AboutDialog" /> for more details.</remarks>
</Docs>
</Member>
<Member MemberName="Comments">
<MemberSignature Language="C#" Value="public string Comments { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Comments" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("comments")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Gets and sets a comment about the program to appear immediately below the program name in the dialog.</summary>
<value>A <see cref="T:System.String" /> object containing a comment, description, or subtitle for the program.</value>
<remarks>
<para>If unset, no comment text is displayed.</para>
<para>This string is displayed in a label in the main dialog, thus it should be a short explanation of the main purpose of the program, not a detailed list of features.</para>
</remarks>
</Docs>
</Member>
<Member MemberName="Copyright">
<MemberSignature Language="C#" Value="public string Copyright { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Copyright" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("copyright")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Gets and sets copyright information for the program.</summary>
<value>A <see cref="T:System.String" /> object containing copyright information for the program.</value>
<remarks>
<para>The copyright text appears below the <see cref="T:Gtk.AboutDialog.Comments" /> text and above the <see cref="T:Gtk.AboutDialog.Website" /> link on the dialog. If unset, not copyright text will appear.</para>
</remarks>
</Docs>
</Member>
<Member MemberName="Documenters">
<MemberSignature Language="C#" Value="public string[] Documenters { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string[] Documenters" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("documenters")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String[]</ReturnType>
</ReturnValue>
<Docs>
<summary>Gets and sets the list of people who contributed documentation to the program.</summary>
<value>A <see cref="T:System.String[]" /> containing the list of people who contributed documentation to the program.</value>
<remarks>Each string may contain email addresses and URLs, which will be displayed as links. See the remarks on <see cref="T:Gtk.AboutDialog" /> for more details.</remarks>
</Docs>
</Member>
<Member MemberName="GType">
<MemberSignature Language="C#" Value="public static GLib.GType GType { get; }" />
<MemberSignature Language="ILAsm" Value=".property valuetype GLib.GType GType" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>GLib.GType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Gets the GLib type of the current instance.</summary>
<value>A <see cref="T:GLib.GType" /> value representing the native GLib type of <see cref="T:Gtk.AboutDialog" />.</value>
<remarks>The value is used internally by the GLib type management system.</remarks>
</Docs>
</Member>
<Member MemberName="License">
<MemberSignature Language="C#" Value="public string License { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string License" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("license")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Gets and sets the license text of the program.</summary>
<value>A <see cref="T:System.String" /> object containing the license text to display with the current instance.</value>
<remarks>This string is displayed in a text view in a secondary dialog, therefore it is fine to use a long multi-paragraph text. Note that by default the text is not wrapped in the text view, thus it must contain the intended linebreaks.</remarks>
</Docs>
</Member>
<Member MemberName="LicenseType">
<MemberSignature Language="C#" Value="public Gtk.License LicenseType { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype Gtk.License LicenseType" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("license-type")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>Gtk.License</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<since version="Gtk# 3.0" />
</Docs>
</Member>
<Member MemberName="Logo">
<MemberSignature Language="C#" Value="public Gdk.Pixbuf Logo { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class Gdk.Pixbuf Logo" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("logo")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>Gdk.Pixbuf</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Gets and sets a logo to display above the program name in the dialog.</summary>
<value>A <see cref="T:Gdk.Pixbuf" /> object containing a logo to display above the program name in the dialog.</value>
<remarks>
<para>
<block subset="none" type="note">The prefered way to set the logo is through <see cref="P:Gtk.Logo.LogoIconName" />.</block>
</para>
<para>If this is not set, it defaults to <see cref="P:Gtk.Window.DefaultIconList()" />.</para>
</remarks>
</Docs>
</Member>
<Member MemberName="LogoIconName">
<MemberSignature Language="C#" Value="public string LogoIconName { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string LogoIconName" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("logo-icon-name")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Gets and sets the name of the logo icon to display above the program name in the dialog.</summary>
<value>A <see cref="T:System.String" /> object containing the name of the logo icon to display above the program name in the dialog.</value>
<remarks>
<block subset="none" type="note">
If set, this property overrides the <see cref="P:Gtk.AboutDialog.Logo" /> property.
</block>
<para>The name should be equal to the name of the program, without any sort of extension, eg. <c>"monodoc"</c>. The dialog will use that name to load an icon by trying the following:</para>
<list type="number">
<item>
<term>The current icon theme, eg. <c>"/usr/share/icons/Tango/48x48/apps/monodoc.png"</c>.</term>
</item>
<item>
<term>The pixmap directory, eg. <c>"/usr/share/pixmaps/monodoc.png"</c></term>
</item>
<item>
<term>The broken image icon.</term>
</item>
</list>
</remarks>
</Docs>
</Member>
<Member MemberName="OnActivateLink">
<MemberSignature Language="C#" Value="protected virtual bool OnActivateLink (string uri);" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig newslot virtual instance bool OnActivateLink(string uri) cil managed" />
<MemberType>Method</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.DefaultSignalHandler(ConnectionMethod="OverrideActivateLink", Type=typeof(Gtk.AboutDialog))</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="uri" Type="System.String" />
</Parameters>
<Docs>
<param name="uri">To be added.</param>
<summary>Default handler for the <see cref="M:Gtk.AboutDialog.ActivateLink" /> event.</summary>
<returns>To be added.</returns>
<remarks>Override this method in a subclass to provide a default handler for the <see cref="M:Gtk.AboutDialog.ActivateLink" /> event.</remarks>
<since version="Gtk# 3.0" />
</Docs>
</Member>
<Member MemberName="ProgramName">
<MemberSignature Language="C#" Value="public string ProgramName { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string ProgramName" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("program-name")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>Program Name property.</summary>
<value>The name of the program.</value>
<remarks />
<since version="Gtk# 2.12" />
</Docs>
</Member>
<Member MemberName="TranslatorCredits">
<MemberSignature Language="C#" Value="public string TranslatorCredits { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string TranslatorCredits" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("translator-credits")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Gets and sets credits for the translation of the program.</summary>
<value>A <see cref="T:System.String" /> object containing credits for the translation of the program.</value>
<remarks>This string should be marked as translatable. Each string may contain email addresses and URLs, which will be displayed as links. See the remarks on <see cref="T:Gtk.AboutDialog" /> for more details.</remarks>
</Docs>
</Member>
<Member MemberName="Version">
<MemberSignature Language="C#" Value="public string Version { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Version" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("version")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Get and set the version of the program.</summary>
<value>A <see cref="T:System.String" /> object containing the version of the program.</value>
<remarks>The most appropriate value to put here would be the assembly version, but any string is valid, eg "2.0.0.1", "2.5.3", "2.0 RC1", etc.</remarks>
</Docs>
</Member>
<Member MemberName="Website">
<MemberSignature Language="C#" Value="public string Website { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string Website" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("website")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Gets and sets the URL of the program's website.</summary>
<value>A <see cref="T:System.String" /> containing the URL of the program's website.</value>
<remarks>
<para>The value should be a string starting with "http://". If set, the link is displayed at the bottom of the dialog, however if <see cref="M:Gtk.AboutDialog.SetUriHook" /> has not been used, the URL will appear as plain text and not be clickable.</para>
<para>
<block subset="none" type="note">
<see cref="P:Gtk.AboutDialog.WebsiteLabel" /> may be used to provide a plain-text label for the link.</block>
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="WebsiteLabel">
<MemberSignature Language="C#" Value="public string WebsiteLabel { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance string WebsiteLabel" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("website-label")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Gets and sets the text label to display for the link to <see cref="P:Gtk.AboutDialog.Website" />.</summary>
<value>A <see cref="T:System.String" /> containing the text label to display for the link to <see cref="P:Gtk.AboutDialog.Website" />.</value>
<remarks>This value is used to provide a user friendly link to the website, for example <c>"Visit home page."</c> or <c>"AppName website"</c>. If not set, the link defaults to the URL specified in the <see cref="P:Gtk.AboutDialog.Website" /> property.</remarks>
</Docs>
</Member>
<Member MemberName="WrapLicense">
<MemberSignature Language="C#" Value="public bool WrapLicense { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool WrapLicense" />
<MemberType>Property</MemberType>
<Attributes>
<Attribute>
<AttributeName>GLib.Property("wrap-license")</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<summary>Gets and sets whether the text in the <see cref="P:Gtk.AboutDialog.License" /> is to be automatically wrapped.</summary>
<value>If <see langword="true" />, the text is auto-wrapped. Otherwise long lines of text will extend past the edge of the frame and a horizontal scroll bar will appear.</value>
<remarks>By default, this option is set to <see langword="false" />. Most standard licenses, as will be found in the LICENSE file of a package, are already manually wrapped and auto-wrapping is unneccessary an unwanted.</remarks>
<since version="Gtk# 2.8" />
</Docs>
</Member>
</Members>
</Type>