mirror of
https://github.com/Ryujinx/GtkSharp.git
synced 2024-09-09 00:13:20 +02:00
Papacito, here are some docs from me to repent my sins.
svn path=/trunk/gtk-sharp/; revision=30134
This commit is contained in:
Duncan Mak
parent
704726109a
commit
dac325e217
@ -10,8 +10,48 @@
|
||||
</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>To be added</summary>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>
|
||||
The ATK interface provided by UI components which the user can
|
||||
activate/interact with, this should be implemented by instances
|
||||
of <see cref="T:Atk.Object" /> classes with which the user can interact
|
||||
directly, i.e. buttons, checkboxes, scrollbars, e.g. components
|
||||
which are not "passive" providers of UI information.
|
||||
</summary>
|
||||
<remarks>
|
||||
<para>
|
||||
The ATK interface provided by UI components which the user can
|
||||
activate/interact with, This should be implemented by
|
||||
instances of <see cref="T:Atk.Object" /> classes with which the
|
||||
user can interact directly, i.e. buttons, checkboxes,
|
||||
scrollbars, e.g. components which are not "passive" providers
|
||||
of UI information.
|
||||
</para>
|
||||
<para>
|
||||
Exceptions: when the user interaction is already covered by
|
||||
another appropriate interface such as <see
|
||||
cref="T:Atk.EditableText" /> (insert/delete test, etc.) or <see
|
||||
cref="T:Atk.Value" /> (set value) then these actions should not
|
||||
be exposed by <see cref="T:Atk.Action" /> as well.
|
||||
</para>
|
||||
<para>
|
||||
Also note that the <see cref="T:Atk.Action" /> API is limited in that
|
||||
parameters may not be passed to the object being activated;
|
||||
thus the action must be self-contained and specifiable via
|
||||
only a single "verb". Concrete examples include "press",
|
||||
"release", "click" for buttons, "drag" (meaning initiate drag)
|
||||
and "drop" for drag sources and drop targets, etc.
|
||||
</para>
|
||||
<para>
|
||||
Though most UI interactions on components should be invocable
|
||||
via keyboard as well as mouse, there will generally be a close
|
||||
mapping between "mouse actions" that are possible on a
|
||||
component and the <see cref="T:Atk.Actions" />. Where mouse and keyboard
|
||||
actions are redundant in effect, <see cref="T:Atk.Action" /> should expose
|
||||
only one action rather than exposing redundant actions if
|
||||
possible. By convention we have been using "mouse centric"
|
||||
terminology for <see cref="T:Atk.Action" /> names.
|
||||
</para>
|
||||
</remarks>
|
||||
</Docs>
|
||||
<Base />
|
||||
<Interfaces>
|
||||
@ -31,10 +71,10 @@
|
||||
<Parameter Name="i" Type="System.Int32" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="i">To be added: an object of type 'int'</param>
|
||||
<returns>To be added: an object of type 'string'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Returns a description of the specified action of the object.</summary>
|
||||
<param name="i">The action index corresponding to the action to be performed.</param>
|
||||
<returns>A description string, or 0 if action does not implement this interface.</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="SetDescription">
|
||||
@ -48,11 +88,11 @@
|
||||
<Parameter Name="desc" Type="System.String" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="i">To be added: an object of type 'int'</param>
|
||||
<param name="desc">To be added: an object of type 'string'</param>
|
||||
<returns>To be added: an object of type 'bool'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Sets a description of the specified action of the object.</summary>
|
||||
<param name="i">The action index corresponding to the action to be performed.</param>
|
||||
<param name="desc">The description to be assigned to this action.</param>
|
||||
<returns>A <see cref="T:System.Boolean"/> representing if the description was successfully set.</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="GetKeybinding">
|
||||
@ -65,10 +105,10 @@
|
||||
<Parameter Name="i" Type="System.Int32" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="i">To be added: an object of type 'int'</param>
|
||||
<returns>To be added: an object of type 'string'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Returns a keybinding associated with this action, if one exists.</summary>
|
||||
<param name="i">The action index corresponding to the action to be performed.</param>
|
||||
<returns>A string representing the keybinding, or an empty string if there is no keybinding for this action.</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="GetName">
|
||||
@ -81,10 +121,10 @@
|
||||
<Parameter Name="i" Type="System.Int32" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="i">To be added: an object of type 'int'</param>
|
||||
<returns>To be added: an object of type 'string'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Returns the name of the specified action of the object.</summary>
|
||||
<param name="i">The action index corresponding to the action to be performed.</param>
|
||||
<returns>A name string, or an empty string if action does not implement this interface.</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="DoAction">
|
||||
@ -97,10 +137,10 @@
|
||||
<Parameter Name="i" Type="System.Int32" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="i">To be added: an object of type 'int'</param>
|
||||
<returns>To be added: an object of type 'bool'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Perform the specified action on the object.</summary>
|
||||
<param name="i">The action index corresponding to the action to be performed.</param>
|
||||
<returns><see langword="true" /> if success, <see langword="false" /> otherwise.</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="NActions">
|
||||
@ -110,9 +150,13 @@
|
||||
<ReturnType>System.Int32</ReturnType>
|
||||
</ReturnValue>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<returns>To be added: an object of type 'int'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Gets the number of accessible actions available on the object.</summary>
|
||||
<returns>A the number of actions, or 0 if action does not implement this interface.</returns>
|
||||
<remarks>
|
||||
Gets the number of accessible actions available on the
|
||||
object. If there are more than one, the first one is
|
||||
considered the "default" action of the object.
|
||||
</remarks>
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="GetLocalizedName">
|
||||
@ -125,10 +169,10 @@
|
||||
<Parameter Name="i" Type="System.Int32" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="i">a <see cref="T:System.Int32" /></param>
|
||||
<returns>a <see cref="T:System.String" /></returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Returns the localized name of the specified action of the object.</summary>
|
||||
<param name="i">The action index corresponding to the action to be performed.</param>
|
||||
<returns>A name string, or an empty string if action does not implement this interface.</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
</Members>
|
||||
|
||||
@ -10,8 +10,27 @@
|
||||
</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>To be added</summary>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>The ATK interface provided by UI components which occupy a physical area on the screen.</summary>
|
||||
<remarks>
|
||||
<para>
|
||||
The ATK interface provided by UI components which occupy a
|
||||
physical area on the screen.
|
||||
</para>
|
||||
<para>
|
||||
This should be implemented by most if not all UI elements with
|
||||
an actual on-screen presence, i.e. components which can be
|
||||
said to have a screen-coordinate bounding box. Virtually all
|
||||
widgets will need to have <see cref="T:Atk.Component" /> implementations
|
||||
provided for their corresponding <see cref="T:Atk.Object" /> class. In short,
|
||||
only UI elements which are* not* GUI elements will omit this
|
||||
ATK interface.
|
||||
</para>
|
||||
<para>
|
||||
A possible exception might be textual information with a
|
||||
transparent background, in which case text glyph bounding box
|
||||
information is provided by <see cref="T:Atk.Text" />.
|
||||
</para>
|
||||
</remarks>
|
||||
</Docs>
|
||||
<Base />
|
||||
<Interfaces>
|
||||
@ -31,9 +50,12 @@
|
||||
<Parameter Name="handler_id" Type="System.UInt32" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="handler_id">To be added: an object of type 'uint'</param>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>
|
||||
Remove the handler from the list of functions to be executed
|
||||
when this object receives focus events (in or out).
|
||||
</summary>
|
||||
<param name="handler_id">The handler id of the focus handler to be removed from component.</param>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="SetPosition">
|
||||
@ -48,12 +70,15 @@
|
||||
<Parameter Name="coord_type" Type="Atk.CoordType" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="x">To be added: an object of type 'int'</param>
|
||||
<param name="y">To be added: an object of type 'int'</param>
|
||||
<param name="coord_type">To be added: an object of type 'Atk.CoordType'</param>
|
||||
<returns>To be added: an object of type 'bool'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Sets the postition of this component.</summary>
|
||||
<param name="x">X coordinate.</param>
|
||||
<param name="y">Y coordinate.</param>
|
||||
<param name="coord_type">
|
||||
Specifies whether the coordinates are relative to the screen
|
||||
or to the components top level window.
|
||||
</param>
|
||||
<returns><see langword="true" /> or <see langword="false" /> whether or not the position was set or not.</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="GrabFocus">
|
||||
@ -64,9 +89,11 @@
|
||||
</ReturnValue>
|
||||
<Parameters />
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<returns>To be added: an object of type 'bool'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Grabs focus for this component</summary>
|
||||
<returns>
|
||||
<see langword="true" /> if successful, <see langword="false"/> otherwise.
|
||||
</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="SetExtents">
|
||||
@ -83,14 +110,20 @@
|
||||
<Parameter Name="coord_type" Type="Atk.CoordType" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="x">To be added: an object of type 'int'</param>
|
||||
<param name="y">To be added: an object of type 'int'</param>
|
||||
<param name="width">To be added: an object of type 'int'</param>
|
||||
<param name="height">To be added: an object of type 'int'</param>
|
||||
<param name="coord_type">To be added: an object of type 'Atk.CoordType'</param>
|
||||
<returns>To be added: an object of type 'bool'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Sets the extents of this component.</summary>
|
||||
<param name="x">X coordinate.</param>
|
||||
<param name="y">Y coordinate.</param>
|
||||
<param name="width">Width to set for this component.</param>
|
||||
<param name="height">Height to set for this component.</param>
|
||||
<param name="coord_type">
|
||||
Specifies whether the coordinates are relative to the screen
|
||||
or to the components top level window.
|
||||
</param>
|
||||
<returns>
|
||||
<see langword="true" /> or <see langword="false" /> whether the extents were
|
||||
set or not.
|
||||
</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="SetSize">
|
||||
@ -104,11 +137,13 @@
|
||||
<Parameter Name="height" Type="System.Int32" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="width">To be added: an object of type 'int'</param>
|
||||
<param name="height">To be added: an object of type 'int'</param>
|
||||
<returns>To be added: an object of type 'bool'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Set the size of this component in terms of width and height.</summary>
|
||||
<param name="width">Width to set for this component.</param>
|
||||
<param name="height">Height to set for this component.</param>
|
||||
<returns>
|
||||
<see langword="true" /> or <see langword="false" /> whether the size was set or not.
|
||||
</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="AddFocusHandler">
|
||||
@ -121,10 +156,25 @@
|
||||
<Parameter Name="handler" Type="Atk.FocusHandler" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="handler">To be added: an object of type 'Atk.FocusHandler'</param>
|
||||
<returns>To be added: an object of type 'uint'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>
|
||||
Add the specified handler to the set of functions to be
|
||||
called when this object receives focus events (in or out).
|
||||
</summary>
|
||||
<param name="handler">The <see cref="T:Atk.FocusHandler" /> to be attached to this component.</param>
|
||||
<returns>
|
||||
A handler id which can be used in
|
||||
<see cref="M:Atk.Component.RemoveFocusHandler" /> or zero if the handler
|
||||
was already added.
|
||||
</returns>
|
||||
<remarks>
|
||||
<para>
|
||||
Add the specified handler to the set of functions to be
|
||||
called when this object receives focus events (in or out).
|
||||
</para>
|
||||
<para>
|
||||
If the handler is already added it is not added again.
|
||||
</para>
|
||||
</remarks>
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="Contains">
|
||||
@ -139,12 +189,18 @@
|
||||
<Parameter Name="coord_type" Type="Atk.CoordType" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="x">To be added: an object of type 'int'</param>
|
||||
<param name="y">To be added: an object of type 'int'</param>
|
||||
<param name="coord_type">To be added: an object of type 'Atk.CoordType'</param>
|
||||
<returns>To be added: an object of type 'bool'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Checks whether the specified point is within the extent of this component.</summary>
|
||||
<param name="x">X coordinate</param>
|
||||
<param name="y">Y coordinate</param>
|
||||
<param name="coord_type">
|
||||
Specifies whether the coordinates are relative to the screen
|
||||
or to the components top level window.
|
||||
</param>
|
||||
<returns>
|
||||
<see langword="true" /> or <see langword="false" /> indicating whether the specified point is
|
||||
within the extent of the component or not.
|
||||
</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="RefAccessibleAtPoint">
|
||||
@ -174,9 +230,9 @@
|
||||
<ReturnType>System.Int32</ReturnType>
|
||||
</ReturnValue>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<returns>To be added: an object of type 'int'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Gets the Z order of the component.</summary>
|
||||
<returns>The value G_MININT will be returned if the layer of the component is not ATK_LAYER_MDI or ATK_LAYER_WINDOW.</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="Layer">
|
||||
@ -186,9 +242,9 @@
|
||||
<ReturnType>Atk.Layer</ReturnType>
|
||||
</ReturnValue>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<returns>To be added: an object of type 'Atk.Layer'</returns>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Gets the layer of this component.</summary>
|
||||
<returns>An <see cref="T:Atk.Layer"/> which is the layer of the component.</returns>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="GetPosition">
|
||||
@ -203,11 +259,17 @@
|
||||
<Parameter Name="coord_type" Type="Atk.CoordType" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="x">a <see cref="T:System.Int32&" /></param>
|
||||
<param name="y">a <see cref="T:System.Int32&" /></param>
|
||||
<param name="coord_type">a <see cref="T:Atk.CoordType" /></param>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>
|
||||
Gets the position of component in the form of a point
|
||||
specifying this component's top-left corner.
|
||||
</summary>
|
||||
<param name="x">X coordinate position</param>
|
||||
<param name="y">Y coordinate position</param>
|
||||
<param name="coord_type">
|
||||
Specifies whether the coordinates are relative to the screen
|
||||
or to the components top level window.
|
||||
</param>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="GetExtents">
|
||||
@ -224,13 +286,16 @@
|
||||
<Parameter Name="coord_type" Type="Atk.CoordType" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="x">a <see cref="T:System.Int32&" /></param>
|
||||
<param name="y">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="coord_type">a <see cref="T:Atk.CoordType" /></param>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Gets the rectangle which gives the extent of this component.</summary>
|
||||
<param name="x">X coordinate position</param>
|
||||
<param name="y">Y coordinate position</param>
|
||||
<param name="width">Width</param>
|
||||
<param name="height">Height</param>
|
||||
<param name="coord_type">
|
||||
Specifies whether the coordinates are relative to the screen
|
||||
or to the components top level window.
|
||||
</param>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
<Member MemberName="GetSize">
|
||||
@ -244,10 +309,10 @@
|
||||
<Parameter Name="height" Type="System.Int32&" RefType="out" />
|
||||
</Parameters>
|
||||
<Docs>
|
||||
<summary>To be added</summary>
|
||||
<param name="width">a <see cref="T:System.Int32&" /></param>
|
||||
<param name="height">a <see cref="T:System.Int32&" /></param>
|
||||
<remarks>To be added</remarks>
|
||||
<summary>Gets the size of this component in terms of width and height.</summary>
|
||||
<param name="width">Width</param>
|
||||
<param name="height">Height</param>
|
||||
<remarks />
|
||||
</Docs>
|
||||
</Member>
|
||||
</Members>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user