diff --git a/doc/en/Gtk/ArrowType.xml b/doc/en/Gtk/ArrowType.xml index 983c350f3..4b10609f4 100644 --- a/doc/en/Gtk/ArrowType.xml +++ b/doc/en/Gtk/ArrowType.xml @@ -1,5 +1,5 @@ - + gtk-sharp 0.0.0.0 @@ -7,7 +7,7 @@ To be added - To be added + Used to indicate the direction in which a GtkArrow should point. To be added @@ -34,7 +34,7 @@ - To be added + Represents an upward pointing arrow. To be added @@ -46,7 +46,7 @@ - To be added + Represents an downward pointing arrow. To be added @@ -58,7 +58,7 @@ - To be added + Represents a left pointing arrow. To be added @@ -70,7 +70,7 @@ - To be added + Represents a right pointing arrow. To be added diff --git a/doc/en/Gtk/AttachOptions.xml b/doc/en/Gtk/AttachOptions.xml index 6b665ed77..c8acd4cf2 100644 --- a/doc/en/Gtk/AttachOptions.xml +++ b/doc/en/Gtk/AttachOptions.xml @@ -1,5 +1,5 @@ - + gtk-sharp 0.0.0.0 @@ -7,7 +7,7 @@ To be added - To be added + Denotes the expansion properties that a widget will have when it (or it's parent) is resized. To be added @@ -34,7 +34,7 @@ - To be added + the widget should expand to take up any extra space in its container that has been allocated. To be added @@ -46,7 +46,7 @@ - To be added + the widget should shrink as and when possible. To be added @@ -58,7 +58,7 @@ - To be added + the widget should fill the space allocated to it. To be added diff --git a/doc/en/Gtk/CurveType.xml b/doc/en/Gtk/CurveType.xml index 323fae33b..07ed0a536 100644 --- a/doc/en/Gtk/CurveType.xml +++ b/doc/en/Gtk/CurveType.xml @@ -1,5 +1,5 @@ - + gtk-sharp 0.0.0.0 @@ -34,7 +34,7 @@ - To be added + linear interpolation To be added @@ -46,7 +46,7 @@ - To be added + spline interpolation To be added @@ -58,7 +58,7 @@ - To be added + free form curve To be added diff --git a/doc/en/Gtk/Dialog.xml b/doc/en/Gtk/Dialog.xml index 53db1a66e..4013cdbd7 100644 --- a/doc/en/Gtk/Dialog.xml +++ b/doc/en/Gtk/Dialog.xml @@ -1,5 +1,5 @@ - + gtk-sharp 0.0.0.0 @@ -7,8 +7,14 @@ To be added - To be added - To be added + Creates popup windows. + + Dialog boxes are a convenient way to prompt the user for a small amount of input, eg. to display a message, ask a question, or anything else that does not require extensive effort on the user's part. + GTK+ treats a dialog as a window split vertically. The top section is a , and is where widgets such as a or an should be packed. The bottom area is known as the . This is generally used for packing buttons into the dialog which may perform functions such as cancel, ok, or apply. The two areas are separated by a . + The two primary areas of a dialog can be accessed as the property and the property. To set the dialog to be model, use the property. + If you want to block waiting for a dialog to return before returning control flow to your code, you can call . This function enters a recursive main loop and waits for the user to respond to the dialog, returning the response ID corresponding to the button the user clicked. + For the simple dialog, in reality you'd probably use a to save yourself some effort. But you'd need to create the dialog contents manually if you had more than a simple message in the dialog. + Gtk.Window diff --git a/doc/en/Gtk/Entry.xml b/doc/en/Gtk/Entry.xml index 7d91b357d..1a7b470e1 100644 --- a/doc/en/Gtk/Entry.xml +++ b/doc/en/Gtk/Entry.xml @@ -54,8 +54,8 @@ See also the widget for displaying and editing larg Add arbitrary text to the entry. the text to add - The number of characters added - Use this method to insert a string at the current CursorPosition. + The number of characters added. + Use this method to insert a string at the current CursorPosition. @@ -118,7 +118,7 @@ See also the widget for displaying and editing larg Method - System.String + System.String @@ -128,7 +128,7 @@ See also the widget for displaying and editing larg Specific implementation of Gtk.Editable.GetChars for the Entry widget. The index of the first character to get, (zero-indexed). The index of the character to retrieve up to. - A string representing the characters from , up to, but not including . If is negative, then the the characters retrieved will be those characters from to the end of the text. + A string representing the characters from , up to, but not including . If is negative, then the the characters retrieved will be those characters from to the end of the text. @@ -187,7 +187,7 @@ See also the widget for displaying and editing larg Get the the positions of the start and end of the current selection, if there is one. output variable for the character index of the selection start output variable for the character index of the end of the selection - true if there is a selection, false otherwise + if there is a selection, otherwise. @@ -219,7 +219,7 @@ See also the widget for displaying and editing larg The text to add to the Entry The length of the new text to add, in bytes. An in/out parameter. The caller initializes it to the position at which to insert the text. After the call it points at the position after the newly inserted text. - Implements the Gtk.Editable.InsertText interface method for this Entry. + Implements the Gtk.Editable.InsertText interface method for this Entry. @@ -230,7 +230,7 @@ See also the widget for displaying and editing larg - Causes the contents of the clipboard to be pasted into the Entry at the current cursor position. + Causes the contents of the clipboard to be pasted into the Entry at the current cursor position. @@ -248,9 +248,9 @@ See also the widget for displaying and editing larg Obtains the position of the PangoLayout used to render text in the entry, in widget coordinates. X offset output of the layout Y offset output of the layout - Useful if you want to line up the text in an entry with some other text, e.g. when using the entry to implement editable cells in a sheet widget. + Useful if you want to line up the text in an entry with some other text, e.g. when using the entry to implement editable cells in a sheet widget. -Also useful to convert mouse events into coordinates inside the PangoLayout, e.g. to take some action if some part of the entry text is clicked. + Also useful to convert mouse events into coordinates inside the PangoLayout, e.g. to take some action if some part of the entry text is clicked. @@ -312,8 +312,8 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g Get the type of this object, as registered with the GLib object system. - A number that uniquely identifies this type in the GLib object system. - Mostly for internal use. + A number that uniquely identifies this type in the GLib object system. + Mostly for internal use. @@ -328,7 +328,7 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g Implements the concrete version of Gtk.Editable.IsEditable, to determine if the text of the Entry can be edited. true to allow editing of the Entry, false otherwise. - true if the Entry is editable, false otherwise. + true if the Entry is editable, false otherwise. @@ -344,8 +344,8 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g The position of the cursor. the new cursor position, in characters. - the current cursor position - The cursor is displayed before the character with the given (base 0) index in the widget. The value must be less than or equal to the number of characters in the widget. A value of -1 indicates that the position should be set after the last character in the entry. Note that this position is in characters, not in bytes. + the current cursor position + The cursor is displayed before the character with the given (base 0) index in the widget. The value must be less than or equal to the number of characters in the widget. A value of -1 indicates that the position should be set after the last character in the entry. Note that this position is in characters, not in bytes. @@ -355,9 +355,9 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g Pango.Layout - Get the object used by this Entry for text layout - The Pango.Layout used to render the text of this entry - This property is read only. + Get the object used by this Entry for text layout. + The Pango.Layout used to render the text of this entry. + This property is read only. @@ -370,10 +370,10 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g - Determine whether to display characters entered, or whether to mask them + Determine whether to display characters entered, or whether to mask them. true to display characters in the Entry, false to mask them - true if characters are being displayed, false if they are being masked - This property should be used to create entry widgets for sensitive data such as passwords. + true if characters are being displayed, false if they are being masked. + This property should be used to create entry widgets for sensitive data such as passwords. @@ -388,8 +388,8 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g The maximum number of characters that can be placed in this Entry. How many characters to limit this Entry to - The maximum number of characters that can currently be set in this Entry - This property can be useful for ensuring no more than a specific number of characters are put in an entry. + The maximum number of characters that can currently be set in this Entry. + This property can be useful for ensuring no more than a specific number of characters are put in an entry. @@ -399,9 +399,9 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g System.Int32 - The position of the cursor in the Entry's text - The current character of the cursor. - Use this property to manipulate the position of the cursor - it is displayed before the character with the given (base 0) index in the widget. The value must be less than or equal to the number of characters in the widget. A value of -1 indicates that the position should be set after the last character in the entry. Note that this position is in characters, not in bytes. + The position of the cursor in the Entry's text. + The current character of the cursor. + Use this property to manipulate the position of the cursor - it is displayed before the character with the given (base 0) index in the widget. The value must be less than or equal to the number of characters in the widget. A value of -1 indicates that the position should be set after the last character in the entry. Note that this position is in characters, not in bytes. @@ -411,8 +411,8 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g System.Int32 - The length of the selected text - the number of selected characters + The length of the selected text. + The number of selected characters. @@ -426,9 +426,9 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g - Manipulate the current text contents of an Entry + Manipulate the current text contents of an Entry. The new string to display in the Entry - overwrites any existing text in the widget. - The current text in an Entry + The current text in an Entry. @@ -456,8 +456,8 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g Changes the size request of the entry to be about the right size for characters. Requested width, in characters - The number of characters requested - Note that it changes the size request, the size can still be affected by how you pack the widget into containers. If n_chars is -1, the size reverts to the default entry size. + The number of characters requested. + Note that it changes the size request, the size can still be affected by how you pack the widget into containers. If n_chars is -1, the size reverts to the default entry size. @@ -470,10 +470,10 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g - Whether or not this Entry is editable - true to make this Entry read-only, false to allow editing. - true if this entry can be edited, false otherwise - Set this property to false if you need to stop input into an Entry widget. For displaying textual data, it is more normal to use a instead. + Whether or not this Entry is editable. + to make this Entry read-only, to allow editing. + if this entry can be edited, otherwise. + Set this property to false if you need to stop input into an Entry widget. For displaying textual data, it is more normal to use a instead. @@ -487,11 +487,11 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g Determine whether to activate the 'default widget' in the window when the return key is pressed. - set to true to activate the default button when enter is pressed, false otherwise - true if the default button will be activated, false otherwise. - If the value is true, pressing Enter in the entry will activate the default widget for the window containing the entry. This usually means that the dialog box containing the entry will be closed, since the default widget is usually one of the dialog buttons. + set to to activate the default button when enter is pressed, otherwise + if the default button will be activated, false otherwise. + If the value is , pressing Enter in the entry will activate the default widget for the window containing the entry. This usually means that the dialog box containing the entry will be closed, since the default widget is usually one of the dialog buttons. -(For experts: if the value is true, the entry calls ActivateDefault() on the containing the entry, in the default handler for the "activate" event). + (For experts: if the value is , the entry calls on the containing the entry, in the default handler for the event). @@ -504,10 +504,10 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g - Whether or not this Entry should be surrounded by a 3D frame - true to surround this Entry in a frmae (the default), false otherwise. - true if a frame surrounds this Entry, false otherwise - Unless there is a very specific reason for doing so, this property is best left to its default to ensure consistency in Entry widgets across applications. + Whether or not this Entry should be surrounded by a 3D frame. + to surround this Entry in a frame (the default), otherwise. + if a frame surrounds this Entry, otherwise + Unless there is a very specific reason for doing so, this property is best left to its default to ensure consistency in Entry widgets across applications. @@ -526,7 +526,7 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g - Implements the EditingDone method of the interface. + Implements the EditingDone method of the interface. @@ -566,7 +566,7 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g - Connect to this event handler to be notified when the cursor of an Entry moves + Connect to this event handler to be notified when the cursor of an Entry moves. Data pertaining to this event is passed with a . @@ -587,7 +587,7 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g Connect to this event to be notified when the user hits 'return'. - Connect to this event with a standard . + Connect to this event with a standard . @@ -597,7 +597,7 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g Connect to this event to find out when text is deleted from the Entry by the user. - Data pertaining to this event is encapsulated in a . + Data pertaining to this event is encapsulated in a . @@ -607,7 +607,7 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g Connect to this event to be notified when the clipboard contents are pasted into this Entry. - Connect to this event with a standard . + Connect to this event with a standard . @@ -617,7 +617,7 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g Connect to this event to be notified when the contents of the Entry are copied to the clipboard. - Connect to this event with a standard . + Connect to this event with a standard . @@ -627,7 +627,7 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g To be added - Data pertaining to this event is encapsulated in a . + Data pertaining to this event is encapsulated in a . @@ -637,7 +637,7 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g Connect to this event to discover when the Overwrite state has been changed by the user. This is usually done by pressing the 'Insert' key on a keyboard. - Connect to this event with a standard . + Connect to this event with a standard . @@ -647,7 +647,7 @@ Also useful to convert mouse events into coordinates inside the PangoLayout, e.g Connect to this event to discover when text is inserted at the cursor position - usually when the user types something in. - Data pertaining to this event is encapsulated in an . + Data pertaining to this event is encapsulated in an . diff --git a/doc/en/Gtk/Justification.xml b/doc/en/Gtk/Justification.xml index acf906697..92fd5be0d 100644 --- a/doc/en/Gtk/Justification.xml +++ b/doc/en/Gtk/Justification.xml @@ -1,5 +1,5 @@ - + gtk-sharp 0.0.0.0 @@ -7,7 +7,7 @@ To be added - To be added + Used for justifying the text inside a widget. To be added @@ -34,7 +34,7 @@ - To be added + The text is placed at the left edge of the label. To be added @@ -46,7 +46,7 @@ - To be added + The text is placed at the right edge of the label. To be added @@ -58,7 +58,7 @@ - To be added + The text is placed in the center of the label. To be added @@ -70,7 +70,7 @@ - To be added + The text is placed is distributed across the label. To be added diff --git a/doc/en/Gtk/PackType.xml b/doc/en/Gtk/PackType.xml index f3dddd75d..71be8429f 100644 --- a/doc/en/Gtk/PackType.xml +++ b/doc/en/Gtk/PackType.xml @@ -1,5 +1,5 @@ - + gtk-sharp 0.0.0.0 @@ -7,7 +7,7 @@ To be added - To be added + Represents the packing location of children. (See: , , and ). To be added @@ -34,7 +34,7 @@ - To be added + The child is packed into the start of the box. To be added @@ -46,7 +46,7 @@ - To be added + The child is packed into the end of the box To be added diff --git a/doc/en/Gtk/PolicyType.xml b/doc/en/Gtk/PolicyType.xml index 831d7c753..d40c6000c 100644 --- a/doc/en/Gtk/PolicyType.xml +++ b/doc/en/Gtk/PolicyType.xml @@ -1,5 +1,5 @@ - + gtk-sharp 0.0.0.0 @@ -7,7 +7,7 @@ To be added - To be added + Determines when a scroll bar will be visible. To be added @@ -34,7 +34,7 @@ - To be added + The scrollbar is always visible. To be added @@ -46,7 +46,7 @@ - To be added + The scrollbar will appear and disappear as necessary. To be added @@ -58,7 +58,7 @@ - To be added + The scrollbar will never appear. To be added diff --git a/doc/en/Gtk/ShadowType.xml b/doc/en/Gtk/ShadowType.xml index 5736cc2d6..aa3e9c9a8 100644 --- a/doc/en/Gtk/ShadowType.xml +++ b/doc/en/Gtk/ShadowType.xml @@ -1,5 +1,5 @@ - + gtk-sharp 0.0.0.0 @@ -7,7 +7,7 @@ To be added - To be added + Used to change the appearance of an outline typically provided by a . To be added @@ -34,7 +34,7 @@ - To be added + No outline. To be added @@ -46,7 +46,7 @@ - To be added + The outline is bevelled inwards. To be added @@ -58,7 +58,7 @@ - To be added + The outline is bevelled outwards like a button. To be added @@ -70,7 +70,7 @@ - To be added + The outline itself is an inward bevel, but the frame is an outward bevel. To be added @@ -82,7 +82,7 @@ - To be added + The outline itself is an outward bevel, but the frame is an inward bevel. To be added diff --git a/doc/en/Gtk/SortType.xml b/doc/en/Gtk/SortType.xml index a652f9127..11a677458 100644 --- a/doc/en/Gtk/SortType.xml +++ b/doc/en/Gtk/SortType.xml @@ -1,5 +1,5 @@ - + gtk-sharp 0.0.0.0 @@ -7,7 +7,7 @@ To be added - To be added + Determines the direction of a sort. To be added @@ -34,7 +34,7 @@ - To be added + Sorting is in ascending order. To be added @@ -46,7 +46,7 @@ - To be added + Sorting is in descending order. To be added diff --git a/doc/en/Gtk/WindowPosition.xml b/doc/en/Gtk/WindowPosition.xml index 0b0a9b766..89bbadb74 100644 --- a/doc/en/Gtk/WindowPosition.xml +++ b/doc/en/Gtk/WindowPosition.xml @@ -1,5 +1,5 @@ - + gtk-sharp 0.0.0.0 @@ -7,7 +7,7 @@ To be added - To be added + Window placement can be influenced using this enumeration. To be added @@ -34,7 +34,7 @@ - To be added + No influence is made on placement. To be added @@ -46,7 +46,7 @@ - To be added + Windows should be placed in the center of the screen. To be added @@ -58,7 +58,7 @@ - To be added + Windows should be placed at the current mouse position. To be added @@ -70,7 +70,7 @@ - To be added + Keep window centered as it changes size, etc. To be added @@ -82,7 +82,7 @@ - To be added + Center the window on its transient parent (see ). To be added diff --git a/doc/en/Gtk/WindowType.xml b/doc/en/Gtk/WindowType.xml index 0faca4e57..0cba0ee5d 100644 --- a/doc/en/Gtk/WindowType.xml +++ b/doc/en/Gtk/WindowType.xml @@ -1,5 +1,5 @@ - + gtk-sharp 0.0.0.0 @@ -8,7 +8,11 @@ To be added To be added - To be added + + A can be one of these types. Most things you'd consider a "window" should have type ; windows with this type are managed by the window manager and have a frame by default (call to toggle the frame). Windows with type are ignored by the window manager; window manager keybindings won't work on them, the window manager won't decorate the window with a frame, many GTK+ features that rely on the window manager will not work (e.g. resize grips and maximization/minimization). + is used to implement widgets such as or tooltips that you normally don't think of as windows per se. Nearly all windows should be . In particular, do not use just to turn off the window borders; use for instead. + + System.Enum @@ -34,7 +38,7 @@ - To be added + A regular window, such as a dialog. To be added @@ -46,7 +50,7 @@ - To be added + A special window such as a tooltip. To be added