svn path=/trunk/gtk-sharp/; revision=34925
This commit is contained in:
Miguel de Icaza 2004-10-12 19:26:02 +00:00
parent b0952e4400
commit 4f8f06c449
3 changed files with 158 additions and 140 deletions

View file

@ -13,3 +13,4 @@ Documentation:
chris@turchin.net (Chris Turchin)
jaspervp@gmx.net (Jasper van Putten)
wizito@gentelibre.org ( N<>stor Salceda)
cmorgan@alum.wpi.edu

View file

@ -241,7 +241,8 @@
<see cref="T:Gdk.Pixmap" /> and <see cref="T:Gdk.Window" /> are server-side
objects. This method obtains the pixels from a
server-side drawable as a client-side <see cref="T:Gdk.Image" />.
</p><p>
</p>
<p>
The format of a <see cref="T:Gdk.Image" /> depends on
the <see cref="T:Gdk.Visual" /> of the current display, which
makes manipulating <see cref="T:Gdk.Image" /> extremely difficult;
@ -262,22 +263,26 @@
<returns>A <see cref="T:Gdk.Image" /> containing the contents of this Drawable object.</returns>
<remarks>
<p>
</p><p>
</p>
<p>
<paramref name="x" />, <paramref name="y" />,
<paramref name="width" />, and <paramref name="height" /> define
the region of the drawable to obtain as an image.
</p><p>
</p>
<p>
You would usually copy image data to the client side if you intend
to examine the values of individual pixels, for example to darken
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,
so instead you get all of them at once, modify them, then copy
them all back at once.
</p><p>
</p>
<p>
If the X server or other windowing system backend is on the local
machine, this function may use shared memory to avoid copying
the image data.
</p><p>
</p>
<p>
If the source drawable is a #GdkWindow and partially offscreen
or obscured, then the obscured portions of the returned image
will contain undefined data.
@ -327,8 +332,7 @@
bitmap as a clip mask on your #GdkGC, then use gdk_draw_rectangle()
to draw a rectangle clipped to the bitmap.
<p>TODO: This API needs to be adjusted; <paramref name="src" /> should
probably not exist.</p>
</remarks>
probably not exist.</p></remarks>
</Docs>
</Member>
<Member MemberName="DrawImage">
@ -599,13 +603,27 @@
<summary>To be added</summary>
<param name="gc">a <see cref="T:Gdk.GC" /></param>
<param name="filled">a <see cref="T:System.Boolean" /></param>
<param name="x">a <see cref="T:System.Int32" /></param>
<param name="y">a <see cref="T:System.Int32" /></param>
<param name="x">a <see cref="T:System.Int32" /><para>
The x-coordinate of the upper left hand of the bounding box of the arc.
</para></param>
<param name="y">a <see cref="T:System.Int32" /><para>
The y-coordinate of the upper left hand of the bounding box of the arc.
</para></param>
<param name="width">a <see cref="T:System.Int32" /></param>
<param name="height">a <see cref="T:System.Int32" /></param>
<param name="angle1">a <see cref="T:System.Int32" /></param>
<param name="angle2">a <see cref="T:System.Int32" /></param>
<remarks/>
<param name="angle1">a <see cref="T:System.Int32" /><para>
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.
</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>
<example>
Draw the left side of a circle with a radius of 5 units.
<code lang="C#">
Gdk.Pixmap.DrawArc(gc, false, 0, 0, 10, 10, 90 * 64, 180 * 64);
</code></example>
</remarks>
</Docs>
</Member>
<Member MemberName="DrawPixbuf">

View file

@ -868,10 +868,9 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height);</code>
<Parameters>
</Parameters>
<Docs>
<summary>Sets ot obtains the transient parent.</summary>
<summary>Sets or obtains the transient parent window.</summary>
<param name="value">Parent <paramref name="window" />.</param>
<returns>
</returns>
<returns />
<remarks>
<para>
Dialog windows should be transient for the main <paramref name="window" /> they were spawned from, this allows windows managers to e.g. keep the dialog on top of the main <paramref name="window" />, or center the dialog over the main <paramref name="window" />.