GtkSharp/doc/en/Gnome/Help.xml

<Type Name="Help" FullName="Gnome.Help">
  <TypeSignature Language="C#" Value="public class Help" Maintainer="John Luke" />
  <AssemblyInfo>
    <AssemblyName>gnome-sharp</AssemblyName>
    <AssemblyPublicKey />
    <AssemblyVersion>0.0.0.0</AssemblyVersion>
    <AssemblyCulture>neutral</AssemblyCulture>
    <Attributes />
  </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 application and Gnome system help.</summary>
    <remarks>These functions provide a way to display help files that are either installed as part of the main Gnome installation or that are specific to the current application.</remarks>
  </Docs>
  <Base>
    <BaseTypeName>System.Object</BaseTypeName>
  </Base>
  <Interfaces />
  <Attributes />
  <Members>
    <Member MemberName="DisplayWithDocId">
      <MemberSignature Language="C#" Value="public static bool DisplayWithDocId (Gnome.Program program, string doc_id, string file_name, string link_id);" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Boolean</ReturnType>
      </ReturnValue>
      <Parameters>
		<Parameter Name="program" Type="Gnome.Program" />
		<Parameter Name="doc_id" Type="System.String" />
		<Parameter Name="file_name" Type="System.String" />
		<Parameter Name="link_id" Type="System.String" />
	</Parameters>
      <Docs>
        <summary>Displays the help file specified by <paramref name="file_name"/> at location <paramref name="link_id"/> within the <paramref name="doc_id"/> domain in the preferred help browser of the user.</summary>
        <param name="program">a <see cref="T:Gnome.Program" /></param>
        <param name="doc_id">a <see cref="T:System.String" /></param>
        <param name="file_name">a <see cref="T:System.String" /></param>
        <param name="link_id">a <see cref="T:System.String" /></param>
        <returns>a <see cref="T:System.Boolean" /></returns>
        <remarks>
          <para>
            Most of the time, you want to call <see cref="M:Gnome.Help.Display(System.String,System.String)"/> instead.
          </para>
          <para>
            This function will display the help through creating a "ghelp" URI, by looking for <paramref name="file_name"/> in the applications installed help location (found by <see cref="F:Gnome.FileDomain.AppHelp"/>) and its <paramref name="app_id"/>. The resulting URI is roughly in the form "ghelp:appid/file_name?link_id". If a matching file cannot be found, <see langword="false"/> is returned.
          </para>
          <para>
            Please note that this only displays application help. To display help files from the global Gnome domain, you will want to use <see cref="M:Gnome.Help.DisplayDesktop(Gnome.Program,System.String,System.String,System.String)"/>.
          </para>
		</remarks>
      </Docs>
    </Member>
    <Member MemberName="ErrorQuark">
      <MemberSignature Language="C#" Value="public static int ErrorQuark ();" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Int32</ReturnType>
      </ReturnValue>
      <Parameters />
      <Docs>
        <summary>To be added</summary>
        <returns>a <see cref="T:System.Int32" /></returns>
        <remarks>To be added</remarks>
      </Docs>
    </Member>
    <Member MemberName="Display">
      <MemberSignature Language="C#" Value="public static bool Display (string file_name, string link_id);" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Boolean</ReturnType>
      </ReturnValue>
      <Parameters>
		<Parameter Name="file_name" Type="System.String" />
		<Parameter Name="link_id" Type="System.String" />
	</Parameters>
      <Docs>
        <summary>Displays the help file specified by <paramref name="file_name"/> at location <paramref name="link_id"/> in the preferred help browser of the user.</summary>
        <param name="file_name">a <see cref="T:System.String" /></param>
        <param name="link_id">a <see cref="T:System.String" /></param>
        <returns>a <see cref="T:System.Boolean" /></returns>
        <remarks></remarks>
      </Docs>
    </Member>
    <Member MemberName="DisplayUri">
      <MemberSignature Language="C#" Value="public static bool DisplayUri (string help_uri);" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Boolean</ReturnType>
      </ReturnValue>
      <Parameters>
		<Parameter Name="help_uri" Type="System.String" />
	</Parameters>
      <Docs>
        <summary>Displays <paramref name="help_uri"/> in the preferred help viewer of the user.</summary>
        <param name="help_uri">a <see cref="T:System.String" /></param>
        <returns>a <see cref="T:System.Boolean" /></returns>
        <remarks>You should never need to call this function directly in code, since it is just a wrapper for <see cref="M:Gnome.Url.Show(System.String)"/> and consequently the viewer used to display the results depends upon the scheme of the URI (so it is not strictly a help-only function).</remarks>
      </Docs>
    </Member>
    <Member MemberName="DisplayDesktop">
      <MemberSignature Language="C#" Value="public static bool DisplayDesktop (Gnome.Program program, string doc_id, string file_name, string link_id);" />
      <MemberType>Method</MemberType>
      <ReturnValue>
        <ReturnType>System.Boolean</ReturnType>
      </ReturnValue>
      <Parameters>
		<Parameter Name="program" Type="Gnome.Program" />
		<Parameter Name="doc_id" Type="System.String" />
		<Parameter Name="file_name" Type="System.String" />
		<Parameter Name="link_id" Type="System.String" />
	</Parameters>
      <Docs>
        <summary>Displays the Gnome system help file specified by <paramref name="file_name"/> at location <paramref name="link_id"/> in the preferred help browser of the user.</summary>
        <param name="program">a <see cref="T:Gnome.Program" /></param>
        <param name="doc_id">a <see cref="T:System.String" /></param>
        <param name="file_name">a <see cref="T:System.String" /></param>
        <param name="link_id">a <see cref="T:System.String" /></param>
        <returns>a <see cref="T:System.Boolean" /></returns>
        <remarks>
          <para>
            This is done by creating a "ghelp" URI, by looking for <paramref name="file_name"/> in the system help domain (<see cref="F:Gnome.FileDomain.Help"/>) and its <paramref name="app_id"/>. This domain is determined when the library is compiled. If a matching file cannot be found, <see langword="false"/> is returned.
          </para>
          <para>
            Please note that this only displays system help. To display help files for an application, you will want to use <see cref="M:Gnome.Help.Display(System.String,System.String)"/>.
          </para>
		</remarks>
      </Docs>
    </Member>
    <Member MemberName=".ctor">
      <MemberSignature Language="C#" Value="public Help ();" />
      <MemberType>Constructor</MemberType>
      <ReturnValue />
      <Parameters />
      <Docs>
        <summary>Creates a new <see cref="T:Gnome.Help"/> instance.</summary>
        <returns>a <see cref="T:Gnome.Help" /></returns>
        <remarks>This is the default constructor for <see cref="T:Gnome.Help"/>.</remarks>
      </Docs>
    </Member>
  </Members>
</Type>