The-Homebrew-Cloud/Ryujinx-GtkSharp
2
0
Fork 0
mirror of https://github.com/Ryujinx/GtkSharp.git synced 2024-09-08 07:53:17 +02:00
Code Issues Packages Projects Releases Wiki Activity

validation/rendering fixes

Browse Source 
svn path=/trunk/gtk-sharp/; revision=32766
This commit is contained in:
John Luke 2004-08-24 17:01:00 +00:00
parent 7d124df67a
commit a8b81fb34d
26 changed files with 85 additions and 90 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
doc/en/Atk/EditableText.xml
View File

@ -82,7 +82,7 @@
<param name="end_pos">end position</param>
<remarks>
<para>
This method only cuts the text up to <paremref name="end_pos" />, it does not include the text at that position.
This method only cuts the text up to <paramref name="end_pos" />, it does not include the text at that position.
</para>
</remarks>
</Docs>
@ -103,7 +103,7 @@
<param name="end_pos">end position</param>
<remarks>
<para>
This method only copies the text up to <paremref name="end_pos" />, it does not include the text at that position.
This method only copies the text up to <paramref name="end_pos" />, it does not include the text at that position.
</para>
</remarks>
</Docs>
@ -170,4 +170,4 @@
<remarks /></Docs>
</Member>
</Members>
</Type>
</Type>

4
doc/en/Gdk/GC.xml
View File

@ -59,7 +59,7 @@
<param name="src_gc">The GC to copy.</param>
<remarks>
<para>
Copies the settings of the <param name="src_gc" /> graphics
Copies the settings of the <paramref name="src_gc" /> graphics
context into this GC.
</para>
</remarks>
@ -659,4 +659,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

4
doc/en/Gnome/Canvas.xml
View File

@ -325,7 +325,7 @@
</param>
<returns>
<see langword="true" /> if spec is non-NULL and the color is
allocated. If spec is <see langwod="null" />, then returns
allocated. If spec is <see langword="null" />, then returns
<see langword="false" />.
</returns>
<remarks>To be added</remarks>
@ -976,4 +976,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

4
doc/en/Gnome/RestartStyle.xml
View File

@ -11,7 +11,7 @@
<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>The various ways in which the session manager can restart a client.</summary>
<remarks>Set by calling <c ref="P:Gnome.Client.RestartStyle" />.</remarks>
<remarks>Set by calling <see cref="P:Gnome.Client.RestartStyle" />.</remarks>
</Docs>
<Base>
<BaseTypeName>System.Enum</BaseTypeName>
@ -95,4 +95,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

4
doc/en/Gtk/AccelGroup.xml
View File

@ -104,7 +104,7 @@
<summary>Installs an accelerator in this group, using an
accelerator path to look up the appropriate key and modifiers
(see 'gtk_accel_map_add_entry'). When the
group is being activated in response to a call to <see cref="M:Gtk.AccelGroup.Activate" />, <see parmaref="closure" /> will be invoked if the accel_key and
group is being activated in response to a call to <see cref="M:Gtk.AccelGroup.Activate" />, <paramref name="closure" /> will be invoked if the accel_key and
accel_mods from <see cref="M:Gtk.AccelGroup.Activate" />
match the key and modifiers for the path.</summary>
<param name="accel_path">Path used for determining key and modifiers.</param>
@ -309,4 +309,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

14
doc/en/Gtk/Box.xml
View File

@ -54,8 +54,8 @@
<Docs>
<summary>Change the packing properties of a child that is currently in this box.</summary>
<param name="child">The child widget whose layout should be adjusted</param>
<param name="expand">If <lang keyword="true" />, the child widget will expand to use as much space as it is given.</param>
<param name="fill">If <lang keyword="true" />, the child widget will request as much space as is available.</param>
<param name="expand">If <see langword="true" />, the child widget will expand to use as much space as it is given.</param>
<param name="fill">If <see langword="true" />, the child widget will request as much space as is available.</param>
<param name="padding">The size (in pixels) of a border to place around the specified child widget.</param>
<param name="pack_type">Whether this child widget should be packed from the beginning of the box, (eg. the left, or the top), or from the end, (eg. the right or the bottom)</param>
<remarks>
@ -112,8 +112,8 @@
<Docs>
<summary>Add a widget to the 'start' of a box with the specified packing properties.</summary>
<param name="child">A widget to pack into the box.</param>
<param name="expand">If <lang keyword="true" />, the child widget will expand to use as much space as it is given.</param>
<param name="fill">If <lang keyword="true" />, the child widget will request as much space as is available.</param>
<param name="expand">If <see langword="true" />, the child widget will expand to use as much space as it is given.</param>
<param name="fill">If <see langword="true" />, the child widget will request as much space as is available.</param>
<param name="padding">The size (in pixels) of a border to place around the specified child widget.</param>
<remarks>
<para>To add a widget to the start of a box with default packing, use <see cref="M:PackStart()" /></para>
@ -135,8 +135,8 @@
<Docs>
<summary>Add a widget to the 'end' of a box with the specified packing properties.</summary>
<param name="child">A widget to pack into the box.</param>
<param name="expand">If <lang keyword="true" />, the child widget will expand to use as much space as it is given.</param>
<param name="fill">If <lang keyword="true" />, the child widget will request as much space as is available.</param>
<param name="expand">If <see langword="true" />, the child widget will expand to use as much space as it is given.</param>
<param name="fill">If <see langword="true" />, the child widget will request as much space as is available.</param>
<param name="padding">The size (in pixels) of a border to place around the specified child widget.</param>
<remarks>
<para>To add a widget to the end of a box with default packing, use <see cref="M:PackEnd()" /></para>
@ -283,4 +283,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

4
doc/en/Gtk/ButtonPressEventHandler.xml
View File

@ -9,7 +9,7 @@
<Docs>
<summary>Represents a method that will handle a button press event</summary>
<remarks>
The events is provided an <see paramref="args" /> value that contains
The events is provided an <paramref name="args" /> value that contains
the event data (<see cref="T:Gtk.ButtonPressEventArgs" />).
</remarks>
</Docs>
@ -33,4 +33,4 @@
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
</Type>
</Type>

4
doc/en/Gtk/Clipboard.xml
View File

@ -17,8 +17,8 @@
<para>
<see cref="M:Gtk.Clipboard.SetWithData()" /> and <see cref="M:Gtk.Clipboard.SetWithOwner()" /> are quite similar; the choice between the two depends mostly on which is more convenient in a particular situation. The former is most useful when you want to have a blob of data with callbacks to convert it into the various data types that you advertise. When the clear_func you provided is called, you simply free the data blob. The latter is more useful when the contents of clipboard reflect the internal state of a <see cref="T:GLib.Object" /> (As an example, for the PRIMARY clipboard, when an entry widget provides the contents for the clipboar the contents are simply the text within the selected region.) If the contents change, the entry widget can call <see cref="M:Gtk.Clipboard.SetWithOwner()" /> to update the timestamp for clipboard ownership, without having to worry about clear_func being called.</para>
<para>Requesting the data from the clipboard is essentially asynchronous. If the contents of the clipboard are provided within the same process, then a direct function call will be made to retrieve the data, but if they are provided by another process, then the data needs to be retrieved from the other process, which may take some time. To avoid blocking the user interface, the call to request the selection, <see cref="M:Gtk.Clipboard.RequestContents()" /> takes a callback that will be called when the contents are received (or when the request fails.) If you do not want to deal with providing a separate callback, you can also use <see cref="M:Gtk.Clipboard.WaitForContents()" />. What this does is run the GLib main loop recursively waiting for the contents. This can simplify the code flow, but you still have to be aware that other callbacks in your program can be called while this recursive mainloop is running.</para>
</remarks>
<para> Along with the functions to get the clipboard contents as an arbitrary data chunk, there are also functions to retrieve it as text, <see cref="M:Gtk.Clipboard.RequestText()" /> and <see cref="M:Gtk.Clipboard.WaitForText()" />. These functions take care of determining which formats are advertised by the clipboard provider, asking for the clipboard in the best available format and converting the results into the UTF-8 encoding. (The standard form for representing strings in Gtk#.)</para>
</remarks>
</Docs>
<Base>
<BaseTypeName>GLib.Opaque</BaseTypeName>
@ -308,4 +308,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

3
doc/en/Gtk/DeleteType.xml
View File

@ -75,9 +75,6 @@
<Docs>
<summary>Delete the whole line.</summary>
<remarks>
<para>
Delete the whole line, <example>like C-k in Emacs or dd in Vi</example>.
</para>
</remarks>
</Docs>
</Member>

14
doc/en/Gtk/DrawingArea.xml
View File

@ -13,14 +13,14 @@
<summary>The <see cref="T:Gtk.DrawingArea" /> widget is used for creating custom user interface elements.</summary>
<remarks>
<para>
The <see cref="T:Gtk.DrawingArea" /> widget is used for creating custom user interface elements. It's essentially a blank widget; you can draw on <paramref name="widget" />-&gt;window. After creating a drawing area, the application may want to connect to: <para>
The <see cref="T:Gtk.DrawingArea" /> widget is used for creating custom user interface elements. It's essentially a blank widget; you can draw on <paramref name="widget" />-&gt;window. After creating a drawing area, the application may want to connect to:
<list type="bullet">
<item> 1) Mouse and button press signals to respond to input from the user. (Use <see cref="M:Gtk.Widget.AddEvents" /> to enable events you wish to receive).</item>
<item> 2) The <paramref name="realize" /> signal to take any necessary actions when the widget is instantiated on a particular display. (Create GDK resources in response to this signal.)</item>
<item> 3) The <paramref name="configure_event" /> signal to take any necessary actions when the widget changes size.</item>
<item> 4) The <paramref name="expose_event" /> signal to handle redrawing the contents of the widget.</item>
<item><term> 1) Mouse and button press signals to respond to input from the user. (Use <see cref="M:Gtk.Widget.AddEvents" /> to enable events you wish to receive).</term></item>
<item><term> 2) The <paramref name="realize" /> signal to take any necessary actions when the widget is instantiated on a particular display. (Create GDK resources in response to this signal.)</term></item>
<item><term> 3) The <paramref name="configure_event" /> signal to take any necessary actions when the widget changes size.</term></item>
<item><term> 4) The <paramref name="expose_event" /> signal to handle redrawing the contents of the widget.</term></item>
</list>
</para></para>
</para>
<para>
Expose events are normally delivered when a drawing area first comes onscreen, or when it's covered by another window and then uncovered (exposed). You can also force an expose event by adding to the "damage region" of the drawing area's window; <see cref="M:Gtk.Widget.QueueDrawArea" /> and <see cref="M:Gdk.Window.InvalidateRect" /> are equally good ways to do this. You'll then get an expose event for the invalid region. See also <see cref="M:Gdk.Pixbuf.RenderToDrawable" /> for drawing a <see cref="T:Gdk.Pixbuf" />.
</para>
@ -161,4 +161,4 @@ class LayoutSample : DrawingArea
</Docs>
</Member>
</Members>
</Type>
</Type>

6
doc/en/Gtk/Entry.xml
View File

@ -181,9 +181,7 @@ class EntrySample
<MemberSignature Language="C#" Value="public virtual string GetChars (int start_pos, int end_pos);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>
<para>System.String</para>
</ReturnType>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="start_pos" Type="System.Int32" />
@ -1012,4 +1010,4 @@ class EntrySample
</Docs>
</Member>
</Members>
</Type>
</Type>

20
doc/en/Gtk/HTML.xml
View File

@ -400,9 +400,9 @@ class X {
mcs sample.cs -pkg:gtkhtml-sharp
</para>
<para>
echo "<html>
<body>Hello <b>World</b></body>
</html>" | mono sample.exe
echo "&lt;html&gt;
&lt;body&gt;Hello &lt;b&gt;World&lt;/b&gt;&lt;/body&gt;
&lt;/html&gt;" | mono sample.exe
</para>
</remarks>
</Docs>
@ -504,9 +504,9 @@ class X {
mcs sample.cs -pkg:gtkhtml-sharp
</para>
<para>
echo "<html>
<body>Hello <b>World</b></body>
</html>" | mono sample.exe
echo "&lt;html&gt;
&lt;body&gt;Hello &lt;b&gt;World&lt;/b&gt;&lt;/body&gt;
&lt;/html&gt;" | mono sample.exe
</para>
</remarks>
</Docs>
@ -866,9 +866,9 @@ class X {
mcs sample.cs -pkg:gtkhtml-sharp
</para>
<para>
echo "<html>
<body>Hello <b>World</b></body>
</html>" | mono sample.exe
echo "&lt;html&gt;
&lt;body&gt;Hello &lt;b&gt;World&lt;/b&gt;&lt;/body&gt;
&lt;/html&gt;" | mono sample.exe
</para>
</remarks>
</Docs>
@ -2085,4 +2085,4 @@ class X {
</Docs>
</Member>
</Members>
</Type>
</Type>

4
doc/en/Gtk/Label.xml
View File

@ -233,7 +233,7 @@
<summary>Toggles line wrapping within the GtkLabel widget.</summary>
<param name="value">
<see langword="true" /> makes it
break lines if text exceeds the size of the widget. <see langoword="false" /> lets the text get cut off by the edge of the widget if it exceeds the widget size.
break lines if text exceeds the size of the widget. <see langword="false" /> lets the text get cut off by the edge of the widget if it exceeds the widget size.
</param>
<returns>
<see langword="true" /> if the lines of the label are automatically wrapped.</returns>
@ -663,4 +663,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

6
doc/en/Gtk/Layout.xml
View File

@ -102,12 +102,12 @@
<Parameter Name="y" Type="System.Int32" />
</Parameters>
<Docs>
<summary>Adds <param_ref name="child_widget" /> to the <see cref="T:Gtk.Layout" />, at position (<param_ref name="x" />, <param_ref name="y" />).</summary>
<summary>Adds <paramref name="child_widget" /> to the <see cref="T:Gtk.Layout" />, at position (<paramref name="x" />, <paramref name="y" />).</summary>
<param name="child_widget">an object of type <see cref="T:Gtk.Widget" /></param>
<param name="x">an object of type <see cref="T:System.Int32" /></param>
<param name="y">an object of type <see cref="T:System.Int32" /></param>
<remarks>
<see cref="T:Gtk.Layout" /> becomes the new parent container of <param_ref name="child_widget" />.</remarks>
<see cref="T:Gtk.Layout" /> becomes the new parent container of <paramref name="child_widget" />.</remarks>
</Docs>
</Member>
<Member MemberName="Finalize">
@ -288,4 +288,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

2
doc/en/Gtk/ListStore.xml
View File

@ -10,7 +10,7 @@
</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>The ListStore is a columned list data structure to be used with <see cref="T:Gtk.TreeView" /> widget. It is the <i>model</i> part in <b>Model/View/Controller</b> design paradigm. The contents of the ListStore can be sorted and are drag-and-drop ready.
<summary>The ListStore is a columned list data structure to be used with <see cref="T:Gtk.TreeView" /> widget. It is the model part in Model/View/Controller design paradigm. The contents of the ListStore can be sorted and are drag-and-drop ready.
</summary>
<remarks />
</Docs>

4
doc/en/Gtk/Misc.xml
View File

@ -204,7 +204,7 @@
<Docs>
<summary>Gets the X and Y alignment of the widget within its allocation. See <see cref="M:Gtk.Misc.SetAlignment" />.</summary>
<param name="xalign">Location to store X alignment of misc, or <see langword="null" />.</param>
<param name="yalign">Location to store Y alignment of misc, or <See langword="null" />.</param>
<param name="yalign">Location to store Y alignment of misc, or <see langword="null" />.</param>
<remarks>
</remarks>
</Docs>
@ -248,4 +248,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

2
doc/en/Gtk/Notebook.xml
View File

@ -293,7 +293,7 @@ Don't forget to call the Show method on the widget or else the new page will not
is a <see cref="T:Gtk.Label" /> or <see langword="null" />, then
the menu label will be a newly created label with the same
text as <paramref name="tab_label" />; If <paramref name="tab_label" /> is not a <see cref="T:Gtk.Label" />,
<pararef name="menu_label" /> must be specified if the
<paramref name="menu_label" /> must be specified if the
page-switch menu is to be used.
</param>
<remarks>

4
doc/en/Gtk/ScrolledWindow.xml
View File

@ -280,7 +280,7 @@
<Member MemberName="ScrollChild">
<MemberSignature Language="C#" Value="public event Gtk.ScrollChildHandler ScrollChild;" />
<MemberType>Event</MemberType>
<ReturnpValue />
<ReturnValue />
<Parameters />
<Docs>
<summary>To be added</summary>
@ -359,4 +359,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

10
doc/en/Gtk/TextBuffer.xml
View File

@ -294,7 +294,7 @@
<Parameter Name="where" Type="Gtk.TextIter" />
</Parameters>
<Docs>
<summary>Moves mark to the new location <see paremref="where" />.</summary>
<summary>Moves mark to the new location <paramref name="where" />.</summary>
<param name="mark">a <see cref="T:Gtk.TextMark" />.</param>
<param name="where">the new location for mark in buffer</param>
<remarks>
@ -418,7 +418,7 @@
Copies text, tags, and pixbufs between <paramref name="start" /> and <paramref name="end" /> (the
order does not matter) and inserts the
copy at <paramref name="iter" />. Used instead of simply getting/inserting
text because it preserves images and tags. If <see paremref="start" /> and
text because it preserves images and tags. If <paramref name="start" /> and
<paramref name="end" /> are in a different buffer from buffer, the two buffers
must share the same tag table.
</para>
@ -585,7 +585,7 @@
<Parameter Name="clipboard" Type="Gtk.Clipboard" />
</Parameters>
<Docs>
<summary>Adds <parmred name="clipboard" /> to the list of clipboards in which the selection contents of buffer are available.</summary>
<summary>Adds <paramref name="clipboard" /> to the list of clipboards in which the selection contents of buffer are available.</summary>
<param name="clipboard">an object of type <see cref="T:Gtk.Clipboard" /></param>
<remarks>In most cases, clipboard will be the <see cref="T:Gtk.Clipboard" /> of type <see cref="F:Gdk.Selection.Primary" /> for a view of buffer.</remarks>
</Docs>
@ -764,7 +764,7 @@
<returns>a string containing the text from the specified range</returns>
<remarks>
<para>
Returns the text in the range specified by <see paremref="start" /> and <see paremref="end" />. Excludes
Returns the text in the range specified by <paramref name="start" /> and <paramref name="end" />. Excludes
undisplayed text (text marked with tags that set the
invisibility attribute) if <paramref name="include_hidden_chars" /> is <see langword="false" />. Does not include characters
representing embedded images, so byte and character
@ -1665,4 +1665,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

4
doc/en/Gtk/TextView.xml
View File

@ -519,7 +519,7 @@ class TextViewSample
<Parameter Name="xalign" Type="System.Double" />
<Parameter Name="yalign" Type="System.Double" />
</Parameters>
<Docs>p
<Docs>
<summary>
Scrolls the text view so that <paramref name="iter" /> is on
the screen in the position indicated by <paramref name="xalign" /> and <paramref name="yalign" /></summary><param name="iter">the given <see cref="T:Gtk.TextIter" /></param><param name="within_margin">
@ -1339,4 +1339,4 @@ class TextViewSample
</Docs>
</Member>
</Members>
</Type>
</Type>

4
doc/en/Gtk/TreeViewColumn.xml
View File

@ -572,7 +572,7 @@
<param name="start_pos">a <see cref="T:System.Int32&amp;" /></param>
<param name="width">a <see cref="T:System.Int32&amp;" /></param>
<returns>a <see cref="T:System.Boolean" /></returns>
<remarks>If the cell is not found in the column, <param name="start_pos" /> and <param name="width" /> are not changed and <see langword="false" /> is returned.</remarks>
<remarks>If the cell is not found in the column, <paramref name="start_pos" /> and <paramref name="width" /> are not changed and <see langword="false" /> is returned.</remarks>
</Docs>
</Member>
<Member MemberName="CellGetSize">
@ -651,4 +651,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

8
doc/en/Gtk/Widget.xml
View File

@ -1284,7 +1284,7 @@
<returns>The topmost ancestor of <paramref name="widget" />, or <paramref name="widget" /> itself if there's no ancestor.</returns>
<remarks>
<para>
Note the difference in behavior against <see cref="P:Gtk.Widget.GetAncestor" />, would return <see langwod="null" /> if <paramref name="widget" /> wasn't inside a toplevel window, and if the window was inside a GtkWindow-derived <paramref name="widget" /> which was in turn inside the toplevel <see cref="T:Gtk.Window" />. While the second case may seem unlikely, it actually happens when a <see cref="T:Gtk.Plug" /> is embedded inside a <see cref="T:Gtk.Socket" /> within the same application. To reliably find the toplevel <see cref="T:Gtk.Window" />, use <see cref="P:Gtk.Widget.TopLevel" /> and check if the <see cref="F:Gtk.WidgetFlags.TopLevel" /> flag is set on the result.
Note the difference in behavior against <see cref="P:Gtk.Widget.GetAncestor" />, would return <see langword="null" /> if <paramref name="widget" /> wasn't inside a toplevel window, and if the window was inside a GtkWindow-derived <paramref name="widget" /> which was in turn inside the toplevel <see cref="T:Gtk.Window" />. While the second case may seem unlikely, it actually happens when a <see cref="T:Gtk.Plug" /> is embedded inside a <see cref="T:Gtk.Socket" /> within the same application. To reliably find the toplevel <see cref="T:Gtk.Window" />, use <see cref="P:Gtk.Widget.TopLevel" /> and check if the <see cref="F:Gtk.WidgetFlags.TopLevel" /> flag is set on the result.
</para>
</remarks>
</Docs>
@ -1482,8 +1482,8 @@ the widget will not be sensitive. Use
<c>widget.Parent.Sensitive</c>
to check whether the ancestor widget is sensitive or not.
</para>
<seealso cref="P:Gtk.Widget.Parent" />
<seealso cref="M:Gtk.Widget.GetAncestor(uint)" />
<see cref="P:Gtk.Widget.Parent" />
<see cref="M:Gtk.Widget.GetAncestor(uint)" />
<para>
When the sensitive property is set to false, the widget
property <see cref="P:Gtk.Widget.CanDefault" /> will return false.
@ -3959,4 +3959,4 @@ Widgets are required to honor the size allocation they receive; a size request i
<remarks>None</remarks>
</Docs>
</Member></Members>
</Type>
</Type>

32
doc/en/Gtk/Window.xml
View File

@ -257,7 +257,7 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height);</code>
If <see cref="M:Gtk.Window.ParseGeometry" /> returns <see langword="true" />, it will also set the <paramref name="F:Gdk.WindowHints.UserPos" /> and/or <see cref="F:Gdk.WindowHints.UserSize" /> hints indicating to the window manager that the size/position of the <paramref name="window" /> was user-specified. This causes most window managers to honor the geometry.
</para>
<para>
Note that for <see cref="M:Gtk.Window.ParseGeometry" /> to work as expected, it has to be called when the <paramref name="window" /> has its "final" size, i.e. after calling <see cref="M:Gtk.Widget.ShowAll" /> on the contents and <see cref="M:Gtk.Window.SetGeometryHints" /> on the <paramref nmae="window" />.
Note that for <see cref="M:Gtk.Window.ParseGeometry" /> to work as expected, it has to be called when the <paramref name="window" /> has its "final" size, i.e. after calling <see cref="M:Gtk.Widget.ShowAll" /> on the contents and <see cref="M:Gtk.Window.SetGeometryHints" /> on the <paramref name="window" />.
</para>
</remarks>
</Docs>
@ -387,13 +387,13 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height);</code>
<see cref="M:Gtk.Window.GetPosition" /> is not 100% reliable because the X Window System does not specify a way to obtain the geometry of the decorations placed on a <paramref name="window" /> by the window manager. Thus GTK# is using a "best guess" that works with most window managers.
</para>
<para>
Moreover, nearly all window managers are historically broken with respect to their handling of window gravity. So moving a <paramref name="window" /> to its current position as returned by <see cref="M:Gtk.Window.GetPostion" /> tends to result in moving the <paramef name="window" /> slightly. Window managers are slowly getting better over time.
Moreover, nearly all window managers are historically broken with respect to their handling of window gravity. So moving a <paramref name="window" /> to its current position as returned by <see cref="M:Gtk.Window.GetPostion" /> tends to result in moving the <paramref name="window" /> slightly. Window managers are slowly getting better over time.
</para>
<para>
If a <paramef name="window" /> has gravity <see cref="F.Gdk.Gravity.Static" /> the window manager frame is not relevant, and thus <see cref="M:Gtk.Window.GetPosition" /> will always produce accurate results. However you can't use static gravity to do things like place a <paramef name="window" /> in a corner of the screen, because static gravity ignores the window manager decorations.
If a <paramref name="window" /> has gravity <see cref="F.Gdk.Gravity.Static" /> the window manager frame is not relevant, and thus <see cref="M:Gtk.Window.GetPosition" /> will always produce accurate results. However you can't use static gravity to do things like place a <paramref name="window" /> in a corner of the screen, because static gravity ignores the window manager decorations.
</para>
<para>
If you are saving and restoring your application's <paramef name="window" /> positions, you should know that it's impossible for applications to do this without getting it somewhat wrong because applications do not have sufficient knowledge of window manager state. The Correct Mechanism is to support the session management protocol (see the "GnomeClient" object in the GNOME libraries for example) and allow the window manager to save your <paramef name="window" /> sizes and positions.
If you are saving and restoring your application's <paramref name="window" /> positions, you should know that it's impossible for applications to do this without getting it somewhat wrong because applications do not have sufficient knowledge of window manager state. The Correct Mechanism is to support the session management protocol (see the "GnomeClient" object in the GNOME libraries for example) and allow the window manager to save your <paramref name="window" /> sizes and positions.
</para>
</remarks>
</Docs>
@ -409,7 +409,7 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height);</code>
<summary>Asks to deiconify (i.e. unminimizw) the specified <paramref name="window" />.</summary>
<remarks>
<para>
Note that you shouldn't assume the <paramef name="window" /> is definitely deiconified afterward, because other entities (e.g. the user or window manager) could iconify it again before your code which assumes deiconification gets to run.
Note that you shouldn't assume the <paramref name="window" /> is definitely deiconified afterward, because other entities (e.g. the user or window manager) could iconify it again before your code which assumes deiconification gets to run.
</para>
<para>
You can track iconification via the <see cref="F:Gtk.Widget.WindowStateEvent" /> event on GtkWidget.
@ -465,10 +465,10 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height);</code>
<summary>Asks to maximize <paramref name="window" />, so that it becomes full-screen.</summary>
<remarks>
<para>
Note that you shouldn't assume the <paramef name="window" /> is definitely maximized afterward, because other entities (e.g. the user or window manager) could unmaximize it again, and not all window managers support maximization. But normally the <paramef name="window" /> will end up maximized. Just don't write code that crashes if not.
Note that you shouldn't assume the <paramref name="window" /> is definitely maximized afterward, because other entities (e.g. the user or window manager) could unmaximize it again, and not all window managers support maximization. But normally the <paramref name="window" /> will end up maximized. Just don't write code that crashes if not.
</para>
<para>
You can track maximization via the <see cref="F:Gtk.Widget.WindowStateEvent" /> event on <see cref="T.Gtk.Widget" />. It's permitted to call this method before showing a <paramref name="window" />, in which case the <pramref name="window" /> will be maximized when it appears onscreen initially.
You can track maximization via the <see cref="F:Gtk.Widget.WindowStateEvent" /> event on <see cref="T.Gtk.Widget" />. It's permitted to call this method before showing a <paramref name="window" />, in which case the <paramref name="window" /> will be maximized when it appears onscreen initially.
</para>
</remarks>
</Docs>
@ -566,10 +566,10 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height);</code>
For more control over a <paramref name="window" />'s initial size and how resizing works, investigate <see cref="M:Gtk.Window.SetGeometryHints" />.
</para>
<para>
For some uses, <see cref="M:Gtk.Window.Resize" /> is a more appropriate method. <see cref="M:Gtk.Window.Resize" /> changes the current size of the <parmref name="window" />, rather than the size to be used on initial display. <see cref="M:Gtk.Window.Resize" /> always affects the <paramref name="window" /> itself, not the geometry widget.
For some uses, <see cref="M:Gtk.Window.Resize" /> is a more appropriate method. <see cref="M:Gtk.Window.Resize" /> changes the current size of the <paramref name="window" />, rather than the size to be used on initial display. <see cref="M:Gtk.Window.Resize" /> always affects the <paramref name="window" /> itself, not the geometry widget.
</para>
<para>
The default size of a <pamaref name="window" /> only affects the first time a <paramref name="window" /> is shown; if a <paramref name="window" /> is hidden and re-shown, it will remember the size it had prior to hiding, rather than using the default size.
The default size of a <paramref name="window" /> only affects the first time a <paramref name="window" /> is shown; if a <paramref name="window" /> is hidden and re-shown, it will remember the size it had prior to hiding, rather than using the default size.
</para>
</remarks>
</Docs>
@ -585,10 +585,10 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height);</code>
<summary>Presents a <paramref name="window" /> to the user.</summary>
<remarks>
<para>
This may mean raising the <paramref name="window" /> in the stacking order, deiconifying it, moving it to the current desktop, and/or giving it the keyboard focus, possibly dependent on the user's platform, window manager, and preferences. If <paramef name="window" /> is hidden, this method calls <see cref="M:Gtk.Widget.Show" /> as well.
This may mean raising the <paramref name="window" /> in the stacking order, deiconifying it, moving it to the current desktop, and/or giving it the keyboard focus, possibly dependent on the user's platform, window manager, and preferences. If <paramref name="window" /> is hidden, this method calls <see cref="M:Gtk.Widget.Show" /> as well.
</para>
<para>
This method should be used when the user tries to open a <paramef name="window" /> that's already open. Say for example the preferences dialog is currently open, and the user chooses Preferences from the menu a second time; use <see cref="M:Gtk.Window.Present" /> to move the already-open dialog where the user can see it.
This method should be used when the user tries to open a <paramref name="window" /> that's already open. Say for example the preferences dialog is currently open, and the user chooses Preferences from the menu a second time; use <see cref="M:Gtk.Window.Present" /> to move the already-open dialog where the user can see it.
</para>
</remarks>
</Docs>
@ -625,7 +625,7 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height);</code>
<param name="y">Y coordinate to move <paramref name="window" /> to.</param>
<remarks>
<para>
Window managers are free to ignore this; most window managers ignore requests for initial window positions (instead using a user-defined placement algorithm) and honor requests after the <paramef name="window" /> has already been shown.
Window managers are free to ignore this; most window managers ignore requests for initial window positions (instead using a user-defined placement algorithm) and honor requests after the <paramref name="window" /> has already been shown.
</para>
<para>
Note: the position is the position of the gravity-determined reference point for the <paramref name="window" />. The gravity determines two things: first, the location of the reference point in root <paramref name="window" /> coordinates; and second, which point on the <paramref name="window" /> is positioned at the reference point.
@ -1152,7 +1152,7 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height);</code>
<see langword="true" /> if the <paramref name="window" /> has no minimum size.</returns>
<remarks>
<para>
Setting this to <pararemf name="true" /> is 99% of the time a bad idea.
Setting this to <paramref name="true" /> is 99% of the time a bad idea.
</para>
</remarks>
</Docs>
@ -1309,7 +1309,7 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height);</code>
</Parameters>
<Docs>
<summary>Whether the <paramref name="window" /> should not be in the pager.</summary>
<param name="value">If <see langwoed="true" /> then the <paramref name="window" /> will not be in the pager.</param>
<param name="value">If <see langword="true" /> then the <paramref name="window" /> will not be in the pager.</param>
<returns>
<see langword="true" /> if the <paramref name="window" /> should not be in the pager.</returns>
<remarks>
@ -1326,7 +1326,7 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height);</code>
</Parameters>
<Docs>
<summary>Whether the <paramref name="window" /> should not be in the taskbar.</summary>
<param name="value">If <see langword="true" /> then the <see paramref="window" /> will not be in the taskbar.</param>
<param name="value">If <see langword="true" /> then the <paramref name="window" /> will not be in the taskbar.</param>
<returns>
<see langword="true" /> if the <paramref name="window" /> should not be in the taskbar.</returns>
<remarks>
@ -1632,4 +1632,4 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height);</code>
</Docs>
</Member>
</Members>
</Type>
</Type>

2
doc/en/Pango/AttrClass.xml
View File

@ -61,4 +61,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

2
doc/en/Pango/Color.xml
View File

@ -141,4 +141,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>

4
doc/en/Pango/LayoutIter.xml
View File

@ -55,7 +55,7 @@
<param name="ink_rect"> rectangle to fill with ink extents</param>
<param name="logical_rect"> rectangle to fill with logical extents</param>
<remarks>
<paramref name="ink_rect" /> or <parmref name="logical_rect" /> can be <see langword="null" /> if you are not interested in them. Extents are in layout coordinates (origin is the top-left corner of the entire <see cref="T:Pango.Layout" />). Thus the extents returned by this function will be the same width/height but not at the same x/y as the extents returned from <see cref="M:Pango.LayoutLineGetExtents()" />.</remarks>
<paramref name="ink_rect" /> or <paramref name="logical_rect" /> can be <see langword="null" /> if you are not interested in them. Extents are in layout coordinates (origin is the top-left corner of the entire <see cref="T:Pango.Layout" />). Thus the extents returned by this function will be the same width/height but not at the same x/y as the extents returned from <see cref="M:Pango.LayoutLineGetExtents()" />.</remarks>
</Docs>
</Member>
<Member MemberName="NextRun">
@ -267,4 +267,4 @@
</Docs>
</Member>
</Members>
</Type>
</Type>