GtkSharp/doc/en/Gtk/ScrolledWindow.xml

363 lines
17 KiB
XML
Raw Normal View History

<Type Name="ScrolledWindow" FullName="Gtk.ScrolledWindow">
<TypeSignature Language="C#" Value="public class ScrolledWindow : Gtk.Bin, Implementor, IWrapper, IWrapper, IDisposable" Maintainer="Duncan Mak" />
<AssemblyInfo>
<AssemblyName>gtk-sharp</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>0.0.0.0</AssemblyVersion>
<AssemblyCulture>neutral</AssemblyCulture>
<Attributes />
</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>Adds scrollbars to its child widget.</summary>
<remarks>
<para>
GtkScrolledWindow is a <see cref="T:Gtk.Bin" /> subclass: it's a container the accepts a single child widget. GtkScrolledWindow adds scrollbars to the child widget and optionally draws a beveled frame around the child widget.
</para>
<para>
The scrolled window can work in two ways. Some widgets have native scrolling support; these widgets have "slots" for <see cref="T:Gtk.Adjustment" /> objects. Widgets with native scroll support include <see cref="T:Gtk.TreeView" />, <see cref="T:Gtk.TextView" />, and <see cref="T:Gtk.Layout" />.
</para>
<para>
The position of the scrollbars is controlled by the scroll adjustments. See <see cref="T:Gtk.Adjustment" /> for the properties in an adjustment - for <see cref="T:Gtk.Scrollbar" />, used by <see cref="T:Gtk.ScrolledWindow" />, the <see cref="P:Gtk.Adjustment.Value" /> property represents the position of the scrollbar, which must be between the <see cref="P:Gtk.Adjustment.Lower" /> and <see cref="P:Gtk.Adjustment.Upper" /> - <see cref="P:Gtk.Adjustment.PageSize" />. The <see cref="P:Gtk.Adjustment.PageSize" /> property represents the size of the visible scrollable area. The <see cref="P:Gtk.Adjustment.StepIncrement" /> and <see cref="P:Gtk.Adjustment.PageIncrement" /> properties are used when the user asks to step down (using the small stepper arrows) or page down (using for example the PageDown key).
</para>
</remarks>
</Docs>
<Base>
<BaseTypeName>Gtk.Bin</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>Atk.Implementor</InterfaceName>
</Interface>
<Interface>
<InterfaceName>GLib.IWrapper</InterfaceName>
</Interface>
<Interface>
<InterfaceName>GLib.IWrapper</InterfaceName>
</Interface>
<Interface>
<InterfaceName>System.IDisposable</InterfaceName>
</Interface>
</Interfaces>
<Attributes />
<Members>
<Member MemberName="AddWithViewport">
<MemberSignature Language="C#" Value="public void AddWithViewport (Gtk.Widget child);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="child" Type="Gtk.Widget" />
</Parameters>
<Docs>
<summary>Used to add children without native scrolling capabilities.</summary>
<param name="child">A <see cref="T:Gtk.Widget"/></param>
<remarks>
<para>
Used to add children without native scrolling capabilities. This is simply a convenience function; it is equivalent to adding the unscrollable child to a viewport, then adding the viewport to the scrolled window. If a child has native scrolling, use <see cref="M:Gtk.Container.Add" /> instead of this function.
</para>
<para>
The viewport scrolls the child by moving its <see cref="T:Gdk.Window" />, and takes the size of the child to be the size of its toplevel <see cref="T:Gdk.Window" />. This will be very wrong for most widgets that support native scrolling; for example, if you add a widget such as <see cref="T:Gtk.TreeView" /> with a viewport, the whole widget will scroll, including the column headings. Thus, widgets with native scrolling support should not be used with the <see cref="T:Gtk.Viewport" /> proxy.
</para>
<para>
A widget supports scrolling natively if the set_scroll_adjustments_signal field in GtkWidgetClass is non-zero, i.e. has been filled in with a valid signal identifier.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="SetPolicy">
<MemberSignature Language="C#" Value="public void SetPolicy (Gtk.PolicyType hscrollbar_policy, Gtk.PolicyType vscrollbar_policy);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="hscrollbar_policy" Type="Gtk.PolicyType" />
<Parameter Name="vscrollbar_policy" Type="Gtk.PolicyType" />
</Parameters>
<Docs>
<summary>Sets the scrollbar policy for the horizontal and vertical scrollbars.</summary>
<param name="hscrollbar_policy">Policy for horizontal bar.</param>
<param name="vscrollbar_policy">Policy for vertical bar.</param>
<remarks>
<para>
Sets the scrollbar policy for the horizontal and vertical scrollbars. The policy determines when the scrollbar should appear; it is a value from the <see cref="T:Gtk.PolicyType" /> enumeration. If <see cref="T:Gtk.PolicyType.Always" />, the scrollbar is always present; if <see cref="T:Gtk.PolicyType.Never" />, the scrollbar is never present; if <see cref="T:Gtk.PolicyType.Automatic" />, the scrollbar is present only if needed (that is, if the slider part of the bar would be smaller than the trough - the display is larger than the page size).
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="GetPolicy">
<MemberSignature Language="C#" Value="public void GetPolicy (out Gtk.PolicyType hscrollbar_policy, out Gtk.PolicyType vscrollbar_policy);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="hscrollbar_policy" Type="Gtk.PolicyType&amp;" RefType="out" />
<Parameter Name="vscrollbar_policy" Type="Gtk.PolicyType&amp;" RefType="out" />
</Parameters>
<Docs>
<summary>Retrieves the current policy values for the horizontal and vertical scrollbars.</summary>
<param name="hscrollbar_policy">Location to store the policy for the horizontal scrollbar.</param>
<param name="vscrollbar_policy">Location to store the policy for the horizontal scrollbar.</param>
<remarks>
<para>
Retrieves the current policy values for the horizontal and vertical scrollbars.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="Finalize">
<MemberSignature Language="C#" Value="protected override void Finalize ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Disposes the resources associated with the object.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ScrolledWindow (IntPtr raw);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="raw" Type="System.IntPtr" />
</Parameters>
<Docs>
<summary>Internal constructor</summary>
<param name="raw">Pointer to the C object.</param>
<returns>An instance of ScrolledWindow, wrapping the C object.</returns>
<remarks>
<para>This is an internal constructor, and should not be used by user code.</para>
</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ScrolledWindow (Gtk.Adjustment hadjustment, Gtk.Adjustment vadjustment);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="hadjustment" Type="Gtk.Adjustment" />
<Parameter Name="vadjustment" Type="Gtk.Adjustment" />
</Parameters>
<Docs>
<summary>Creates a new scrolled window.</summary>
<param name="hadjustment">Horizontal adjustment.</param>
<param name="vadjustment">Vertical adjustment.</param>
<returns>A <see cref="T:Gtk.ScrolledWindow"/></returns>
<remarks>
<para>
Creates a new scrolled window. The two arguments are the scrolled window's adjustments; these will be shared with the scrollbars and the child widget to keep the bars in sync with the child. Usually you want to pass <see langword="null" /> for the adjustments, which will cause the scrolled window to create them for you.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ScrolledWindow ();" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters />
<Docs>
<summary>Basic constructor.</summary>
<returns>A <see cref="T:Gtk.ScrolledWindow"/></returns>
<remarks/>
</Docs>
</Member>
<Member MemberName="Placement">
<MemberSignature Language="C#" Value="public Gtk.CornerType Placement { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.CornerType</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Determines the location of the child widget with respect to the scrollbars.</summary>
<param name="value">Position of the child window.</param>
<returns />
<remarks>
<para>
Determines the location of the child widget with respect to the scrollbars. The default is <see cref="T:Gtk.CornerType.TopLeft" />, meaning the child is in the top left, with the scrollbars underneath and to the right. Other values in <see cref="T:Gtk.CornerType" /> are <see cref="T:Gtk.CornerType.TopRight" />, <see cref="T:Gtk.CornerType.BottomLeft" />, and <see cref="T:Gtk.CornerType.BottomRight" />.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="HscrollbarPolicy">
<MemberSignature Language="C#" Value="public Gtk.PolicyType HscrollbarPolicy { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.PolicyType</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>When the horizontal scrollbar is displayed.</summary>
<param name="value">A <see cref="T:Gtk.PolicyType"/></param>
<returns>A <see cref="T:Gtk.PolicyType"/></returns>
<remarks/>
</Docs>
</Member>
<Member MemberName="Hadjustment">
<MemberSignature Language="C#" Value="public Gtk.Adjustment Hadjustment { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.Adjustment</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Sets the <see cref="T:Gtk.Adjustment" /> for the horizontal scrollbar.</summary>
<param name="value">Horizontal scroll adjustment.</param>
<returns>The horizontal GtkAdjustment.</returns>
<remarks/>
</Docs>
</Member>
<Member MemberName="VscrollbarPolicy">
<MemberSignature Language="C#" Value="public Gtk.PolicyType VscrollbarPolicy { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.PolicyType</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>When the vertical scrollbar is displayed.</summary>
<param name="value">A <see cref="T:Gtk.PolicyType"/></param>
<returns>A <see cref="T:Gtk.PolicyType"/></returns>
<remarks/>
</Docs>
</Member>
<Member MemberName="Vadjustment">
<MemberSignature Language="C#" Value="public Gtk.Adjustment Vadjustment { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.Adjustment</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Sets or Gets the <see cref="T:Gtk.Adjustment" /> for the vertical scrollbar.</summary>
<param name="value">Vertical scroll adjustment.</param>
<returns>The vertical GtkAdjustment.</returns>
<remarks/>
</Docs>
</Member>
<Member MemberName="ShadowType">
<MemberSignature Language="C#" Value="public Gtk.ShadowType ShadowType { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.ShadowType</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Gets the shadow type of the scrolled window.</summary>
<param name="value">A <see cref="T:Gtk.ShadowType"/>, the kind of shadow to draw around scrolled window contents.</param>
<returns>The current shadow type.</returns>
<remarks/>
</Docs>
</Member>
<Member MemberName="WindowPlacement">
<MemberSignature Language="C#" Value="public Gtk.CornerType WindowPlacement { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>Gtk.CornerType</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Where the contents are located with respect to the scrollbars.</summary>
<param name="value">A <see cref="T:Gtk.CornerType"/></param>
<returns>A <see cref="T:Gtk.CornerType"/></returns>
<remarks/>
</Docs>
</Member>
<Member MemberName="ScrollChild">
<MemberSignature Language="C#" Value="public event Gtk.ScrollChildHandler ScrollChild;" />
<MemberType>Event</MemberType>
<ReturnValue />
<Parameters />
<Docs>
<summary>Fired when the child widget is scrolled.</summary>
<remarks/>
</Docs>
</Member>
<Member MemberName="MoveFocusOut">
<MemberSignature Language="C#" Value="public event Gtk.MoveFocusOutHandler MoveFocusOut;" />
<MemberType>Event</MemberType>
<ReturnValue>
<ReturnType>Gtk.MoveFocusOutHandler</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Fired when the focus moves out of the scrolled window.</summary>
<remarks/>
</Docs>
</Member>
<Member MemberName="GType">
<MemberSignature Language="C#" Value="public static GLib.GType GType { get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>GLib.GType</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>GType Property.</summary>
<returns>a <see cref="T:GLib.GType" /></returns>
<remarks>Returns the native <see cref="T:GLib.GType" /> value for <see cref="T:Gtk.ScrolledWindow" />.</remarks>
</Docs>
</Member>
<Member MemberName="OnMoveFocusOut">
<MemberSignature Language="C#" Value="protected virtual void OnMoveFocusOut (Gtk.DirectionType direction);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="direction" Type="Gtk.DirectionType" />
</Parameters>
<Docs>
<summary>Default handler for the <see cref="M:Gtk.ScrolledWindow.MoveFocusOut" /> event.</summary>
<param name="direction">a <see cref="T:Gtk.DirectionType" /></param>
<remarks>Override this method in a subclass to provide a default handler for the <see cref="M:Gtk.ScrolledWindow.MoveFocusOut" /> event.</remarks>
</Docs>
</Member>
<Member MemberName="OnScrollChild">
<MemberSignature Language="C#" Value="protected virtual void OnScrollChild (Gtk.ScrollType scroll, bool horizontal);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="scroll" Type="Gtk.ScrollType" />
<Parameter Name="horizontal" Type="System.Boolean" />
</Parameters>
<Docs>
<summary>Default handler for the <see cref="M:Gtk.ScrolledWindow.ScrollChild" /> event.</summary>
<param name="scroll">a <see cref="T:Gtk.ScrollType" /></param>
<param name="horizontal">a <see cref="T:System.Boolean" /></param>
<remarks>Override this method in a subclass to provide a default handler for the <see cref="M:Gtk.ScrolledWindow.ScrollChild" /> event.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="protected ScrolledWindow (GLib.GType gtype);" />
<MemberType>Constructor</MemberType>
<ReturnValue />
<Parameters>
<Parameter Name="gtype" Type="GLib.GType" />
</Parameters>
<Docs>
<summary>Protected Constructor.</summary>
<param name="gtype">a <see cref="T:GLib.GType" /></param>
<returns>a <see cref="T:Gtk.ScrolledWindow" /></returns>
<remarks>Chain to this constructor if you have manually registered a native <see cref="T:GLib.GType" /> value for your subclass.</remarks>
</Docs>
</Member>
</Members>
</Type>