ui.gadgets.tracks: refactor
							parent
							
								
									078079859c
								
							
						
					
					
						commit
						1f3f062bf6
					
				| 
						 | 
					@ -8,9 +8,7 @@ ARTICLE: "ui-track-layout" "Track layouts"
 | 
				
			||||||
"Creating empty tracks:"
 | 
					"Creating empty tracks:"
 | 
				
			||||||
{ $subsection <track> }
 | 
					{ $subsection <track> }
 | 
				
			||||||
"Adding children:"
 | 
					"Adding children:"
 | 
				
			||||||
{ $subsection track-add }
 | 
					{ $subsection track-add } ;
 | 
				
			||||||
"Creating new tracks using a combinator:"
 | 
					 | 
				
			||||||
{ $subsection track, } ;
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
HELP: track
 | 
					HELP: track
 | 
				
			||||||
{ $class-description "A track is like a " { $link pack } " except each child is resized to a fixed multiple of the track's dimension in the direction of " { $link gadget-orientation } ". Tracks are created by calling " { $link <track> } "." } ;
 | 
					{ $class-description "A track is like a " { $link pack } " except each child is resized to a fixed multiple of the track's dimension in the direction of " { $link gadget-orientation } ". Tracks are created by calling " { $link <track> } "." } ;
 | 
				
			||||||
| 
						 | 
					@ -23,8 +21,4 @@ HELP: track-add
 | 
				
			||||||
{ $values { "gadget" gadget } { "track" track } { "constraint" "a number between 0 and 1, or " { $link f } } }
 | 
					{ $values { "gadget" gadget } { "track" track } { "constraint" "a number between 0 and 1, or " { $link f } } }
 | 
				
			||||||
{ $description "Adds a new child to a track. If the constraint is " { $link f } ", the child always occupies its preferred size. Otherwise, the constrant is a fraction of the total size which is allocated for the child." } ;
 | 
					{ $description "Adds a new child to a track. If the constraint is " { $link f } ", the child always occupies its preferred size. Otherwise, the constrant is a fraction of the total size which is allocated for the child." } ;
 | 
				
			||||||
 | 
					
 | 
				
			||||||
HELP: track,
 | 
					 | 
				
			||||||
{ $values { "gadget" gadget } { "constraint" "a number between 0 and 1, or " { $link f } } }
 | 
					 | 
				
			||||||
{ $description "Adds a new child to a track. If the constraint is " { $link f } ", the child always occupies its preferred size. Otherwise, the constrant is a fraction of the total size which is allocated for the child." } ;
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
ABOUT: "ui-track-layout"
 | 
					ABOUT: "ui-track-layout"
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -53,9 +53,6 @@ M: track pref-dim*
 | 
				
			||||||
    pick sizes>> push
 | 
					    pick sizes>> push
 | 
				
			||||||
    add-gadget ;
 | 
					    add-gadget ;
 | 
				
			||||||
 | 
					
 | 
				
			||||||
: track, ( gadget constraint -- )
 | 
					 | 
				
			||||||
    gadget get swap track-add ;
 | 
					 | 
				
			||||||
 | 
					 | 
				
			||||||
: track-remove ( gadget track -- )
 | 
					: track-remove ( gadget track -- )
 | 
				
			||||||
    over [
 | 
					    over [
 | 
				
			||||||
        [ gadget-children index ] 2keep
 | 
					        [ gadget-children index ] 2keep
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -232,9 +232,6 @@ ARTICLE: "ui-layout-combinators" "Creating layouts using combinators"
 | 
				
			||||||
"The " { $link make } " combinator provides a convenient way of constructing sequences by keeping the intermediate sequence off the stack until construction is done. The " { $link , } " and " { $link % } " words operate on this implicit sequence, reducing stack noise."
 | 
					"The " { $link make } " combinator provides a convenient way of constructing sequences by keeping the intermediate sequence off the stack until construction is done. The " { $link , } " and " { $link % } " words operate on this implicit sequence, reducing stack noise."
 | 
				
			||||||
$nl
 | 
					$nl
 | 
				
			||||||
"Similar tools exist for constructing complex gadget hierarchies. Different words are used for different types of gadgets; see " { $link "ui-pack-layout" } ", " { $link "ui-track-layout" } " and " { $link "ui-frame-layout" } " for specifics. This section documents their common factors."
 | 
					"Similar tools exist for constructing complex gadget hierarchies. Different words are used for different types of gadgets; see " { $link "ui-pack-layout" } ", " { $link "ui-track-layout" } " and " { $link "ui-frame-layout" } " for specifics. This section documents their common factors."
 | 
				
			||||||
$nl
 | 
					 | 
				
			||||||
"Gadget construction combinators whose names are prefixed with " { $snippet "make-" } " construct new gadgets and push them on the stack. The primitive combinator used to define all combinators of this form:"
 | 
					 | 
				
			||||||
"Words such as " { $link track, } " access the gadget through the " { $link gadget } " variable."
 | 
					 | 
				
			||||||
;
 | 
					;
 | 
				
			||||||
 | 
					
 | 
				
			||||||
ARTICLE: "ui-null-layout" "Manual layouts"
 | 
					ARTICLE: "ui-null-layout" "Manual layouts"
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Loading…
	
		Reference in New Issue