22 menusep (Menu Separator)

Menu separators are the second type of objects which can be used in a menu. They are defined with the keyword menusep.

Definition

{ export | reexport } { model } menusep { <Identifier> }
{
  <standard attributes>
  <hierarchy attributes>
  <object-specific attributes>
}

Events

extevent

Children

document

record

transformer

Parent

menubox

module

Menu

none

22.1 Attributes

Attribute

RLD

PID

Properties

Short Description

.bgc

identifier

color

S,G/D/C

background color

.class

class

class

-,G/-/-

class/id of object

.control

object

control

-,G/-/-

control currently belonging to object

.dialog

identifier

instance

-,G/-/-

dialog to which the object belongs

.document[integer]

object

document

S,G/-/-

accesses the I-th XML Document

.external

boolean

boolean

-,G/-/-

returns if the object class is an USW class

.external[integer]

class

class

-,G/-/-

returns the I-th registered USW class

.fgc

identifier

color

S,G/D/C

foreground color

.firstrecord

object

record

S,G/-/C

accesses the first record of an object

.groupbox

identifier

instance

-,G/-/-

object groupbox

.help

string

identifier

string

text

S,G/D/C

help text of object

.index

integer

index

integer

index

-,G/-/-

current index of object in the child list of its parent

.label

string

string

S,G/D/C

name/identifier of object

.lastrecord

object

record

S,G/-/C

accesses the last record of an object

.layoutbox

object

object

-,G/-/-

layoutbox of object

.mapped

boolean

boolean

S,G/D/-

defers the display of a visibly created object

.member[integer]

attribute

attribute

-,G/-,-

user-defined attribute [I] of object

.membercount

integer

integer

-,G/-,-

number of user-defined attributes

.model

identifier

instance

S,G/D/C

model belonging to object

.notepage

object

object

-,G/-/-

notepage which object currently belongs to

.order

integer

integer

S,G/D/-

defines the order relative to other menuitems in a menubox

.parent

identifier

instance

S,G/-/-

parent of object

.real_sensitive

boolean

boolean

-,G/-/-

real selectivity of object

.real_visible

boolean

boolean

-,G/-/-

real visibility of object

.record[integer]

object

record

S,G/-/C

accesses the I-th record of an object

.recordcount

integer

integer

-,G/-/-

queries the number of child records

.scope

integer
(1, 2, 3)

scope

-,G/-/-

queries the object type (Default, Model or instance)

.sensitive

boolean

boolean

S,G/D/C

selectivity of object

.statushelp

string

object

string

text

S,G/-/C

text to be displayed in statusbar

.style

integer

integer

S,G/D/-

kind of display/of behavior

.userdata

anyvalue

anyvalue

S,G/D/C

object userdata (any DM datatype)

.visible

boolean

boolean

S,G/D/C

visibility of object

.window

identifier

instance

-,G/-/-

window to which object belongs

22.2 Specific Attributes

The attribute .style defines whether a single-line or a double-line separator is to be used.

22.3 Example

In the following example, the menuitem End is visually separated from other items by a separating line.

child menubox     FileWithSeparator

{

  .title          "File";

  .sensitive      true;

  .visible        true;

 

  child menuitem  Mi_Open

  {

    .text         "Open";

    .sensitive    true;

    .visible      true;

  }

  child menuitem  Mi_Save

  {

    .text         "Save";

    .sensitive    true;

    .visible      true;

  }

  child menusep   Separator_Line

  {

  }

  child menuitem  Mi_End

  {

    .text         "End";

    .sensitive    true;

    .visible      true;

  }

}