26 notepage

{ export | reexport } { model } notepage { <Identifier> }
{
  <standard attributes>
  <hierarchy attributes>
  <layout attributes>
  <scrollbar attributes>
  <object-specific attributes>
}

Events

activate

cut

deactivate

extevent

focus

help

hscroll

key

paste

scroll

select

vscroll

Children

document

canvas

checkbox

dialog

edittext

groupbox

image

layoutbox

listbox

notebook

poptext

pushbutton

radiobutton

record

rectangle

scrollbar

spinbox

statictext

tablefield

transformer

treeview

Parent

notebook

Menu

Pop-up menu

26.1 Attributes

26.2 Specific Attributes

Standard Attributes

The attribute .accelerator can be used to activate a certain notepage, i.e. the notepage can be brought on top. To do so, a select-activate event will be triggered.

For a notepage .active is true for the page which is then on top, for all other notepages .active is false. This attribute can be true for one single notepage only.

(The notepage label is saved in the .activeobject.)

Note for the attribute .focus that only one child object can have the focus (as it is the case with the object "groupbox").

.sensitive defines the selectivity of the notepage so that the child objects are specified as insensitive, that the notepage itself, however, can still be activated.

Geometry Attributes

.menu: Whether a pop-up menu is available depends on the window system (as it is the case with "notebook"). This is why - if a pop-up menu is required - only two variants should be chosen:

1. a pop-up menu is set for each notepage, but none for the notebook.
2. a pop-up menu is set for the notebook, but none for the notepages.

With the attributes .real_height and .real_width the actual size of a notepage can be queried.

Layout Attributes

.fgc and .font, the color and the font are specified by the notebook attributes.

For the layout of notepages in Windows the following has to be considered:

• The foreground color (.fgc) of the notebook resp. notepage object will be ignored. The texts are displayed in a system color (like pushbutton object).
• The background color (.bgc) of the notepage object changes only the background color of the actual display area. The background color of the title or tab is a system color.
• The background color (.bgc) of the notebook object changes only the color outside the tabs.The background color of the tabs is a system color.
• The font (.font) of the notepage object will be ignored. The font of the notebook will be used for the labeling of the tabs.

Object-specific Attributes

.tabtype: The kind of tab for "notepage" can be described with this attribute.

The value range of some attributes depends on the window system. According to the window system either the attributes will be considered or the value which is marked as default will be chosen. This default value will also be chosen if nothing is specified.

Text Attributes

The text which is to appear in the status line has to be defined by the attribute .text (default = 0). If no text is defined, the notepage will get no status line. The position at which the status line appears depends on the window system and on the .backpage and .direction.

.title defines the labeling of tabs.(default = 0). There will only be a text, if a value <> 0 is specified here. The labeling can be either a text or a bitmap.

Note

It is allowed to create an unlimited number of notepages as long as memory is available. (Attention: There is a limit of 64kByte on MS-Windows!)

The order of notepages is defined by the order you create them in the dialog file. The principle is the same as with a normal file: the first notepage is the one on top. The order is in the opposite direction to the child objects, but it is in the "natural" order of the tabs.

26.3 Keyboard Control

Within the notebook, the keyboard control only affects the child objects of the top notepage, and not - as is usual - all child objects.

A notepage change has to be made by system-dependent keyboard methods.

Whether the notebook is in the focus order also depends on the system.

26.4 Example

dialog D

window W
{
  .active false;
  .width  359;
  .height 243;
  .title  "Beispiel";

  child notebook N
  {
    .xleft  45;
    .width  269;
    .ytop   19;
    .height 150;

    child notepage Np1
    {
      .active true;
      .title  "AAA";

      child statictext
      {
        .sensitive false;
        .xleft 18;
        .ytop  28;
        .text  "Name:";
      }

      child edittext EtName
      {
        .active  false;
        .xleft   69;
        .width   166;
        .ytop    26;
        .content "";
      }

      child statictext
      {
        .sensitive false;
        .xleft 5;
        .ytop  73;
        .text  "Vorname:";
      }

      child edittext EtVorname
      {
        .xleft 69;
        .width 165;
        .ytop  68;
      }
    }

    child notepage Np2
    {
      .title "BBB";
    }

    child notepage Np3
    {
      .title "CCC";
    }
  }
}