GtkSharp/doc/en/Gnome/DruidPageStandard.xml
Dan Winship b6d7f14268 * generator/StructBase.cs: update field-generation logic a bit
* generator/CodeGenerator.cs: add a --glue-includes flag

	* generator/GenerationInfo.cs: Accept glue_includes value from
	Main and output it to the glue_filename.

	* generator/FieldBase.cs (Ignored): handle more ignorable cases.
	(CheckGlue): New method to figure out what kind of glue we'll need
	for a field.
	(GenerateImports): generate appropriate imports per CheckGlue.
	(GenerateGlue): Generate C glue for accessing a struct field;
	either a fully-C-based accessor, or a method to just return the
	field's offset in the struct.
	(Generate): Use the generated glue to read the field.

	* generator/PropertyBase.cs (CType): if the field is a single bit,
	set its type to gboolean.

	* generator/ObjectGen.cs (Generate):
	* generator/OpaqueGen.cs (Generate): Call GenFields.

	* generator/StructField.cs: Use FieldBase's glue-generation code
	to handle bitfields. [#54489]

	* generator/ObjectField.cs: Generates accessors for public fields
	of objects and opaque structs. [#69514]

	* generator/ClassBase.cs (ClassBase): Parse <fields> nodes and
	create ObjectField objects.
	(GenFields): Output field properties
	(IgnoreMethod): Ignore Get/Set methods that duplicate fields

	* generator/Makefile.am (sources): update

	* {gdk,gnome,gtk,pango}/*.metadata: Mark some additional fields as
	public. Rename/retype some fields for consistency with earlier
	hand-coded bindings.

	* {gdk,gnome,gtk,pango}/*.custom: Remove custom methods that can
	now be autogenerated.

	* {gdk,gnome,gtk,pango}/glue/*.c: Remove glue methods that can now
	be autogenerated
	
	* {gdk,glade,gnome,gtk,pango,vte}/Makefile.am
	* {gdk,glade,gnome,gtk,pango,vte}/glue/Makefile.am
	* {gdk,gnome,gtk,pango}/glue/makefile.win32: Update

svn path=/trunk/gtk-sharp/; revision=44563
2005-05-16 14:28:55 +00:00

358 lines
15 KiB
XML

<Type Name="DruidPageStandard" FullName="Gnome.DruidPageStandard">
<TypeSignature Language="C#" Value="public class DruidPageStandard : Gnome.DruidPage, Implementor, IWrapper, IDisposable" Maintainer="John Luke" />
<AssemblyInfo>
<AssemblyName>gnome-sharp</AssemblyName>
<AssemblyPublicKey>
</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>A widget used to implement the middle pages in a druid's sequence.</summary>
<remarks>
<para>This widget provides similar functionality to that in <see cref="T:Gnome.DruidPageEdge" />. It is used for pages that are not the initial or terminal pages of a druid.</para>
<para>The main difference between an edge and a standard druid page (in a display sense) is that standard pages do not have a left-side watermark and the body of the contents section is a bit more arbitrary (it is a <see cref="T:GTK.VBox" /> widget), rather than just displaying text (which is the common case for edge pages).</para>
</remarks>
</Docs>
<Base>
<BaseTypeName>Gnome.DruidPage</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>Atk.Implementor</InterfaceName>
</Interface>
<Interface>
<InterfaceName>GLib.IWrapper</InterfaceName>
</Interface>
<Interface>
<InterfaceName>System.IDisposable</InterfaceName>
</Interface>
</Interfaces>
<Attributes />
<Members>
<Member MemberName="AppendItem">
<MemberSignature Language="C#" Value="public void AppendItem (string question, Gtk.Widget item, string additional_info);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="question" Type="System.String" />
<Parameter Name="item" Type="Gtk.Widget" />
<Parameter Name="additional_info" Type="System.String" />
</Parameters>
<Docs>
<summary>Add a <see cref="T:Gtk.Widget" /> to a <see cref="T:Gnome.DruidPageStandard" />'s VBox.</summary>
<param name="question"> The text to place above the item.</param>
<param name="item">The <see cref="T:Gtk.Widget" /> to be included.</param>
<param name="additional_info"> The text to be placed below the item in a smaller font.</param>
<remarks>
<para>Convenience function to add a <see cref="T:Gtk.Widget" /> to a <see cref="T:Gnome.DruidPageStandard" />'s VBox. This function creates a new contents section that has the question text followed by the item widget and then the addition_info text, all stacked vertically from top to bottom.</para>
<para>The item widget could be something like a set of radio checkbuttons requesting a choice from the user.</para>
</remarks>
</Docs>
</Member>
<Member MemberName="Finalize">
<MemberSignature Language="C#" Value="protected override void Finalize ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Disposes the resources associated with the object.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DruidPageStandard (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>
<returns>An instance of DruidPageStandard, wrapping the C object.</returns>
<remarks>
<para>This is an internal constructor, and should not be used by user code.</para>
</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DruidPageStandard ();" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs>
<summary>Construct a new <see cref="T:Gnome.DruidPageStandard" />.</summary>
<returns>a new <see cref="T:Gnome.DruidPageStandard" />.</returns>
<remarks>
</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public DruidPageStandard (string title, Gdk.Pixbuf logo, Gdk.Pixbuf top_watermark);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="title" Type="System.String" />
<Parameter Name="logo" Type="Gdk.Pixbuf" />
<Parameter Name="top_watermark" Type="Gdk.Pixbuf" />
</Parameters>
<Docs>
<summary>Constructs a new <see cref="T:Gnome.DruidPageStandard" /> and allows the caller to fill in some of the values at the same time.</summary>
<param name="title"> The title of the druid page.</param>
<param name="logo"> The logo to put on the druid page.</param>
<param name="top_watermark"> The watermark to put at the top of the druid page.</param>
<returns>a new <see cref="T:Gnome.DruidPageStandard" />.</returns>
<remarks>
</remarks>
</Docs>
</Member>
<Member MemberName="ContentsBackground">
<MemberSignature Language="C#" Value="public Gdk.Color ContentsBackground { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gdk.Color</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The color of the main contents section background.</summary>
<param name="value">an object of type <see cref="T:Gdk.Color" /></param>
<returns>an object of type <see cref="T:Gdk.Color" /></returns>
<remarks>
</remarks>
</Docs>
</Member>
<Member MemberName="TitleForegroundGdk">
<MemberSignature Language="C#" Value="public Gdk.Color TitleForegroundGdk { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gdk.Color</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Sets the color of the main contents section's background.</summary>
<param name="value"> The new color for the main body's background.</param>
<returns>an object of type <see cref="T:Gdk.Color" /></returns>
<remarks>
</remarks>
</Docs>
</Member>
<Member MemberName="LogoBackgroundGdk">
<MemberSignature Language="C#" Value="public Gdk.Color LogoBackgroundGdk { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gdk.Color</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The background of the logo.</summary>
<param name="value">an object of type <see cref="T:Gdk.Color" /></param>
<returns>an object of type <see cref="T:Gdk.Color" /></returns>
<remarks>
</remarks>
</Docs>
</Member>
<Member MemberName="TitleForegroundSet">
<MemberSignature Language="C#" Value="public bool TitleForegroundSet { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>To be added</summary>
<param name="value">an object of type <see cref="T:System.Boolean" /></param>
<returns>an object of type <see cref="T:System.Boolean" /></returns>
<remarks>To be added</remarks>
</Docs>
</Member>
<Member MemberName="Logo">
<MemberSignature Language="C#" Value="public Gdk.Pixbuf Logo { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gdk.Pixbuf</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Sets a <see cref="T:Gdk.Pixbuf" /> as the logo in the top right corner.</summary>
<param name="value">an object of type <see cref="T:Gdk.Color" /></param>
<returns>an object of type <see cref="T:Gdk.Color" /></returns>
<remarks>If <see langword="null" />, then no logo will be displayed.</remarks>
</Docs>
</Member>
<Member MemberName="TitleForeground">
<MemberSignature Language="C#" Value="public Gdk.Color TitleForeground { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gdk.Color</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The color of the title text.</summary>
<param name="value">The color of the title text.</param>
<returns>an object of type <see cref="T:Gdk.Color" /></returns>
</Docs>
</Member>
<Member MemberName="LogoBackground">
<MemberSignature Language="C#" Value="public Gdk.Color LogoBackground { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gdk.Color</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The background color to render the logo image against.</summary>
<param name="value">The color.</param>
<returns>The color.</returns>
<remarks>
</remarks>
</Docs>
</Member>
<Member MemberName="Background">
<MemberSignature Language="C#" Value="public Gdk.Color Background { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gdk.Color</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The color of the page border.</summary>
<param name="value">The color.</param>
<returns>The color.</returns>
<remarks>
</remarks>
</Docs>
</Member>
<Member MemberName="Title">
<MemberSignature Language="C#" Value="public string Title { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The page title.</summary>
<param name="value">The page title.</param>
<returns>The page title.</returns>
<remarks>
</remarks>
</Docs>
</Member>
<Member MemberName="BackgroundGdk">
<MemberSignature Language="C#" Value="public Gdk.Color BackgroundGdk { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gdk.Color</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The background color of the top section of the druid page.</summary>
<param name="value">an object of type <see cref="T:Gdk.Color" /></param>
<returns>an object of type <see cref="T:Gdk.Color" /></returns>
<remarks>
</remarks>
</Docs>
</Member>
<Member MemberName="TopWatermark">
<MemberSignature Language="C#" Value="public Gdk.Pixbuf TopWatermark { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gdk.Pixbuf</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Sets a <see cref="T:Gdk.Pixbuf" /> as the watermark on the top strip on the druid.</summary>
<param name="value">an object of type <see cref="T:Gdk.Pixbuf" /></param>
<returns>an object of type <see cref="T:Gdk.Pixbuf" /></returns>
<remarks>If <see langword="null" />, it is reset to the normal color.</remarks>
</Docs>
</Member>
<Member MemberName="LogoBackgroundSet">
<MemberSignature Language="C#" Value="public bool LogoBackgroundSet { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Sets a <see cref="T:Gdk.Pixbuf" /> as the watermark on top of the top strip on the druid.</summary>
<param name="value"> The <see cref="T:Gdk.Pixbuf" /> to use as a top watermark.</param>
<returns>an object of type <see cref="T:System.Boolean" /></returns>
<remarks>If set to null, the top watermark is reset to the normal color.</remarks>
</Docs>
</Member>
<Member MemberName="BackgroundSet">
<MemberSignature Language="C#" Value="public bool BackgroundSet { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>To be added</summary>
<param name="value">an object of type <see cref="T:System.Boolean" /></param>
<returns>an object of type <see cref="T:System.Boolean" /></returns>
<remarks>To be added</remarks>
</Docs>
</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>
<returns>a <see cref="T:GLib.GType" /></returns>
<remarks>Returns the native <see cref="T:GLib.GType" /> value for <see cref="T:Gnome.DruidPageStandard" />.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected DruidPageStandard (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>
<returns>a <see cref="T:Gnome.DruidPageStandard" /></returns>
<remarks>Chain to this constructor if you have manually registered a native <see cref="T:GLib.GType" /> value for your subclass.</remarks>
</Docs>
</Member>
<Member MemberName="VBox">
<MemberSignature Language="C#" Value="public Gtk.VBox VBox { get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.VBox</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>The page's <see cref="T:Gtk.VBox" /></summary>
<returns>The page's <see cref="T:Gtk.VBox" /></returns>
<remarks></remarks>
</Docs>
</Member>
</Members>
</Type>