.-
help for ^winset^                                 (STB-46: dm63)
.-

WinShow settings (Windows and Macintosh only)
---------------------------------------------

    ^winset^ [varlist] [, ^li^st]


Description
-----------

^winset^ provides an easy way to display or set characteristics of the current
dataset which are used by @winshow@.

Without options ^winset^ presents a dialog box from which the user can choose
one variable from the current dataset. The characteristics of this variable
are then displayed in another window where they can be viewed or edited.

The ^list^ option displays the current ^winshow^ settings for varlist in the
main results window.


Fields in dialog box
--------------------

^Length of edit box^ allows the user to over-ride the default length, in
    characters, ^winshow^ allocates to the edit region of the variable. The 
    default length is either the length of the maximum value of the variable 
    (for numeric) or the space allocated to a string variable (e.g. 12 
    for str12). This length is stored in the [len] characteristic of the 
    variable.

^Cannot be edited?^ determines whether the user can edit the variable.
    The [noedit] characteristic is set to 1 if editing is prohibited.

^Must enter?^, if checked, does not allow the variable to be left blank
    (although missing is allowed). The [req] characteristic is 1 for must
    enter variables.

^Valid range^ allows for range checking of numeric variables. Values outside
    this range prompt a warning. If a range exists it is stored in the
    [range] characteristic as "lo_value hi_value [strict]". The strict option
    corresponds to the ^Never accept values outside this range?^ checkbox.

^Default^ specifies the default value the variable is to take when a new
    observation is created. The [default] characteristic is set to the default
    value.

The ^Save settings^ button makes the changes to the characteristics for the
selected variable. These characteristics can be made permanent by saving the
dataset.


Author
------

         Tony Brady
         Imperial College School of Medicine, U.K.
         tbrady@@rpms.ac.uk


Also see
--------

    STB: dm63 (STB-46)
On-line: help for @char@, @window@, @winshow@