＃ operator? operator@ operatorabs tagadd tagalign fieldand tagarray tagaudio tagbackgroundColor fieldbold fieldborder fieldborderBottom fieldborderColor fieldborderLeft fieldborderRight fieldborderStyle fieldborderTop fieldbottom fieldbox tagbutton tagcarat fieldcheckBox tagchoiceBox tagclass tagclear tagclientFrame tagcolor fieldconsole tagdialog tagdiv tagdo fieldeditable fieldellipse tagelse fieldeq tagfalse tagfocus fieldfocusOrder fieldfont fieldfor tagformat fieldge taggt tagheight fieldhotKey fieldif tagimg taginf taginline fieldinput taginvalid tagint tagitalic fieldjoin taglayer fieldle tagleft fieldlimit fieldline taglt tagmargin fieldmarginBottom fieldmarginLeft fieldmarginRight fieldmarginTop fieldmod tagmul tagne tagneg tagnot tagnull tagnum tagonClear fieldonClick fieldonContextClick fieldonExit fieldonFocus fieldonGet fieldonInput fieldonKeyDown fieldonSet fieldonKeyPress fieldonKeyUp fieldonMouseDown fieldonMouseIn fieldonMouseMove fieldonMouseOut fieldonMouseUp fieldonPull fieldonPush fieldonResize fieldonTimer fieldopenLink tagor tagpivot fieldplaying fieldput tagputError tagputLn tagrequestTransfer tagright fieldrotate fieldscalar tagscroll fieldscrollPos fieldselectable fieldsize fieldspacing fieldspacingBottom fieldspacingLeft fieldspacingRight fieldspacingTop fieldspan tagsplit tagsub tagtable tagtabRow tagthen fieldtimer tagtop fieldtransfer tagtransferAbility tagtransition fieldtrue tagunderline fieldvector tagvideo tagvisible fieldvoid tagwidth fieldwith fieldwrap fieldxor tag

height, width fields

Vector field

The height and width fields get or set the rendered on-screen dimensions of a presentation tag.

Applies to...

Sample usage

<box width=300 {...}> makes the box 300 pixels wide.
<box width=50,% {...}> makes it half the width of its container.
<box height=3,em {...}> makes it three lines of text high.
<putLn b.width> sends the actual width of b, in pixels.

Behaviour

Specifying a distance value for this field

This field takes a distance value specified with either one or two value elements.

The first element is a numerical distance value.
The second, optional element, is an inbuilt keyword constant corresponding to the units of distance to be applied.

If the units are not specified, the distance is interpreted in pixels (px) by default.

Unit specifier	Description	Example	Interpretation
None	Pixels (default units)	`5`	5 pixels
px	Pixels (explicitly stated)	`5,px`	5 pixels
%	Percentage units	`20,%`	20%
pt	Typesetting point units	`12,pt`	12pt text size
em	Multiple of current font size	`1.2,em`	1.2 × current font size

Some programming languages use % symbols as placeholders when printing output to the console. In such cases, you might need to ouput the % character in a different way. For example, in C's printf function, you would need to specify 50,% as 50,%%.

Getting a value from this field

When getting a value for this field, a single numerical value in pixels is generated.

For the height and width fields, getting the current value of the field enables you to check the actual rendered dimensions of the tag in pixels.

Note: when applied to the console tag instance, you can get the values from the height and width fields in order to check the current size of the console in pixels. Assigning to them does not resize the console.

Programs cannot resize their own consoles.