Home  /  Autodocs

virtual.gadget

a gadget for easy creation of GUI virtuals.

FUNCTIONS

RefreshVirtualGadget RethinkVirtualSize VIRTUAL_GetClass

SUPERCLASS

gadgetclass

DESCRIPTION

virtual.gadget allows you to use groups that are much larger than the screen. The gadget acts as a window through which a rectangle area of its contents is visible.

ATTRIBUTES

VIRTUALA_Contents (Object *)
The gadget (probably a layout.gadget) to be displayed within the virtual.gadget. OM_SETing this attribute disposes the current contents of the gadget (if any).

See also VIRTUALA_NoDispose.

Applicability is (OM_NEW, OM_SET)

VIRTUALA_NoDispose (BOOL)
By setting this attribute, you inform the virtual object that this child object should not be automatically disposed when the virtual object itself is disposed. This attribute allows sharing objects between layouts.

Default is FALSE.

Applicability is (OM_NEW, OM_SET)

VIRTUALA_Scroller (BOOL)
By clearing this attribute, you inform the virtual object that you don't want the vertical and horizontal scrollbar to be displayed.

Default is TRUE.

Applicability is (OM_NEW, OM_SET)

VIRTUALA_ScrollX (WORD)
see next

VIRTUALA_ScrollY (WORD)
Scroll the contents of the gadget either horizontally or vertically by the given amount of pixels. It's not possible to scroll the contents out of the view. Setting the attribute OM_NOTIFies the VIRTUALA_TopX, VIRTUALA_TopY tags.

Applicability is (OM_NEW, OM_SET, OM_UPDATE, [OM_NOTIFY])

VIRTUALA_TotalX (UWORD)
see next

VIRTUALA_TotalY (UWORD)
The current/actual size of the object's contents.

Applicability is (OM_GET, OM_NOTIFY)

VIRTUALA_VisibleX (UWORD)
see next

VIRTUALA_VisibleY (UWORD)
Get the visible portion of the contents.

Applicability is (OM_GET, OM_NOTIFY)

VIRTUALA_TopX (UWORD)
see next

VIRTUALA_TopY (UWORD)
Set/Get the current top value of the contents.

Applicability is (OM_SET, OM_UDPATE, OM_GET, OM_NOTIFY)

VIRTUALA_ScrollerX (Object *)
see next

VIRTUALA_ScrollerY (Object *)
Instead of letting the gadget to allocate the scrollers, you can provide your own ones by using the tags above. virtual.gadget doesn't change their size and position.

Applicability is (OM_NEW)

VIRTUALA_InputScroll (BOOL)
By clearing this attribute, you inform the virtual object that you don't want the contents to be scrolled when the user moves the pointer out of the gadget while holding down the left mouse button.

Default is TRUE.

Applicability is (OM_NEW, OM_SET)

BUGS

virtual.gadget needs at least AmigaOS3.9 + BoingBag#1 (V45 classes).