My sunday morning documentation contribution

svn path=/trunk/gtk-sharp/; revision=43854
This commit is contained in:
Miguel de Icaza 2005-05-01 17:32:57 +00:00
parent 9f5eb0a70d
commit cc54bbe5ed

View file

@ -62,17 +62,18 @@
</Parameters> </Parameters>
<Docs> <Docs>
<summary>Render a <see cref="T:Pango.Layout" /> onto the Drawable <summary>Render a <see cref="T:Pango.Layout" /> onto the Drawable
object with the specified colors.</summary>
<param name="gc">A <see cref="T:Gdk.GC" />, the graphics context to use</param>
<param name="x">the X position of the left of the layout (in pixels)</param>
<param name="y"> the Y position of the top of the layout (in pixels)</param>
<param name="layout">the layout to render</param>
<param name="foreground">the foreground color</param>
<param name="background">the background color</param>
<remarks>Render a <see cref="T:Pango.LayoutLine" /> onto the Drawable
object, overriding the layout's normal colors with object, overriding the layout's normal colors with
<paramref name="foreground" /> and/or <paramref name="background" />. <paramref name="foreground" /> and/or <paramref name="background" />.
<paramref name="foreground" /> and <paramref name="background" /> <paramref name="foreground" /> and <paramref name="background" />
need not be allocated.</summary> need not be allocated.</remarks>
<param name="gc">A <see cref="T:Gdk.GC" />, the graphics context to use</param>
<param name="x">A <see cref="T:System.Int32" />, the X position of the left of the layout (in pixels)</param>
<param name="y">A <see cref="T:System.Int32" />, the Y position of the top of the layout (in pixels)</param>
<param name="layout">A <see cref="T:Pango.Layout" />, the layout to render</param>
<param name="foreground">A <see cref="T:Gdk.Color" />, the foreground color</param>
<param name="background">A <see cref="T:Gdk.Color" />, the background color</param>
<remarks />
</Docs> </Docs>
</Member> </Member>
<Member MemberName="DrawLayoutLine"> <Member MemberName="DrawLayoutLine">
@ -113,17 +114,21 @@
</Parameters> </Parameters>
<Docs> <Docs>
<summary>Render a <see cref="T:Pango.LayoutLine" /> onto the Drawable <summary>Render a <see cref="T:Pango.LayoutLine" /> onto the Drawable
object, overriding the layout's normal colors.</summary>
<param name="gc">A <see cref="T:Gdk.GC" />, the graphics context to use</param>
<param name="x">the X position of the start of string (in pixels)</param>
<param name="y">the Y position of the baseline (in pixels)</param>
<param name="layout">A <see cref="T:Pango.LayoutLine" />, a line of text to render</param>
<param name="foreground">the foreground color</param>
<param name="background">the background color</param>
<remarks>Render a <see cref="T:Pango.LayoutLine" /> onto the Drawable
object, overriding the layout's normal colors with object, overriding the layout's normal colors with
<paramref name="foreground" /> and/or <paramref name="background" />. <paramref name="foreground" /> and/or <paramref name="background" />.
<paramref name="foreground" /> and <paramref name="background" />
need not be allocated.</summary> <para>
<param name="gc">A <see cref="T:Gdk.GC" />, the graphics context to use</param> <paramref name="foreground" /> and <paramref name="background" />
<param name="x">A <see cref="T:System.Int32" />, the X position of the start of string (in pixels)</param> need not be allocated.
<param name="y">A <see cref="T:System.Int32" />, the Y position of the baseline (in pixels)</param> </para></remarks>
<param name="layout">A <see cref="T:Pango.LayoutLine" />, a line of text to render</param>
<param name="foreground">A <see cref="T:Gdk.Color" />, the foreground color</param>
<param name="background">A <see cref="T:Gdk.Color" />, the background color</param>
<remarks />
</Docs> </Docs>
</Member> </Member>
<Member MemberName="DrawLayout"> <Member MemberName="DrawLayout">
@ -140,11 +145,16 @@
</Parameters> </Parameters>
<Docs> <Docs>
<summary>Render a <see cref="T:Pango.Layout" /> onto a <see cref="T:Gdk.Drawable" /></summary> <summary>Render a <see cref="T:Pango.Layout" /> onto a <see cref="T:Gdk.Drawable" /></summary>
<param name="gc">A <see cref="T:Gdk.GC" /></param> <param name="gc">The base <see cref="T:Gdk.GC" /> to use.</param>
<param name="x">A <see cref="T:System.Int32" /></param> <param name="x">the X position of the left of the layout (in pixels)</param>
<param name="y">A <see cref="T:System.Int32" /></param> <param name="y"> the Y position of the top of the layout (in pixels)</param>
<param name="layout">A <see cref="T:Pango.Layout" /></param> <param name="layout">A <see cref="T:Pango.Layout" /></param>
<remarks>If you are using Gtk, the usual way to obtain a <see cref="T:Pango.Layout" /> is <see cref="M:Gtk.Widget.CreatePangoLayout()" />.</remarks> <remarks>
<para>
If the layout's PangoContext has a transformation matrix set, then x and y specify the position of the top left corner of the bounding box (in device space) of the transformed layout.
</para>
If you are using Gtk, the usual way to obtain a <see cref="T:Pango.Layout" /> is <see cref="M:Gtk.Widget.CreatePangoLayout()" />.</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="GetSize"> <Member MemberName="GetSize">
@ -205,21 +215,21 @@
<Parameter Name="glyphs" Type="Pango.GlyphString" /> <Parameter Name="glyphs" Type="Pango.GlyphString" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary> <summary>Low-level glyph drawing function.</summary>
<p>This is a low-level function; 99% of text rendering should be done
using <see cref="M:Gdk.Drawable.DrawLayout" /> instead.</p>
<p>A glyph is a character in a font. This function draws a sequence of
glyphs. To obtain a sequence of glyphs you have to understand a
lot about internationalized text handling, which you don't want to
understand; thus, use <see cref="M:Gdk.Drawable.DrawLayout" /> instead of this function,
<see cref="M:Gdk.Drawable.DrawLayout" /> handles the details.</p>
</summary>
<param name="gc">A <see cref="T:Gdk.GC" /></param> <param name="gc">A <see cref="T:Gdk.GC" /></param>
<param name="font">A <see cref="T:Pango.Font" /></param> <param name="font">A <see cref="T:Pango.Font" /></param>
<param name="x">A <see cref="T:System.Int32" /></param> <param name="x">A <see cref="T:System.Int32" /></param>
<param name="y">A <see cref="T:System.Int32" /></param> <param name="y">A <see cref="T:System.Int32" /></param>
<param name="glyphs">A <see cref="T:Pango.GlyphString" /></param> <param name="glyphs">A <see cref="T:Pango.GlyphString" /></param>
<remarks /> <remarks>
<para>This is a low-level function; 99% of text rendering should be done
using <see cref="M:Gdk.Drawable.DrawLayout" /> instead.</para>
<para>A glyph is a character in a font. This function draws a sequence of
glyphs. To obtain a sequence of glyphs you have to understand a
lot about internationalized text handling, which you don't want to
understand; thus, use <see cref="M:Gdk.Drawable.DrawLayout" /> instead of this function,
<see cref="M:Gdk.Drawable.DrawLayout" /> handles the details.</para>
</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="GetImage"> <Member MemberName="GetImage">
@ -235,14 +245,20 @@
<Parameter Name="height" Type="System.Int32" /> <Parameter Name="height" Type="System.Int32" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary> <summary>Returns a client-side <see cref="T:Gdk.Image" /> representing the server-side <see cref="T:Gdk.Drawable" />.</summary>
<p> <param name="x">A <see cref="T:System.Int32" />, X coordinate of the upper left corner of the region to get as a drawable</param>
<param name="y">A <see cref="T:System.Int32" />, Y coordinate of the upper left corner of the region to get as a drawable.</param>
<param name="width">A <see cref="T:System.Int32" />, width of the rectangle</param>
<param name="height">A <see cref="T:System.Int32" />, height of the rectangle.</param>
<returns>A <see cref="T:Gdk.Image" /> containing the contents of this Drawable object.</returns>
<remarks>
<para>
A <see cref="T:Gdk.Image" /> stores client-side image data (pixels). In contrast, A <see cref="T:Gdk.Image" /> stores client-side image data (pixels). In contrast,
<see cref="T:Gdk.Pixmap" /> and <see cref="T:Gdk.Window" /> are server-side <see cref="T:Gdk.Pixmap" /> and <see cref="T:Gdk.Window" /> are server-side
objects. This method obtains the pixels from a objects. This method obtains the pixels from a
server-side drawable as a client-side <see cref="T:Gdk.Image" />. server-side drawable as a client-side <see cref="T:Gdk.Image" />.
</p> </para>
<p> <para>
The format of a <see cref="T:Gdk.Image" /> depends on The format of a <see cref="T:Gdk.Image" /> depends on
the <see cref="T:Gdk.Visual" /> of the current display, which the <see cref="T:Gdk.Visual" /> of the current display, which
makes manipulating <see cref="T:Gdk.Image" /> extremely difficult; makes manipulating <see cref="T:Gdk.Image" /> extremely difficult;
@ -254,39 +270,29 @@
display-dependent format. Of course, there's a convenience vs. display-dependent format. Of course, there's a convenience vs.
speed tradeoff here, so you'll want to think about what makes speed tradeoff here, so you'll want to think about what makes
sense for your application. sense for your application.
</p> </para>
</summary> <para>
<param name="x">A <see cref="T:System.Int32" />, X coordinate of the upper left corner of the region to get as a drawable</param>
<param name="y">A <see cref="T:System.Int32" />, Y coordinate of the upper left corner of the region to get as a drawable.</param>
<param name="width">A <see cref="T:System.Int32" />, width of the rectangle</param>
<param name="height">A <see cref="T:System.Int32" />, height of the rectangle.</param>
<returns>A <see cref="T:Gdk.Image" /> containing the contents of this Drawable object.</returns>
<remarks>
<p>
</p>
<p>
<paramref name="x" />, <paramref name="y" />, <paramref name="x" />, <paramref name="y" />,
<paramref name="width" />, and <paramref name="height" /> define <paramref name="width" />, and <paramref name="height" /> define
the region of the drawable to obtain as an image. the region of the drawable to obtain as an image.
</p> </para>
<p> <para>
You would usually copy image data to the client side if you intend You would usually copy image data to the client side if you intend
to examine the values of individual pixels, for example to darken to examine the values of individual pixels, for example to darken
an image or add a red tint. It would be prohibitively slow to an image or add a red tint. It would be prohibitively slow to
make a round-trip request to the windowing system for each pixel, make a round-trip request to the windowing system for each pixel,
so instead you get all of them at once, modify them, then copy so instead you get all of them at once, modify them, then copy
them all back at once. them all back at once.
</p> </para>
<p> <para>
If the X server or other windowing system backend is on the local If the X server or other windowing system backend is on the local
machine, this function may use shared memory to avoid copying machine, this function may use shared memory to avoid copying
the image data. the image data.
</p> </para>
<p> <para> If the source drawable is a #GdkWindow and partially offscreen
If the source drawable is a #GdkWindow and partially offscreen
or obscured, then the obscured portions of the returned image or obscured, then the obscured portions of the returned image
will contain undefined data. will contain undefined data.
</p> </para>
</remarks> </remarks>
</Docs> </Docs>
</Member> </Member>
@ -307,14 +313,7 @@
<Parameter Name="height" Type="System.Int32" /> <Parameter Name="height" Type="System.Int32" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary> <summary>Draws a portion of a drawable into another.</summary>
Copies the <paramref name="width" />x<paramref name="height" /> region of <paramref name="src" /> at coordinates (<paramref name="xsrc" />,
<paramref name="ysrc" />) to coordinates (<paramref name="xdest" />, <paramref name="ydest" />) in <paramref name="drawable" />.
<paramref name="width" /> and/or <paramref name="height" /> may be given as -1, in which case the entire
<paramref name="src" /> drawable will be copied.
Most fields in <paramref name="gc" /> are not used for this operation, but notably the
clip mask or clip region will be honored.
</summary>
<param name="gc">A <see cref="T:Gdk.GC" /></param> <param name="gc">A <see cref="T:Gdk.GC" /></param>
<param name="src">A <see cref="T:Gdk.Drawable" />, the source Drawable. </param> <param name="src">A <see cref="T:Gdk.Drawable" />, the source Drawable. </param>
<param name="xsrc">A <see cref="T:System.Int32" /></param> <param name="xsrc">A <see cref="T:System.Int32" /></param>
@ -324,15 +323,25 @@
<param name="width">A <see cref="T:System.Int32" /></param> <param name="width">A <see cref="T:System.Int32" /></param>
<param name="height">A <see cref="T:System.Int32" /></param> <param name="height">A <see cref="T:System.Int32" /></param>
<remarks> <remarks>
<para>
Copies the <paramref name="width" /> x <paramref name="height" /> region of <paramref name="src" /> at coordinates (<paramref name="xsrc" />,
<paramref name="ysrc" />) to coordinates (<paramref name="xdest" />, <paramref name="ydest" />) in <paramref name="drawable" />.
<paramref name="width" /> and/or <paramref name="height" /> may be given as -1, in which case the entire
<paramref name="src" /> drawable will be copied.
Most fields in <paramref name="gc" /> are not used for this operation, but notably the
clip mask or clip region will be honored.
</para>
The source and destination drawables must have the same visual and The source and destination drawables must have the same visual and
colormap, or errors will result. (On X11, failure to match colormap, or errors will result. (On X11, failure to match
visual/colormap results in a BadMatch error from the X server.) visual/colormap results in a BadMatch error from the X server.)
A common cause of this problem is an attempt to draw a bitmap to A common cause of this problem is an attempt to draw a bitmap to
a color drawable. The way to draw a bitmap is to set the a color drawable. The way to draw a bitmap is to set the
bitmap as a clip mask on your #GdkGC, then use gdk_draw_rectangle() bitmap as a clip mask on your #GdkGC, then use <see cref="M:Gdk.Drawable.DrawRectangle" />
to draw a rectangle clipped to the bitmap. to draw a rectangle clipped to the bitmap.
<p>TODO: This API needs to be adjusted; <paramref name="src" /> should </remarks>
probably not exist.</p></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="DrawImage"> <Member MemberName="DrawImage">
@ -420,17 +429,10 @@
<Parameters> <Parameters>
</Parameters> </Parameters>
<Docs> <Docs>
<summary>The color map for this Drawable. You only need to set <summary>The color map for this Drawable. </summary>
the color map if the drawable-creating function did not have a <param name="value">The new <see cref="T:Gdk.Colormap" /> for the Drawable.</param>
way to determine the colormap, and you then use drawable operations <returns>The current <see cref="T:Gdk.Colormap" /> on the Drawable.</returns>
that require a colormap. The colormap for all drawables and <remarks>You only need to set the color map if the drawable-creating function did not have a way to determine the colormap, and you then use drawable operations that require a colormap. The colormap for all drawables and graphics contexts you intend to use together should match. i.e. when using a #GdkGC to draw to a drawable, or copying one drawable to another, the colormaps should match.</remarks>
graphics contexts you intend to use together should match. i.e.
when using a #GdkGC to draw to a drawable, or copying one drawable
to another, the colormaps should match.
</summary>
<param name="value">A <see cref="T:Gdk.Colormap" /></param>
<returns>A <see cref="T:Gdk.Colormap" /></returns>
<remarks />
</Docs> </Docs>
</Member> </Member>
<Member MemberName="VisibleRegion"> <Member MemberName="VisibleRegion">
@ -440,9 +442,13 @@
<ReturnType>Gdk.Region</ReturnType> <ReturnType>Gdk.Region</ReturnType>
</ReturnValue> </ReturnValue>
<Docs> <Docs>
<summary>To be added</summary> <summary>Computes the region of a drawable that is potentially visible.</summary>
<returns>A <see cref="T:Gdk.Region" /></returns> <returns>A <see cref="T:Gdk.Region" /></returns>
<remarks /> <remarks>This does not necessarily take into account if the window is obscured by other windows, but no area outside of this region is visible.
<para>
You must call <see cref="M:Gdk.Region.Destroy()" /> when done.
</para></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="ClipRegion"> <Member MemberName="ClipRegion">
@ -452,9 +458,13 @@
<ReturnType>Gdk.Region</ReturnType> <ReturnType>Gdk.Region</ReturnType>
</ReturnValue> </ReturnValue>
<Docs> <Docs>
<summary>To be added</summary> <summary>Computes the region of a drawable that potentially can be written to by drawing primitives.</summary>
<returns>A <see cref="T:Gdk.Region" /></returns> <returns>A <see cref="T:Gdk.Region" />. You must call <see cref="M:Gdk.Region.Destroy()" /> when done.</returns>
<remarks /> <remarks>Computes the region of a drawable that potentially can be written to by drawing primitives. This region will not take into account the clip region for the GC, and may also not take into account other factors such as if the window is obscured by other windows, but no area outside of this region will be affected by drawing primitives.
<para>
You must call the Destroy method on the returned region when done.
</para></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Visual"> <Member MemberName="Visual">
@ -464,7 +474,7 @@
<ReturnType>Gdk.Visual</ReturnType> <ReturnType>Gdk.Visual</ReturnType>
</ReturnValue> </ReturnValue>
<Docs> <Docs>
<summary>To be added</summary> <summary>Gets the <see cref="T:Gdk.Visual" /> describing the pixel format of drawable.</summary>
<returns>A <see cref="T:Gdk.Visual" /></returns> <returns>A <see cref="T:Gdk.Visual" /></returns>
<remarks /> <remarks />
</Docs> </Docs>
@ -476,9 +486,9 @@
<ReturnType>System.Int32</ReturnType> <ReturnType>System.Int32</ReturnType>
</ReturnValue> </ReturnValue>
<Docs> <Docs>
<summary>To be added</summary> <summary>Obtains the bit depth of the drawable.</summary>
<returns>A <see cref="T:System.Int32" /></returns> <returns>The bit depth.</returns>
<remarks /> <remarks>Obtains the bit depth of the drawable, that is, the number of bits that make up a pixel in the drawable's visual. Examples are 8 bits per pixel, 24 bits per pixel, etc.</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="Screen"> <Member MemberName="Screen">
@ -488,7 +498,7 @@
<ReturnType>Gdk.Screen</ReturnType> <ReturnType>Gdk.Screen</ReturnType>
</ReturnValue> </ReturnValue>
<Docs> <Docs>
<summary>To be added</summary> <summary>Gets the <see cref="T:Gdk.Screen" /> associated with a <see cref="T:Gdk.Drawable." /></summary>
<returns>a <see cref="T:Gdk.Screen" /></returns> <returns>a <see cref="T:Gdk.Screen" /></returns>
<remarks /> <remarks />
</Docs> </Docs>
@ -500,8 +510,8 @@
<ReturnType>Gdk.Display</ReturnType> <ReturnType>Gdk.Display</ReturnType>
</ReturnValue> </ReturnValue>
<Docs> <Docs>
<summary>To be added</summary> <summary>Gets the <see cref="T:Gdk.Display" /> associated with the <see cref="T:Gdk.Drawable" />.</summary>
<returns>a <see cref="T:Gdk.Display" /></returns> <returns>The <see cref="T:Gdk.Display" />.</returns>
<remarks /> <remarks />
</Docs> </Docs>
</Member> </Member>
@ -516,10 +526,10 @@
<Parameter Name="points" Type="Gdk.Point[]" /> <Parameter Name="points" Type="Gdk.Point[]" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Draws a series of lines connecting the given points.</summary>
<param name="gc">a <see cref="T:Gdk.GC" /></param> <param name="gc">a <see cref="T:Gdk.GC" /></param>
<param name="points">a <see cref="T:Gdk.Point[]" /></param> <param name="points">a <see cref="T:Gdk.Point[]" /></param>
<remarks /> <remarks>The way in which joins between lines are draw is determined by the <see cref="E:Gdk.CapStyle" /> value in the <see cref="T:Gdk.GC" />. This can be set with <see cref="M:Gdk.GC.LineAttributes" /> property.</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="DrawPolygon"> <Member MemberName="DrawPolygon">
@ -574,7 +584,7 @@
<Parameter Name="y2_" Type="System.Int32" /> <Parameter Name="y2_" Type="System.Int32" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Draws a line, using the foreground color and other attributes of the <see cref="T:Gdk.GC" /></summary>
<param name="gc">a <see cref="T:Gdk.GC" /></param> <param name="gc">a <see cref="T:Gdk.GC" /></param>
<param name="x1_">a <see cref="T:System.Int32" /></param> <param name="x1_">a <see cref="T:System.Int32" /></param>
<param name="y1_">a <see cref="T:System.Int32" /></param> <param name="y1_">a <see cref="T:System.Int32" /></param>
@ -600,23 +610,19 @@
<Parameter Name="angle2" Type="System.Int32" /> <Parameter Name="angle2" Type="System.Int32" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Draws an arc or a filled 'pie slice'.</summary>
<param name="gc">a <see cref="T:Gdk.GC" /></param> <param name="gc">a <see cref="T:Gdk.GC" /></param>
<param name="filled">a <see cref="T:System.Boolean" /></param> <param name="filled">a <see cref="T:System.Boolean" /></param>
<param name="x">a <see cref="T:System.Int32" /><para> <param name="x">The x-coordinate of the upper left hand of the bounding box of the arc.
The x-coordinate of the upper left hand of the bounding box of the arc. </param>
</para></param> <param name="y">The y-coordinate of the upper left hand of the bounding box of the arc.
<param name="y">a <see cref="T:System.Int32" /><para> </param>
The y-coordinate of the upper left hand of the bounding box of the arc. <param name="width"> the width of the bounding rectangle.</param>
</para></param> <param name="height">the height of the bounding rectangle.</param>
<param name="width">a <see cref="T:System.Int32" /></param> <param name="angle1">The starting angle of the arc in the clockwise direction in reference to the 3'oclock position in terms of 1/64th of a degree.
<param name="height">a <see cref="T:System.Int32" /></param> </param>
<param name="angle1">a <see cref="T:System.Int32" /><para> <param name="angle2">The number of 1/64ths of a degree to sweep the arc in a clockwise direction relative to the starting angle.
The starting angle of the arc in the clockwise direction in reference to the 3'oclock position in terms of 1/64th of a degree. </param>
</para></param>
<param name="angle2">a <see cref="T:System.Int32" /><para>
The number of 1/64ths of a degree to sweep the arc in a clockwise direction relative to the starting angle.
</para></param>
<remarks> <remarks>
<example> <example>
Draw the left side of a circle with a radius of 5 units. Draw the left side of a circle with a radius of 5 units.
@ -646,19 +652,24 @@ The number of 1/64ths of a degree to sweep the arc in a clockwise direction rela
<Parameter Name="y_dither" Type="System.Int32" /> <Parameter Name="y_dither" Type="System.Int32" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Renders a rectangular portion of a <see cref="T:Gdk.Pixbuf" /> to a <see cref="T:Gdk.Drawable" /></summary>
<param name="gc">a <see cref="T:Gdk.GC" /></param> <param name="gc">A <see cref="T:Gdk.GC" /> used for clipping.</param>
<param name="pixbuf">a <see cref="T:Gdk.Pixbuf" /></param> <param name="pixbuf">The <see cref="T:Gdk.Pixbuf" /> to render</param>
<param name="src_x">a <see cref="T:System.Int32" /></param> <param name="src_x">Source X coordinate within pixbuf.</param>
<param name="src_y">a <see cref="T:System.Int32" /></param> <param name="src_y">Source Y coordinates within pixbuf.</param>
<param name="dest_x">a <see cref="T:System.Int32" /></param> <param name="dest_x">Destination X coordinate within drawable.</param>
<param name="dest_y">a <see cref="T:System.Int32" /></param> <param name="dest_y">Destination Y coordinate within drawable.</param>
<param name="width">a <see cref="T:System.Int32" /></param> <param name="width">Width of region to render, in pixels, or -1 to use pixbuf width. </param>
<param name="height">a <see cref="T:System.Int32" /></param> <param name="height"> Height of region to render, in pixels, or -1 to use pixbuf height.</param>
<param name="dither">a <see cref="T:Gdk.RgbDither" /></param> <param name="dither">Dithering mode for GdkRGB.</param>
<param name="x_dither">a <see cref="T:System.Int32" /></param> <param name="x_dither">X offset for dither.</param>
<param name="y_dither">a <see cref="T:System.Int32" /></param> <param name="y_dither">Y offset for dither.</param>
<remarks /> <remarks>The destination drawable must have a colormap. All windows have a colormap, however, pixmaps only have colormap by default if they were created with a non-NULL window argument. Otherwise a colormap must be set on them on the <see cref="P:Gdk.Drawable.Colormap" /> property.
<para>
On older X servers, rendering pixbufs with an alpha channel involves round trips to the X server, and may be somewhat slow.
</para><para>
The clip mask of gc is ignored, but clip rectangles and clip regions work fine.
</para></remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="DrawRectangle"> <Member MemberName="DrawRectangle">
@ -942,13 +953,13 @@ The number of 1/64ths of a degree to sweep the arc in a clockwise direction rela
<Parameter Name="text" Type="System.String" /> <Parameter Name="text" Type="System.String" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Deprecated: use <see cref="M:Gdk.Drawable.DrawLayout" /> instead.</summary>
<param name="font">a <see cref="T:Gdk.Font" /></param> <param name="font">a <see cref="T:Gdk.Font" /></param>
<param name="gc">a <see cref="T:Gdk.GC" /></param> <param name="gc">a <see cref="T:Gdk.GC" /></param>
<param name="x">a <see cref="T:System.Int32" /></param> <param name="x">a <see cref="T:System.Int32" /></param>
<param name="y">a <see cref="T:System.Int32" /></param> <param name="y">a <see cref="T:System.Int32" /></param>
<param name="text">a <see cref="T:System.String" /></param> <param name="text">a <see cref="T:System.String" /></param>
<remarks>To be added</remarks> <remarks>Deprecated.</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="DrawTextWc"> <Member MemberName="DrawTextWc">
@ -965,14 +976,14 @@ The number of 1/64ths of a degree to sweep the arc in a clockwise direction rela
<Parameter Name="text_length" Type="System.Int32" /> <Parameter Name="text_length" Type="System.Int32" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Deprecated: draws a numbre of wide-char characters</summary>
<param name="font">a <see cref="T:Gdk.Font" /></param> <param name="font">a <see cref="T:Gdk.Font" /></param>
<param name="gc">a <see cref="T:Gdk.GC" /></param> <param name="gc">a <see cref="T:Gdk.GC" /></param>
<param name="x">a <see cref="T:System.Int32" /></param> <param name="x">a <see cref="T:System.Int32" /></param>
<param name="y">a <see cref="T:System.Int32" /></param> <param name="y">a <see cref="T:System.Int32" /></param>
<param name="text_length">a <see cref="T:System.Int32" /></param> <param name="text_length">a <see cref="T:System.Int32" /></param>
<returns>a <see cref="T:System.UInt32" /></returns> <returns>a <see cref="T:System.UInt32" /></returns>
<remarks>To be added</remarks> <remarks>Use <see cref="M:Gdk.Drawable.DrawLayout" /> instead.</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="DrawString"> <Member MemberName="DrawString">
@ -989,7 +1000,7 @@ The number of 1/64ths of a degree to sweep the arc in a clockwise direction rela
<Parameter Name="str1ng" Type="System.String" /> <Parameter Name="str1ng" Type="System.String" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Deprecated: use <see cref="M:Gdk.Drawable.DrawLayout" /> instead.</summary>
<param name="font">a <see cref="T:Gdk.Font" /></param> <param name="font">a <see cref="T:Gdk.Font" /></param>
<param name="gc">a <see cref="T:Gdk.GC" /></param> <param name="gc">a <see cref="T:Gdk.GC" /></param>
<param name="x">a <see cref="T:System.Int32" /></param> <param name="x">a <see cref="T:System.Int32" /></param>
@ -1008,7 +1019,7 @@ The number of 1/64ths of a degree to sweep the arc in a clockwise direction rela
<Parameter Name="key" Type="System.String" /> <Parameter Name="key" Type="System.String" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>This method is deprecated, do not use.</summary>
<param name="key">a <see cref="T:System.String" /></param> <param name="key">a <see cref="T:System.String" /></param>
<returns>a <see cref="T:System.IntPtr" /></returns> <returns>a <see cref="T:System.IntPtr" /></returns>
<remarks>To be added</remarks> <remarks>To be added</remarks>
@ -1043,7 +1054,7 @@ The number of 1/64ths of a degree to sweep the arc in a clockwise direction rela
<Parameter Name="height" Type="System.Int32" /> <Parameter Name="height" Type="System.Int32" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>Copies a portion of drawable into the client side image structure image.</summary>
<param name="image">a <see cref="T:Gdk.Image" /></param> <param name="image">a <see cref="T:Gdk.Image" /></param>
<param name="src_x">a <see cref="T:System.Int32" /></param> <param name="src_x">a <see cref="T:System.Int32" /></param>
<param name="src_y">a <see cref="T:System.Int32" /></param> <param name="src_y">a <see cref="T:System.Int32" /></param>
@ -1079,11 +1090,12 @@ The number of 1/64ths of a degree to sweep the arc in a clockwise direction rela
<Parameter Name="destroy_func" Type="System.IntPtr" /> <Parameter Name="destroy_func" Type="System.IntPtr" />
</Parameters> </Parameters>
<Docs> <Docs>
<summary>To be added</summary> <summary>This method is deprecated and should not be used with new code.</summary>
<param name="key">a <see cref="T:System.String" /></param> <param name="key">a <see cref="T:System.String" /></param>
<param name="data">a <see cref="T:System.IntPtr" /></param> <param name="data">a <see cref="T:System.IntPtr" /></param>
<param name="destroy_func">a <see cref="T:System.IntPtr" /></param> <param name="destroy_func">a <see cref="T:System.IntPtr" /></param>
<remarks>To be added</remarks> <remarks>This method is deprecated and should not be used in newly-written code.
</remarks>
</Docs> </Docs>
</Member> </Member>
<Member MemberName="DrawRectangleAlphaLibgtkOnly"> <Member MemberName="DrawRectangleAlphaLibgtkOnly">