Topic: APLX Help : System Classes : Properties : border
[ Previous | Next | Contents | Index | APL Home ]

www.microapl.co.uk

The 'border' property


An integer scalar
Valid for: Chart, Grid, List, Edit, RichEdit, OLEContainer, Picture, Tree, Form, Window, Document, Dialog

For a Chart, List, Edit, RichEdit, OLEContainer, Picture, or Tree, the border property is either 0 or 1. If it is 1, a frame is drawn around the object in the object's foreground color. The default is 0 for a Chart, Picture, Icon, OLEContainer, and 1 for a Grid, List, Edit, RichEdit or Tree.

For a top-level object, the border property may be set only at creation time (as part of the New or Create method). The value is made up of a basic border style, plus optional flags. The basic border styles are:

        0         No border
        1         Standard document window, window not resizable
        2         Resizable document window
        3         Modal-dialog style window
        4         Movable modal-dialog style window
        5         Thin title-bar, non-resizable window
        6         Thin title-bar, resizable window

The optional flags which you can add to these basic values are:

        16        Window includes a Close box
        64        Window includes a Zoom box (under MacOS) 
                  or Minimize/Maximize controls (under Windows and Linux)

You cannot include a Close box if the basic border type is 0, and you cannot include a Zoom box if it is 0, 5 or 6.

The default values are 20 for a Dialog object, and 2+16+64 = 82 for a Document or Window object.

Note that the setting of this property does not determine whether a given window operates in a modal way, but merely sets the appearance and sizing controls.

Under Linux, the request which you make for a particular style of border is passed to the Window Manager, which may choose not to honor it.


Topic: APLX Help : System Classes : Properties : border
[ Previous | Next | Contents | Index | APL Home ]