45 lines
2.6 KiB
Plaintext
45 lines
2.6 KiB
Plaintext
IN: gadgets-scrolling
|
|
USING: help gadgets gadgets-viewports gadgets-sliders ;
|
|
|
|
HELP: scroller
|
|
{ $class-description "A scroller consists of a " { $link viewport } " containing a child, together with horizontal and vertical " { $link slider } " gadgets which scroll the viewport's child. Scroller gadgets also support using a mouse scroll wheel."
|
|
$terpri
|
|
"Scroller gadgets are created by calling " { $link <scroller> } "." } ;
|
|
|
|
HELP: find-scroller
|
|
{ $values { "gadget" gadget } { "scroller/f" "a " { $link scroller } " or " { $link f } } }
|
|
{ $description "Finds the first parent of " { $snippet "gadget" } " which is a " { $link scroller } ". Outputs " { $link f } " if the gadget is not contained in a " { $link scroller } "." } ;
|
|
|
|
HELP: scroller-value
|
|
{ $values { "scroller" scroller } { "loc" "a pair of integers" } }
|
|
{ $description "Outputs the offset of the top-left corner of the scroller's " { $link viewport } "'s child." }
|
|
{ $see-also scroll } ;
|
|
|
|
HELP: <scroller>
|
|
{ $values { "gadget" gadget } { "scroller" "a new " { $link scroller } } }
|
|
{ $description "Creates a new " { $link scroller } " for scrolling around " { $snippet "gadget" } "." } ;
|
|
|
|
HELP: scroll
|
|
{ $values { "scroller" scroller } { "value" "a pair of integers" } }
|
|
{ $description "Sets the offset of the top-left corner of the scroller's " { $link viewport } "'s child." }
|
|
{ $see-also scroller-value } ;
|
|
|
|
HELP: relative-scroll-rect
|
|
{ $values { "rect" rect } { "gadget" gadget } { "scroller" scroller } { "newrect" "a new " { $link rect } } }
|
|
{ $description "Adjusts " { $snippet "rect" } " for the case where the gadget is not the immediate child of the scroller's viewport." } ;
|
|
|
|
HELP: scroll>rect
|
|
{ $values { "rect" rect } { "gadget" gadget } }
|
|
{ $description "Ensures that a rectangular region relative to the top-left corner of " { $snippet "gadget" } " becomes visible in a " { $link scroller } " containing " { $snippet "gadget" } ". Does nothing if no parent of " { $snippet "gadget" } " is a " { $link scroller } "." }
|
|
{ $see-also scroll>bottom scroll>top } ;
|
|
|
|
HELP: scroll>bottom
|
|
{ $values { "gadget" gadget } }
|
|
{ $description "Ensures that any " { $link scroller } " containing " { $snippet "gadget" } " is scrolled all the way down. Does nothing if no parent of " { $snippet "gadget" } " is a " { $link scroller } "." }
|
|
{ $see-also scroll>rect scroll>top } ;
|
|
|
|
HELP: scroll>top
|
|
{ $values { "gadget" gadget } }
|
|
{ $description "Ensures that any scroller containing " { $snippet "gadget" } " is scrolled all the way up. If no parent of " { $snippet "scroller" } " is a gadget, does nothing." }
|
|
{ $see-also scroll>rect scroll>bottom } ;
|