WINTYPE Property

PLBCMP GUI Only

 

The WINTYPE property specifies the WINDOW type. The property uses the following format:

WINTYPE={value}

Note the following:

  1. WINTYPE may be used in CREATE or GETPROP statements of a WINDOW object.

  2. If the WINTYPE is set to $OBJSONLY, this is the same as a PRIMARY window that is sizable.

  3. {value} is a decimal number, a Numeric Variable, an Expression, or a keyword as defined in PLBEQU.INC. The supported values and keywords are:

    4.  

    Value

    Keyword

    The window ...

    0

    $NONE

    (same as default)

    1

    $MODAL

    is modal. When a modal window is activated, the program execution remains at the ACTIVATE statement until the window is destroyed or deactivated. While a modal window is active, no events other than events for the window are processed.

    2

    $MODELESS

    is modeless. A modeless window is a popup window that always remains on top of any primary window. Another feature is that this window acts as a child window to a primary window. If the primary window becomes minimized, the modeless window is also minimized. However, the modeless window does not effect the minimized task bar selections. The modeless window may not be minimized and events for other windows are not locked out while the modeless window is active.

    3

    $OBJONLY

    is an object only. The objects only window type is reserved for use by the PLB designer. If this type is used in a program, it is implemented as a $PRIMARYSIZE window type. Any window events specified in an objects-only PLF form are registered for the target panel or window object of the FORMLOAD.

    4

    $PRIMARYFIXED

    is fixed in size. This type creates primary window that may not be resized. The window may be minimized or maximized and is always displayed beneath a modal or modeless window. If a primary window is active when a modeless window is created, the primary window acts as the parent window for the modeless window. The value is for backward compatibility only and has been replaced by the WINBORDER property.

    5

    $PRIMARYSIZE

    is resizable. This type creates a window that may be sized at runtime. This is the default property value. All other features are the same as $PRIMARYFIXED.

    6

    $MDICLIENT

    contains a MDI client window to support MDICHILD type windows. The properties MDIBORDER, MDISCROLL, MDITOP, MDILEFT, MDIHEIGHT, and MDIWIDTH manipulates the MDI client window. The MDILayout and MDIShow methods also affect the MDI client window. This value is not supported by the PL/B Web Server and will result in a default window type being used.

    7

    $MDICHILD

    is a MDI child window for use with a host MDICLIENT style window. This value is not supported by the PL/B Web Server and will result in a default window type being used.

    8

    $CEMODALNOMENU

    Same as $MODAL with no CE MENU support.

    9

    $CEMODELESSNOMENU

    Same as $MODELESS with no CE MENU support.

    10

    $CEFIXEDNOMENU

    Same as $PRIMARYFIXED with no CE MENU support.

    11

    $CESIZEABLENOMENU

    Same as $PRIMARYSIZE with no CE MENU support.

    12

    $MPICLIENT

    contains a MPI client window to support MPI child type windows. The properties MPIBORDER, MPISCROLL, MPITOP, MPILEFT, MPIHEIGHT, and MPIWIDTH manipulates the MPI client window. The MPILayout and MPIShow methods also affect the MPI client window. This window type is only available when using Plbwebsrv or Plbwin (WebView) runtimes. (10.7)

    13

    $MPICHILD

    a MPI child window for use with a host MPI client type window. This window type is only available when using Plbwebsrv or Plbwin (WebView) runtimes. (10.7)

  4. The $CEMODALNOMENU, $CEMODELESSNOMENU, $CEFIXEDNOMENU, and $CESIZEABLENOMENU types only apply to the CE Pocket PC runtime versions. If these values are executed for any other CE versions, they automatically default to to a $PRIMARYSIZE window type being used.

  5. The $MDICLIENT and $MDICHILD types only apply to the PLBWIN runtime versions. These values are not supported by the PL/B Web Server and will result in a default window type.

  6. If a CE window type is used while executing under PLBWIN, it executes as the normal Windows window type. Since the CE MENU support does not apply for the normal Window OS environment, it is ignored for PLBWIN.

  7. Any window events specified in an objects-only PLF form are registered for the target panel or window object of the FORMLOAD.

  8. When CE window types are being used under the PL/B Web Server runtime, one of the CSS classes named 'ce8', 'ce9', 'ce10', or 'ce11' is applied to the PWS WINDOW. These classes are declared in the 'plbwebbasic.css'. These classes invoke specialized Windows CE behaviors which are applied to the PWS WINDOW object as follows:

    9.  

    Class

    Behavior

    ce8

    Reserved for future use when WINTYPE=$CEMODALNOMENU.

    ce9

    Reserved for future use when WINTYPE=$CEMODELESSNOMENU.

    ce10

    CSS styles used when WINTYPE=$CEFIXEDNOMENU. This class causes the WINDOW object to be positioned to the top/left position of 0/0.

    ce11

    CSS styles used when WINTYPE=$CESIZEABLENOMENU. This class causes the WINDOW object to be positioned to the top/left position of 0/0.

 

 

See Also: Object Properties, Object IO Instructions, Object Definitions

 


PL/B Language Reference WINPOS Property WINWIDTH Property