Content      ..     48      49      50      51     ..

SINUMERIK 840D sl. Service - Configuring Commissioning. Manual (2011-2020) - page 50

Dialogs

5.1 Structure and elements of a dialog

• Graphic position

• Attributes

① Machine status display ("header")

② Dialog element

③ 8 vertical softkeys

④ 8 horizontal softkeys

⑤ Output of diagnostic messages

⑥ Graphic

⑦ Dialog

⑧ Header line of the dialog with header and long text

Figure 5-1

Structure of the dialog

Overview

The definition of a dialog (definition block) is basically structured as follows:

Definition block

Comment

Chapter reference

//M...

;Dialog start identifier

DEF Var1=...

;Variables

Variables (Page 87)

HS1=(...)

;Softkeys

Defining softkey menus (Page 68)

PRESS(HS1)

;Method start identifier

LM...

;Actions

Methods (Page 132)

END_PRESS

;Method end identifier

//END

;Dialog end identifier

SINUMERIK Integrate Run MyScreens

54

Programming Manual, 10/2020, A5E40869575B AD

Dialogs

5.1 Structure and elements of a dialog

Within the dialog definition block, various variables that appear as dialog elements in the dialog,

as well as horizontal and vertical softkeys, are defined first. Different types of actions are then

configured in methods.

Note

In operating area "Machine", for a dialog change, the following sequence should be observed:

Under the precondition that the dimensions of the following mask are smaller than the previous

mask - or the position of the following mask is different than the previous mask, dialog change

only functions if the following mask is exited before returning to the first mask, and only then is

the first mask reloaded.

5.1.2

Defining dialog properties

Description

The properties of the dialog are defined in the start identifier line of the dialog.

① Machine status display ("header")

② Graphic

③ Dialog

④ Header line of the dialog with header and long text

Figure 5-2

Dialog properties

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

55

Dialogs

5.1 Structure and elements of a dialog

Parameter:

Identifier

Name of the dialog

Header

Dialog header as text or call for text (e.g. $85011) from a language-specific

text file.

Graphic

Graphics file with path in double quotation marks.

Dimension

Position and size of the dialog in pixels (distance from left-hand side, dis-

tance from top, width, height), in relation to the upper left-hand corner of

the screen. The entries are separated by a comma.

System or user variable

System or user variable to which the current cursor position is assigned. The

NC or PLC can be provided with the cursor position via the system or user

variable. The first variable has index 1. The order corresponds to the config-

uration order of the variables.

Graphic position

Position of the graphic in pixels (distance from left-hand side, distance from

top), in relation to the upper left-hand corner of the dialog. The entries are

separated by a comma.

Attributes

The specifications of the attributes are separated by a comma.

Possible attributes are:

CM

Column mode: Column alignment

CM0

Default setting: The column distribution is carried out separately for each

line.

CM1

The column distribution of the line with the most columns applies to all lines.

CB

CHANGE block: Response when dialog is opened: cb attributes specified for

a variable in a variables definition take priority over the default setting in the

dialog definition.

See also AUTOHOTSPOT.

CB0

Default setting: All CHANGE blocks associated with the dialog are processed

when it is opened.

CB1

CHANGE blocks are then only processed if the relevant value changes.

XG

Integration of an X3D animation as help display (only in the machining step

programming).

Example:

//M(Meas/

$85605/"myx3dhelpfile.hmi,,Z_Animation,,G17"///30,10/

XG1)

XG0

Default setting = 0

XG1

The mask attribute XG must already be set to 1 in the mask definition, a

change during runtime is not possible.

Note:

The specification in the mask property HLP must also be set accordingly.

AL

The alignment of the mask header can be influenced with the mask attribute

AL.

Example:

Central setting of the "Set password" window header:

//M(MY_PWD_SET/”Set password”//"EasyPwdModalLayout"//

AL2)

AL0

Left-justified, default

AL1

Right-justified

AL2

Centered

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

57

Dialogs

5.1 Structure and elements of a dialog

KM

Freely scrolling in the mask (SlGfwScrollArea), if the virtual keyboard is to be

displayed for MultiTouch, can be influenced as follows:

• In the mask definition line with mask attribute "KM" (KeyboardMode)

Example:

//M(MyMTMask/"MultiTouch Mask"/////KM1)

• As global setting for all Run MyScreens masks in the "easyscreen.ini"

Example:

[GENERAL]

DefaultVirtualKeyboardMode=1

Note:

If, when configuring the masks, the mask attribute KM is explicitly set, then

this has a higher priority than the global setting in "easyscreen.ini".

(See also Chapter SmartOperation and MultiTouch operation (Page 51))

KM1

Free scrolling active (default)

KM0

Free scrolling inactive

PG

Alignment and appearance of the window title in conjunction with PNG

images (only effective in the editor!)

Example:

//M(MyPg1SampleMask/"My PG1 Sample Mask"/////PG1)

PG0

(Default)

PG1

Alignment and appearance of the window title in conjunction with PNG

images

Path specification (on the far left), mask name (on the right)

The display of the long text is no longer possible in this mode. Alternatively,

you can work with tooltips.

MA

Automatic adjustment of the field height for MultiTouch operation (Mutli-

Touch Adjustment)

If required, the adjusment for a MultiTouch operator panel includes the nec-

essary enlargement to the so-called minimum usable size (width, height) of

the fields (exceptions: progress bar, animated GIF, CustomWidget) and the

line spacing.

The MultiTouch adjustment can be made

• globally for all Run MyScreens mask in "easyscreen.ini", e.g.

[GENERAL]

DefaultMultiTouchAdjustmentLevel=1

• or mask-specifically in the mask definition line with the mask property

"MA" in order to overwrite the global setting in "easyscreen.ini", e.g.

//M(MyMTMask/"MultiTouch Mask"/////MA1)

If the mask attribute MA is set explicitly in the mask configuration, then this

has a higher priority than the global setting in "easyscreen.ini".

(See also Chapter SmartOperation and MultiTouch operation (Page 51))

MA0

There is no adjustment

MA1

Only those fields are adjusted for which no spacing from the top and/or field

height/width has been configured - i.e. the fields that use default positions

and therefore for which Run MyScreens calculates the spacing from the top

and/or field height/width. (Default)

SINUMERIK Integrate Run MyScreens

58

Programming Manual, 10/2020, A5E40869575B AD

Dialogs

5.1 Structure and elements of a dialog

MA2

All fields are adjusted irrespective of the configured field sizes.

PA

Optimized and pixel-precise stretching of the fields for higher resolutions

(Pixel Fine Adjustment)

Previously all field positions were calculated in relation to 640x480 and then

zoomed with the appropriate horizontal and vertical stretch factors. This

process has the disadvantage that rounding errors can occur with "unfavor-

able stretch factors". For example, the field height or line spacing can "jump"

by a pixel from line-to-line. The "Pixel Fine Adjustment" mode can be used to

prevent this as the field positions are determined directly in the current res-

olution.

//M(MyMask/"My Mask"/////PA1)

This setting can also be made globally for all Run MyScreens masks in "easy-

screen.ini", e.g.

[GENERAL]

DefaultPixelFineAdjustment=1

If the mask attribute PA is set explicitly in the mask configuration, it has a

higher priority than the global setting in "easyscreen.ini".

If a mask is displayed with Font Adjustment = FA1, then the Pixel Fine Ad-

justment mode is also automatically active for this mask.

(See also Chapter SmartOperation and MultiTouch operation (Page 51))

PA0

Stretching as previously, i.e. the positions are calculated in relation to

640x480 and then stretched.

(For compatibility reasons: Default)

PA1

Optimized and pixel-precise stretching of the fields for higher resolutions

FA

Field height and line spacing proportional to the font (Font Adjustment)

This setting can also be made globally for all Run MyScreens masks in "easy-

screen.ini", e.g.

[GENERAL]

DefaultFontAdjustment=1

If the mask attribute FA is set explicitly in the mask configuration, then this

has a higher priority than the global setting in "easyscreen.ini".

The settings for the DefaultLineHeight and DefaultLineSpacing have no sig-

nificance when Font Adjustment mode is active.

(See also Chapter SmartOperation and MultiTouch operation (Page 51))

FA0

Field height and line spacing are stretched as previously. (For compatibility

reasons: Default)

FA1

Field height and line spacing are set proportional to the font (automatically

sets mask attribute PA=1)

FA2

Same as FA1, but the X coordinate and the field width are also stretched

proportionally to the font

(Automatically sets mask attribute PA=1)

(Only possible in conjunction with attribute XG=1!)

NT

Navigation Type

NT0

NT0 = standard mode

The navigation is analogous to the masks of the operating area in which Run

MyScreens mask is integrated. This means in the cycle masks in the editor,

navigation is line-oriented (see NT2), in all other "normal" masks, it is a geo-

metrical (see NT1).

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

59

Dialogs

5.1 Structure and elements of a dialog

NT1

Geometrical navigation (top, bottom, left, right), until the borders of the

mask are reached (standard in a normal Run MyScreens environment, e.g.

area "Custom")

NT2

Line-oriented, i.e. within the line to the right until the end of the line is

reached (standard, in the cycle masks of the editor)

NR

Navigation direction when pressing the Enter key (Return Navigate Direction)

NR0

NR0 = off (default), i.e. when pressing the Enter key, navigation is realized

within the mask in a tabular sequence (standard in the normal Run

MyScreens environment)

NR1

When pressing the Enter key, navigation is the same as when pressing the up

arrow key

NR2

As for NR1, however, downward

NR3

As for NR1, however, to the left

NR4

As for NR1, however, to the right

TA

Tooltip alignment

TA0

Automatic (default)

TA1

Left

TA2

Right

TA3

Top

TA4

Bottom

TA5

Top left

TA6

Bottom left

TA7

Top right

TA8

Bottom right

MC

Mask backg34round color (mask color)

Example:

Set mask backg34round color blue (= 6)

//M(MyMask/"MyMask"//////6)

or

PRESS(HS1)

MC=6

END_PRESS

List of the mask-specific lan-

separated by a comma

guage files

Accessing the dialog properties

Read and write access to the following dialog properties is permitted within methods (e.g. PRESS

block).

• HD = Header

• HLP = Help display

• VAR = System or user variable

• MC = Mask backg34round color

• CM = Column alignment (read-only)

SINUMERIK Integrate Run MyScreens

60

Programming Manual, 10/2020, A5E40869575B AD

Dialogs

5.1 Structure and elements of a dialog

• CB = Behavior when opening (read-only)

• XG = Integration of X3d (read-only)

• AL = Mask header alignment (read-only)

Example

Figure 5-3 "Example 2: showing graphic"

//S(Start)

HS7=("Example", se1, ac7)

PRESS(HS7)

LM("Mask2")

END_PRESS

//END

//M(Mask2/"Example 2 : showing graphic"/"example.png")

HS1=("new%nHeader")

HS2=("")

HS3=("")

HS4=("")

HS5=("")

HS6=("")

HS7=("")

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

61

Dialogs

5.1 Structure and elements of a dialog

Variable properties

All variables are valid in the active dialog only. Properties are assigned to a variable when it is

defined. The values of dialog properties can be accessed within methods (e.g. a PRESS method).

① Header line of the dialog with header and long text

② Dialog element

③ Short text

④ Input/output field

⑤ Graphic text

⑥ Unit text

⑦ Main body of the dialog

Figure 5-4

Elements of a dialog

Programming - Overview

The single parameters to be separated by commas are enclosed in round brackets:

DEF [identifier] =

Identifier = Name of variable

Variable type

/[Limit values or toggle field]

/[Default]

/[Texts (Long text, Short text|Image, Graphic text, Unit text)]

/[Attributes]

/[Help display]

/[System or user variable]

/[Position of short text]

/[Position of I/O field(Left, Top, Width, Height)]

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

63

Dialogs

5.1 Structure and elements of a dialog

5.1.5

Password dialogs

Using the standard password dialogs

You can integrate the following predefined password dialogs in the screen configuration:

• Set password

Figure 5-5

Set password dialog

• Change password

Figure 5-6

Change password dialog

• Delete password

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

65

Dialogs

5.1 Structure and elements of a dialog

Figure 5-7

Delete password dialog

Note

Password functionality is provided with these dialogs. The dialogs do not correspond to the

dialogs of SINUMERIK Operate.

The dialogs can be called either via the Load softkey (LS) function or the Load mask (LM)

function:

1. Call via the Load softkey (LS) function:

LS("Passwd","slespasswd.com",1)

Extension of the vertical softkeys:

- Softkey 1: Set password

- Softkey 2: Change password

- Softkey 3: Delete password

2. Alternatively, the three masks can be directly jumped to by calling the (LM) function:

- Set password: LM("PWD_SET", "slespasswd.com",1)

- Change password: LM("PWD_CHG", "slespasswd.com",1)

- Delete password: LM("PWD_CLEAR", "slespasswd.com",1)

SINUMERIK Integrate Run MyScreens

66

Programming Manual, 10/2020, A5E40869575B AD

Dialogs

5.2 Defining softkey menus

5.2

Defining softkey menus

Definition

The term softkey menu is used to refer to all the horizontal and vertical softkeys displayed on a

mask. In addition to the existing softkey menus, it is possible to define other menus, which

partially or completely overwrite the existing menus.

The names of the softkeys are predefined. Not all softkeys need to be assigned.

HSx x 1 - 8, Horizontal softkeys 1 to 8

VSy y 1 - 8, Vertical softkeys 1 to 8

The definition of a softkey menu (softkey menu definition block) is basically structured as

follows:

Definition block

Comment

Section reference

//S...

;Start identifier of softkey menu

HSx=...

;Define softkeys

PRESS(HSx)

;Method start identifier

See Chapter Methods (Page 132)

LM...

;Actions

END_PRESS

;Method end identifier

//END

;End identifier of softkey menu

Description

Properties are assigned to softkeys during definition of the softkey menu.

Programming

Syntax:

//S(Identifier)

;Start identifier of softkey menu

//END

;End identifier of softkey menu

See also Section Extended configuration syntax (Page 49).

Description:

Defines the softkey menu

Parameters:

Identifier

Name of the softkey menu

Text or image file name

Syntax:

SK = (Text[, access level][, Status][, Alignment of the softkey image][, text align-

ment referred to the softkey image])

Description:

Define softkey

Parameters:

SK

Softkey, e.g. HS1 to HS8, VS1 to VS8

SINUMERIK Integrate Run MyScreens

68

Programming Manual, 10/2020, A5E40869575B AD

Dialogs

5.2 Defining softkey menus

Text

Enter text

Image file name

"\\my_pic.png"

or via separate text file $85199, e.g. with the following

text in the (language-specific) text file: 85100 0 0 "\

\my_pic.png".

The image size which can be displayed on a softkey de-

pends on the OP used:

OP 08:

640 x 480 mm → 25 x 25 pixels

OP 010:

640 x 480 mm → 25 x 25 pixels

OP 012:

800 x 600 mm → 30 x 30 pixels

OP 015:

1024 x 768 mm → 40 x 40 pixels

OP 019:

1280 x 1024 mm → 72 x 72 pixels

Access level

ac0 to ac7 (ac7: default)

Status

se1: visible (default)

se2: disabled (gray text)

se3: displayed (last softkey used)

Alignment of the soft-

PA (PictureAlignment)

key image

Valid values:

0: Left

1: Right

2: Centered

3: Top (default)

4: Bottom

Text alignment in re-

TP (TextAlignedToPicture)

lation to the softkey

Valid values:

image

0: Text is not aligned to the image

1: Text is aligned to the image (default)

Note

Enter %n in the softkey text to create a line break.

A maximum of 2 lines with 9 characters each are available.

Assigning access level

Operators can only access information on this access level and lower access levels (see also

AUTOHOTSPOT).

Example

//S(Menu1)

; Start identifier of softkey menu

HS1=("NEW", ac6, se2)

; Define softkey HS1, assign the label "NEW", protec-

tion level 6, and the status "disabled"

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

69

Dialogs

5.2 Defining softkey menus

Programming

Syntax:

SK.st = "Text"

;Softkey with label

SK.ac = Access level

;Softkey with protection level

SK.se = Status

; Softkey with status

SK.pa = "Alignment of the softkey image"

;Softkey with image

SK.tp = "Text alignment in relation to the soft-

;Softkey with image and label

key image"

Description:

Assign properties

Parameter:

Text

Label text in inverted commas

Access level

Range of values: 0 ... 7

Status

1:

Visible and operator-controllable

2:

Disabled (gray text)

3:

Highlighted (last softkey used)

Alignment of the

0:

Left

softkey image

1:

Right

2:

Centered

3:

Top (default)

4:

Bottom

Text alignment in

0:

Text is not aligned to the image

relation to the

1:

Text is aligned to the image (default)

softkey image

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

71

Dialogs

5.2 Defining softkey menus

Example

Figure 5-8

Example 3: Graphics and softkeys

//S(Start)

HS7=("Example", ac7, se1)

PRESS(HS7)

LM("Maske3")

END_PRESS

//END

//M(Maske3/"Example 2: showing graphic"/"example.png")

HS1=("")

HS2=("")

HS3=("")

HS4=("")

HS5=("")

HS6=("")

HS7=("")

HS8=("")

VS1=("")

VS2=("")

SINUMERIK Integrate Run MyScreens

72

Programming Manual, 10/2020, A5E40869575B AD

Dialogs

5.2 Defining softkey menus

If no language files have been defined in the mask, then a search is only made in the language

files specified in "easyscreen.ini".

Note

The English language file is used (default) if a language file is not available in the currently

selected language.

Examples:

//M(MyMask/$85597///// //"mytexts.txt, general.txt, mask.txt")

DEF ….

You can also use this procedure for the start softkeys:

//S(Start, "mytexts.txt, general.txt, mask.txt")

VS1=($85597)

PRESS(VS1)

LM("MyMask","masks.com")

END_PRESS

Format of text files

The text files must be saved in UTF-8 format.

Note

Make sure that the coding is set to UTF-8 in the editor that you are using when saving the

configuration and language files.

Format of a text entry

Syntax:

8xxxx 0 0 "Text"

Description:

Assignment between text number and text in the file

Parameters:

xxxx

85,000 to 89,999

Text identification number range reserved for

users. You must assign unique numbers.

900,000 to 999,999

"Text"

Text that appears in the dialog

%n

Control characters in the text for creating a line

break

Parameters 2 and 3 are separated by blanks and act as control characters for alarm text output.

To ensure that the text format is identical to that of the alarm texts, you must set zero.

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

75

Dialogs

5.3 Configuring the online help

5.3.2

Generating HTML files

Generating help files in the HTML format. It is possible to save all information in a single HTML

file or to distribute the information over several HTML files.

You can assign the file names yourself, however, you must observe the following:

• References within HTML files should always be specified with relative paths. Only then can it

be ensured that the references function in precisely the same way on both the development

computer as well as on the target system.

• If jumps are to be made to certain points within an HTML file per link, then so-called anchors

must be defined for this purpose.

Example of an HTML anchor:

<a name="myAnchor">This is an anchor</a>

• The contents of HTML documents must be saved with the UTF-8 coding. Only then is it

guaranteed that the HTML documents are correctly displayed in all of the country languages

supported by SINUMERIK Operate.

• The following sub-sets of the HTML functional scope are supported:

HTML tags

Tag

Description

Comment

a

Anchor or link

Supported attributes: href and name

address

Address

big

Larger font

block quote

Indented paragraph

body

Document body

Supported attributes: bgcolor (#RRGGBB)

br

Line break

center

Centered paragraph

cite

Inline citation

Same effect as tag i

code

Code

Same effect as tag tt

dd

Definition data

dfn

Definition

Same effect as tag i

div

Document division

The standard block attributes are supported

dl

Definition list

The standard block attributes are supported

dt

Definition term

The standard block attributes are supported

em

Emphasized

Same effect as tag i

font

Font size, family, color

Supported attributes: size, face, and color (#RRGGBB)

h1

Level 1 heading

The standard block attributes are supported

h2

Level 2 heading

The standard block attributes are supported

h3

Level 3 heading

The standard block attributes are supported

h4

Level 4 heading

The standard block attributes are supported

h5

Level 5 heading

The standard block attributes are supported

h6

Level 6 heading

The standard block attributes are supported

head

Document header

SINUMERIK Integrate Run MyScreens

78

Programming Manual, 10/2020, A5E40869575B AD

Dialogs

5.3 Configuring the online help

Standard attributes for lists

The following attributes are supported by tags ol and ul:

• type (1, a, A, square, disc, circle)

Standard attributes for tables

The following attributes are supported by tags td and th:

• width (absolute, relative, no-value)

• bgcolor (#RRGGBB)

• colspan

• rowspan

• align (left, right, center, justify)

• valign (top, middle, bottom)

CSS properties

The following table includes the supported CSS functional scope:

Property

Values

Description

backg34round color

<color>

Background color for elements

backg34round-image

<uri>

Background image for elements

color

<color>

Foreground color for text

text-indent

<length>px

Indent the first line of a paragraph in pixels

white-space

normal | pre | nowrap | pre-

Defines how whitespace characters are handled

wrap

in HTML documents

margin-top

<length>px

Width of the upper edge of the paragraph in pixels

margin-bottom

<length>px

Width of the lower edge of the paragraph in pixels

margin-left

<length>px

Length of the left hand edge of the paragraph in

pixels

margin-right

<length>px

Width of the right-hand edge of the paragraph in

pixels

vertical-align

baseline | sub | super | middle

Vertical alignment for text (in tables, only the val-

| top | bottom

ues middle, top and bottom are supported)

border-color

<color>

Border color for text tables

border-style

none | dotted | dashed | dot-

Border style for text tables

dash | dot-dot-dash | solid |

double | groove | ridge | inset

| outset

backg34round

[ <'backg34round-color'> ||

Short notation for backg34round property

<'backg34round-image'> ]

page-break-before

[ auto | always ]

Page break before a paragraph/table

page-break-after

[ auto | always ]

Page break after a paragraph/table

backg34round-image

<uri>

Background image for elements

SINUMERIK Integrate Run MyScreens

80

Programming Manual, 10/2020, A5E40869575B AD

Dialogs

5.3 Configuring the online help

Supported CSS selectors

All of the CSS 2.1 selector classes are supported, with the exception of so-called pseudo-selector

classes, such as :first-child, :visited and :hover.

5.3.3

Generating the help book

The help book is an XML file in which the structure of the online help is defined. In this file, you

define:

• HTML documents

• Contents and subject index

Syntax for the help book

Tag

Number

Meaning

HMI_SL_HELP

1

Root element of the XML document

I-BOOK

Identifies a help book. The name can be freely selected under the con-

I

straint that no name predefined by the system is used (such as sinu-

I

merik_alarm_plc_pmc).

I

In the example, the name of the help book is "hmi_myhelp"

I

Attributes:

I

+

I

ref

Identifies the HTML document that is displayed as the entry

I

page for the help book.

I

title

Title of the help book that is displayed in the table of con-

I

tents.

helpdir

Directory that contains the online help of the help book.

I-ENTRY

Section of the online help

II

Attributes:

II

ref

Identifies the HTML document that is displayed as entry

II

page for the section.

II

*

II

title

Title of the section that is displayed in the table of contents.

II

II

II-INDEX_ENTRY

Subject (keyword) to be displayed

II

Attributes:

II

ref

Identifies the HTML document that is jumped to for this

II

subject index entry.

II

*

II

title

Title of the subject that is displayed in the subject index.

II

II

The following applies for the "Number" column:

* means 0 or more

+ means 1 or more

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

81

Dialogs

5.3 Configuring the online help

Example for a help book

In the following example, the structure of a help book with the "My Help" name is described.

Further, it forms the basis for the table of contents and subject index.

<?xml version="1.0" encoding="utf-8"?>

<HMI_SL_HELP language="en-US">

<BOOK ref="index.html" title="My Help" helpdir="hmi_myhelp">

<ENTRY ref="section_1.html" title="Section 1">

<INDEX_ENTRY ref="section_1html#Keyword_1" title="Keyword_1"/>

<INDEX_ENTRY ref="section_1.html#Keyword_2" title="Keyword_2"/>

</ENTRY>

<ENTRY ref="section_2.html" title="Section 2">

<INDEX_ENTRY ref="section_2.html#Keyword_3" title="Keyword_3"/>

</ENTRY>

<ENTRY ref="section_3.html" title="Section 3">

<ENTRY ref="section_31.html" title="Section 31">

INDEX_ENTRY ref="section_31.html#test" title="test;section31"/>

</ENTRY>

<ENTRY ref="section_32.html" title="Section 32">

INDEX_ENTRY ref="section_32.html#test" title="test;section32"/>

</ENTRY>

</ENTRY>

</BOOK>

</HMI_SL_HELP>

The book comprises three sections, whereby the third section has two subsections. The various

subject words (keywords) are defined within the section.

SINUMERIK Integrate Run MyScreens

82

Programming Manual, 10/2020, A5E40869575B AD

Dialogs

5.3 Configuring the online help

You have the following three options to format the subject index:

1. Single entry:

<INDEX_ENTRY ...title="index"/>

2. Two two-stage entry, whereby each title has a main and a subentry. Separate the entries from

one another using a comma.

<INDEX_ENTRY ...title="mainIndex_1,subIndex_1 with mainIndex_1"/>

3. Two-stage entry, whereby the first title is the main entry and the second title is the subentry.

Separate the entries from one another using a semicolon.

<INDEX_ENTRY ...title="mainIndex_2;subIndex_2 without

mainIndex_1"/>

5.3.4

Integrating the online help in SINUMERIK Operate

If you wish to integrate the generated help book into the online help system of

SINUMERIK Operate, then you require the "slhlp.xml" file.

Format description of the "slhlp.xml"

Tag

Num-

Meaning

ber

CONFIGURATION

1

Root element of the XML document. Designates that this in-

volves a configuration file.

I-OnlineHelpFiles

1

Introduces the section about the online help books.

II-<help_book>

*

Introduces the section of a help book.

III-EntriesFile

File name of the help book with the list of contents and subject

III

(keyword) entries.

III

Attributes:

1

III

value

Name of the XML file

III

type

Data type of the value (QString)

III

III-Technology

Specifies the technology that applies to the help book.

III

"All" applies to all technologies.

III

If the help book applies to several technologies, then the tech-

III

nologies are listed separated by comma.

III

0, 1

Possible values:

III

All, Universal, Milling, Turning, Grinding, Stroking, Punching

III

III

Attributes:

III

value

Technology data

III

type

Data type of the value (QString)

IIII

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

83

Dialogs

5.3 Configuring the online help

Tag

Num-

Meaning

ber

III -DisableSearch

Disable the subject (keyword) search for the help book.

III

Attributes:

III

0, 1

value

true, false

III

III

type

type, data type of the value (bool)

III

III-DisableFullTextSearch

Disable the full text search for the help book.

III

Attributes:

III

0, 1

value

true, false

III

type

type, data type of the value (bool)

III

III-DisableIndex

Disable the subject index for the help book.

III

Attributes:

III

0, 1

value

true, false

III

III

type

type, data type of the value (bool)

III-DisableContent

Disable the table of contents for the help book.

III

Attributes:

0, 1

III

value

true, false

III

type

type, data type of the value (bool)

III

III-DefaultLanguage

Abbreviation for the language that should be displayed if the

III

actual country language is available for the help book.

III

Attributes:

0, 1

III

value

chs, deu, eng, esp, fra, ita, ...

III

type

Data type of the value (QString)

III

The following applies for the "Number" column:

* means 0 or more

Example of a file "slhlp.xml"

The help book "hmi_myhelp.xml" is made known to SINUMERIK Operate in the following

example.

The subject index has not been activated for the help book.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<!DOCTYPE CONFIGURATION>

<CONFIGURATION>

<OnlineHelpFiles>

<hmi_myHelp>

<EntriesFile value="hmi_myhelp.xml" type="QString"/>

<DisableIndex value="frue" type="bool"/>

</hmi_myHelp>

</OnlineHelpFiles>

</CONFIGURATION>

SINUMERIK Integrate Run MyScreens

84

Programming Manual, 10/2020, A5E40869575B AD

Variables

6

6.1

Defining variables

Variable value

The major property of a variable is its value.

The value of variables can be assigned by means of:

• Default settings when defining variables

• Assignment to a system or user variable

• A method

Programming

Syntax:

Identifier.val = Variable value

Identifier = Variable value

Description:

Variable value val (value)

Parameter:

Identifier:

Name of the variable

Variable value:

Value of the variable

Example:

VAR3 = VAR4 + SIN(VAR5)

VAR3.VAL = VAR4 + SIN(VAR5)

Variable status

The "Variable status" property scans a variable for valid content during runtime. This property

can be read and written with the value FALSE = 0.

Programming

Syntax:

Identifier.vld

Description:

Variable status vld (validation)

Parameter:

Identifier:

Name of the variable

The result of the scan can be:

FALSE =

invalid value

TRUE =

valid value

Example:

IF VAR1.VLD == FALSE

VAR1 = 84

ENDIF

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

87

Variables

6.2 Application examples

6.2

Application examples

Help variables

Help variables are internal arithmetic variables. Arithmetic variables are defined like other

variables, but have no other properties apart from variable value and status, i.e. help variables

are not visible in the dialog. Help variables are of the VARIANT type.

Programming

Syntax:

DEF [identifier]

Description:

Internal arithmetic variables of the VARIANT type

Parameters:

Identifier:

Name of the help variable

Example:

DEF OTTO ;Definition of a help variable

Syntax:

Identifier.val = Help variable value

Identifier = Help variable value

Description:

A value is assigned to a help variable in a method.

Parameters:

Identifier:

Name of the help variable

Help variable value:

Content of the help variables

Example:

LOAD

OTTO = "Test"

; Assign the value "Test" to the help variable Otto

END_LOAD

LOAD

OTTO = REG[9].VAL

; Assign the value of the register to the help variable

Otto

END_LOAD

Calculation with variables

Variables are calculated every time you exit an I/O field (by pressing the ENTER or toggle key). The

calculation is configured in a CHANGE method that is processed every time the value changes.

Whether a variable has a valid value can be queried via the variable status, e.g.:

IF VAR1.VLD == FALSE

VAR1 = 84

ENDIF

SINUMERIK Integrate Run MyScreens

88

Programming Manual, 10/2020, A5E40869575B AD

Variables

6.3 Example 1: Assigning the variable type, texts, help display, colors, tooltips

6.3

Example 1: Assigning the variable type, texts, help display, colors,

tooltips

Example 1a

The following example defines a variable for which the properties variable type, texts, help

display and colors are set.

DEF Var1 = (R///,"Actual value",,"mm"//"Var1.png"////8,2)

Variable type:

REAL

Texts:

Short text:

Actual value

Unit text:

mm

Help screen:

Var1.png

Colors:

Foreground color:

8 (brown)

Background color:

2 (orange)

Example 1b

The following example defines a variable for which the properties variable type, default setting,

texts, tooltip, input mode and position of short text are set.

DEF Var2 = (I//5/"","Value","",""," Tooltip text"/wr2///20,250,50)

Variable type:

INTEGER

Default setting:

5

Texts:

Short text:

Value (possible language text ID)

Tooltip:

ToolTipText

Attributes:

Input mode:

Reading and writing

Position of short text:

Distance from left:

20

Distance from top:

250

Width:

50

See also

Variable parameters (Page 98)

SINUMERIK Integrate Run MyScreens

90

Programming Manual, 10/2020, A5E40869575B AD

Variables

6.5 Example 3: Assigning the Variable Type, Default, System or User Variable, Input/Output Field Position properties

6.5

Example 3: Assigning the Variable Type, Default, System or User

Variable, Input/Output Field Position properties

Example 3

The following example defines a variable for which the properties variable type, default setting,

system or user variable and position are set.

DEF Var3 = (R//10////"$R[1]"//300,10,200//)

Variable type:

REAL

Default setting:

10

System or user variable:

$R[1] (R-Parameter 1)

Position of short text:

Default position in relation to input/output field

Position of input/output field:

Distance from left:

300

Distance from top:

10

Width:

200

See also

Variable parameters (Page 98)

SINUMERIK Integrate Run MyScreens

92

Programming Manual, 10/2020, A5E40869575B AD

Variables

6.6 Example 4: Toggle field and list field

6.6

Example 4: Toggle field and list field

Example 4a

Various entries in the toggle field:

DEF Var1 = (I/* 0,1,2,3)

;Simple toggle field to toggle numeric values

DEF Var2 = (S/* "On", "Off")

;Simple toggle field to toggle strings

DEF Var3 = (B/* 1="On", 0="Off")

;Extended toggle field to toggle numeric values whereby a

display text is assigned to each numeric value

DEF Var4 = (R/* ARR1)

;Toggle field, which obtains its values to be toggled from an

array

Example 4b

The list field corresponds to the configuration of a toggle field, but the display type for the list

field (variable attribute DT = 4) must also be set.

DEF VAR_LISTBOX_Text = (S/*$80000,$80001,$80002,$80003,$80004/$80001//DT4////200,,340,60)

Variable type:

STRING

Limits / toggle field:

*$80000,$80001,$80002,$80003,$80004

(list of the language-dependent texts to be dis-

played)

Default setting:

$80001

Attributes:

Display type:

4 (list field)

Position of input/output field:

Distance from left:

200

Width:

340

Height:

60

Colors:

Foreground color:

6 (blue)

Background color:

10 (white)

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

93

Variables

6.7 Example 5: Image display

6.7

Example 5: Image display

Example 5

Displaying an image instead of a short text: The size and position of the image is defined under

"Position of input/output field (left, top, width, height)".

DEF VAR6= (V///,"\\image1.png" ////160,40,50,50)

Variable type:

VARIANT

Texts:

Short text:

image1.png

Position of input/output field:

Distance from left:

160

Distance from the top:

40

Width:

50

Height:

50

SINUMERIK Integrate Run MyScreens

94

Programming Manual, 10/2020, A5E40869575B AD

Variables

6.8 Example 6: Progress bar

6.8

Example 6: Progress bar

The progress bar is a special display type of the input/output field and is designed for display

without input.

Basically there are two progress bar types:

1. Progress bars with up to two color changes, e.g. for temperature or utilization display (see

example 6a)

2. Progress bars to display progress (no color change) in the Operate style (see example 6b)

Example 6a

Progress bar with two color changes:

Figure 6-1

Progress bar with two color changes

DEF PROGGY0 = (R/0,150,50,100///DT1,DO0//"$R[10]"//,,150/3,4,,,,,,,9,7)

Variable type:

REAL

Limits / toggle field:

MIN:

0

MAX:

150

Signal value SVAL1:

50

Signal value SVAL2:

100

Attributes:

Display mode DT:

1 (progress bar)

Display option DO:

0 (from left to right (default))

System or user variable:

$R[10]

Position of input/output field:

Width:

150

Colors:

Foreground color:

3 (dark green)

Background color:

4 (light gray)

Signal color SC1:

9 (yellow)

Signal color SC2:

7 (red)

To use a progress bar with color change, the display mode DT (DisplayType) must be set to 1.

The orientation of the progress bar is determined via the attribute display option DO

(DisplayOption):

0: From left to right (default)

1: From right to left

2: From bottom to top

3: From top to bottom

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

95

Variables

6.8 Example 6: Progress bar

A MIN and a MAX value must be specified for the display of the progress bar (in the example MIN:

0, MAX: 150).

Depending on the current value of the variable PROGGY0, this setting already displays a progress

bar with the foreground color 3 (= dark green) and the backg34round color 4 (= light gray).

Optionally, one or two signal values SVAL1 and SVAL2 (limit parameters) can be defined (in the

example SVAL1: 50 and SVAL2: 100). With these signal values, the foreground color of the

progress bar changes. The appropriate signal colors are specified via parameters SC1 and SC2 (in

the above example SC1: 9 (= yellow) and SC2: 7 (=red)).

The following rule applies when specifying limit values for the progress display:

MIN < SVAL1 < SVAL2 < MAX.

Example 6b

Progress bar without color change:

Figure 6-2

Progress bar

DEF PROGGY0 = (R/0,150///DT2,DO0//"$R[10]"//,,150/6,10)

Variable type:

REAL

Limits / toggle field:

MIN:

0

MAX:

150

Attributes:

Display type DT:

2 (progress bar)

Display option DO:

0 (from left to right (default))

System or user variable:

$R[10]

Position of input/output field:

Width:

150

Colors:

Foreground color:

6 (blue)

Background color:

10 (white)

To use a progress bar without color change, the display mode DT (DisplayType) must be set to 2.

The orientation of the progress bar is determined via the attribute display option DO

(DisplayOption) (see description for example 6a).

A MIN and a MAX value must be specified for the display of the progress bar (in the example MIN:

0, MAX: 150).

Depending on the current value of the variable PROGGY0, this setting displays a progress bar

with the foreground color 6 (= blue) and the backg34round color 10 (= white).

SINUMERIK Integrate Run MyScreens

96

Programming Manual, 10/2020, A5E40869575B AD

Variables

6.9 Example 7: Password input mode (asterisk)

6.9

Example 7: Password input mode (asterisk)

Example 7

To implement a field with hidden input, e.g. to enter a password, then display mode DT must be

set to 5. Asterisks are then displayed instead of the entered characters.

Figure 6-3

Password input mode (asterisk)

DEF VAR_SET_PWD=(S//""//DT5)

Variable type:

STRING

Default setting:

Empty string

Attributes:

Display mode DT:

5 (password input mode)

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

97

Variables

6.10 Variable parameters

6.10

Variable parameters

Parameters - overview

The following overview provides a brief explanation of the variable parameters. Subsequent

chapters contain a more detailed description.

Parameter

Description

Variable type (Page 104)

The variable type must be specified.

R[x]:

REAL (+ digit for the decimal place)

I:

INTEGER

S[x]:

STRING (+ digit for string length)

C:

CHARACTER (individual character)

B:

BOOL

V:

VARIANT

Limits (Page 91)

Limit value MIN, limit value MAX

Default setting: Empty

The limit values are separated by a comma. Limits can be specified for types I, C and R in

decimal formats or as characters in the form "A", "F".

Optionally, two signal colors SC1 and SC2 can be configured for the display of a progress bar

with color change (variable attribute DT = 1) which are displayed as the respective fore-

ground color of the bar when the signal value SVAL1 or SVAL2 is exceeded. The signal values

are specified as integer values.

See application example for Progress bar (Page 95).

Pre-assignment (Page 109)

If no default setting has been configured and no system or user variable has been assigned

to the variable, the first element of the toggle field is assigned. If no toggle field has been

defined, there is no default setting, which means the status of the variable is "not calcula-

ted".

Default setting: No default

Toggle field (Page 107)

List with predetermined entries in the IO field: The list is initiated by a *; the entries are

separated by a comma. The entries can be assigned a value.

For the toggle field, the entry for the limit is interpreted as a list. If only one * is entered, a

variable toggle field is created.

Default setting: None

Texts (Page 90)

The sequence is specified. Instead of a short text, an image can also be displayed.

Default setting: Empty

Long text:

Text in the display line

Short text:

Name of the dialog element

Graphic text:

Text refers to the terms in the graphics

Unit text:

Unit of the dialog element

Tooltip

Serves as brief information in a screen configuration for the

display and toggle fields. The information is configured via plain

text and language text ID.

SINUMERIK Integrate Run MyScreens

98

Programming Manual, 10/2020, A5E40869575B AD

Variables

6.10 Variable parameters

Parameter

Description

Attributes (Page 91)

The attributes influence the following properties:

• Display mode

• Display option

• Update rate

• Toggle symbol

• Tooltip

• Input mode

• Access level

• Alignment of short text

• Font size

• Limits

The attributes are separated by commas and appear in any order. A definition can be made

for each component.

Display mode

dt0: Standard (input/output field or toggle field) (default)

dt1: Progress bar with color change

dt2: Progress bar without color change in the Operate style

dt4: List field

dt5: Password input mode (asterisk)

Display option

Particularly, e.g. for the display modes dt1 and dt2 (progress bars), a

display option may also have to be configured in combination.

do0: From left to right (default)

do1: From right to left

do2: From bottom to top

do3: From top to bottom

Update rate

The attribute UR (update rate) controls the update of the display and

therefore the processing of the associated, configured CHANGE block of

variables or grid columns. Depending on the configuration, the CPU

load can be drastically reduced and therefore shorter response times

achieved on the user interface.

ur0: SlCap::standardUpdateRate() (currently = 200 ms, default value)

ur1: 50 ms

ur2: 100 ms

ur3: 200 ms

ur4: 500 ms

ur5: 1000 ms

ur6: 2000 ms

ur7: 5000 ms

ur8: 10000 ms

Toggle symbol

tg0: Toggle symbol off (default)

tg1: Toggle symbol on

If the attribute TG is set to 1, the toggle symbol also appears in the

tooltip of the input field.

Example:

DEF OFFS = (R//123.456/,,,,"My ToolTip"/TG1)

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

99

Variables

6.10 Variable parameters

Parameter

Description

Tooltip

The tooltip text can also be changed during runtime via the variable

property "TT".

Example:

PRESS(VS1)

MyVar.TT = "My new ToolTip"

END_PRESS

or

DEF MyVar=(R///,,,,"My ToolTip-text")

Input mode

wr0: IO field invisible, short text visible

wr1: Read (no focus possible for input)

wr2: Read and write (line appears in white)

wr3: wr1 with focus

wr4: All variable elements invisible, no focus possible

wr5: The value entered is saved immediately on every keystroke (in

contrast to wr2, where it is only saved when the field is exited or RETURN

is pressed).

Default setting: wr2

Access level

Empty: Can always be written

ac0...ac7: Protection levels

If the access level is not adequate, then the first line is displayed in gray,

default setting: ac7

Alignment of

al0: Left-justified

short text

al1: Right-justified

al2: Centered

Default setting: al0

Font size

fs1: Default font size (8 pt.)

fs2: Double font size

Default setting: fs1

The clearances between the lines is defined. With the default font size,

16 lines will fit into the dialog. Graphics and unit text can only be con-

figured in the default font size.

Limits

Consequently, it is possible to check whether the values of the variable

are within the MIN and MAX limits specified.

Default setting: Determined by specified limits

li0: No check

li1: Check with respect to min.

li2: Check with respect to max.

li3: Check with respect to min. and max.

Behavior when

cb attributes specified for a variable in a variables definition take priority

opening

over the cb default setting in the dialog definition. Multiple attributes

are separated by commas (see also AUTOHOTSPOT).

Calling the

CB0: The CHANGE method is triggered when the screen is displayed if

CHANGE method

the variable has a valid value at this time (e.g. through default setting

or NC/PLC variable).

SINUMERIK Integrate Run MyScreens

100

Programming Manual, 10/2020, A5E40869575B AD

Variables

6.10 Variable parameters

Parameter

Description

CB1: The CHANGE method is not explicitly triggered when the screen is

displayed. If the variable has a configured NC/PLC variable, then the

CHANGE method is of course still called.

Empty Input (EI)

The variable attribute "EI" (= Empty Input) can be used to specify how

the input field is to respond if an empty string is entered.

EI0: Standard, i.e. empty inputs into the input field are accepted.

EI1: Empty inputs lead to an error status for the input field, and the

previous value is set again (Undo).

Help display (Page 90)

Help display file:

Name of the png file

Default setting: Empty

The name of the Help display file appears in double quotation marks. The display appears

automatically (instead of the previous graphic) if the cursor is positioned on this variable.

System or user variable

System or user data from the NC/PLC can be assigned to the variable. The system or user

(Page 92)

variable appears in double quotation marks.

Reference: List Manual System Variables, /PGAsl/

Position of short text (Page 110)

Position of short text (distance from left, distance from top, width)

The positions are entered in pixels and relate to the upper left-hand corner of the main body

of the dialog. The entries are separated by commas.

Position of input/output field

Position of input/output field (distance from left, distance from top, width, height)

(Page 110)

The positions are entered in pixels and relate to the upper left-hand corner of the main body

of the dialog. The entries are separated by commas. If this position changes, the positions

of the short text, graphic text and unit text also change.

Colors (Page 90)

Foreground and backg34round colors for input/output fields, short texts, graphic texts, unit

texts and signal colors for progress bars:

The colors are separated by a comma.

For specification of the color, see Chapter AUTOHOTSPOT.

Default setting for input/output field: Foreground color: Black, backg34round color: White

The default colors of the input/output field depend on the "wr" write mode:

Default setting for short text, graphic text, unit text: Foreground color: Black, backg34round

color: Transparent.

Optionally, two signal colors SC1 and SC2 can be configured for the display of a progress bar

with color change (variable attribute DT = 1) which are displayed as the respective fore-

ground color of the bar when the signal value SVAL1 or SVAL2 is exceeded.

See application example for Progress bar (Page 95).

The colors are expected in the following order in the variables definition:

1. Foreground color of the input/output field: FC

2. Background color of the input/output field: BC

3. Foreground color of the short text: FC_ST

4. Background color of the short text: BC_ST

5. Foreground color of the graphic text: FC_GT

6. Background color of the graphic text: BC_GT

7. Foreground color of the unit text: FC_UT

8. Background color of the unit text: BC_UT

9. Signal color 1

10. Signal color 2

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

101

Variables

6.10 Variable parameters

Identifier.sc = Signal color

(sc: signal color)

Identifier.st = Short text

(st: short text)

Identifier.tg = Toggle symbol

(tg: toggle)

Identifier.tt = Tooltip

(tt: tooltip

Identifier.typ = Variable type

(typ: type)

Identifier.ur = Update rate

(ur: update rate)

Identifier.ut = Unit text

(ut: unit text)

Identifier.val = Variable value

(val: value)

Identifier.var = System or user variable

(var: variable)

Identifier.vld = Variable status

(vld: validation)

Identifier.wr = Input mode

(wr: write)

See also

Extended configuration syntax (Page 49)

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

103

Variables

6.11 Details on the variable type

6.11

Details on the variable type

Variable type INTEGER

The following extensions for determining the display in the input/output field and the memory

utilization are possible for the "INTEGER" type:

2nd character in the extension data type

Representation format

B

Binary

D

Decimal signed

H

Hexadecimal

Not specified

Decimal signed

3rd and/or 4th character in the extension data type

Memory utilization

B

Byte

W

Word

D

Doubleword

BU

Byte, unsigned

WU

Word, unsigned

DU

Double word, unsigned

Sequence of characters for the INTEGER data type

1. "I" Basic INTEGER designation

2. Representation format

3. Memory utilization

4. "U" Unsigned

Valid INTEGER type specifications:

IB

Integer variable 32 bits in binary notation

IBD

Integer variable 32 bits in binary notation

IBW

Integer variable 16 bits in binary notation

IBB

Integer variable 8 bits in binary notation

I

Integer variable 32 bits in decimal notation signed

IDD

Integer variable 32 bits in decimal notation signed

IDW

Integer variable 16 bits in decimal notation signed

IDB

Integer variable 8 bits in decimal notation signed

IDDU

Integer variable 32 bits in decimal notation unsigned

IDWU

Integer variable 16 bits in decimal notation unsigned

IDBU

Integer variable 8 bits in decimal notation unsigned

SINUMERIK Integrate Run MyScreens

104

Programming Manual, 10/2020, A5E40869575B AD

Variables

6.11 Details on the variable type

Valid INTEGER type specifications:

IH

Integer variable 32 bits in hexadecimal notation

IHDU

Integer variable 32 bits in hexadecimal notation

IHWU

Integer variable 16 bits in hexadecimal notation

IHBU

Integer variable 8 bits in hexadecimal notation

Variable type VARIANT

The VARIANT variable type is determined by the data type of the last value assignment. If the

assigned or entered value starts with '-', '+', '.' or a number ('0'-'9'), then the value is interpreted

as numeric. In all other cases as a string.

It can be scanned using the ISNUM or ISSTR function. The VARIANT type is mainly suited to the

purpose of writing either variable names or numerical values to the NC code.

Programming

The data type of variables can be checked:

Syntax:

ISNUM (VAR)

Parameters:

VAR

Name of the variable whose data type is to be checked.

The result of the scan can be:

FALSE =

not a numerical variable (data type = STRING)

TRUE =

numerical variable (data type = REAL)

Syntax:

ISSTR (VAR)

Parameters:

VAR

Name of the variable whose data type is to be

checked.

The result of the scan can be:

FALSE =

numerical variable (data type = REAL)

TRUE =

not a numerical variable (data type = STRING)

Example:

IF ISNUM(VAR1) == TRUE

IF ISSTR(REG[4]+2) == TRUE

The display mode of variables can be changed:

• For INTEGER, the display type can be changed.

B

Binary

D

Decimal signed

H

Hexadecimal

unsigned

With the addition of U for Unsigned

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

105

Variables

6.13 Details on the default setting

6.13

Details on the default setting

Overview

A variable can assume various states depending on whether a default value, or a system or user

variable, or both, is assigned to the variable field (input/output field or toggle field), (not

calculated: toggling is only possible if a valid value has been assigned to the variable).

Scope of the default settings

Condition

Reaction of field type

Field type

Default setting

System or user variable

I/O field

Yes

Yes

Write default value to system or user variable

No

Yes

Use system or user variable as default value

Fault

Yes

Not calculated, system or user variable is not written/

used.

Yes

No

Default setting

No

No

Not calculated

Fault

No

Not calculated

Yes

Fault

Not calculated

No

Fault

Not calculated

Fault

Fault

Not calculated

Toggle

Yes

Yes

Write default value to system or user variable

No

Yes

Use system or user variable as default value

Fault

Yes

Not calculated,

system or user variable not written/used

Yes

No

Default setting

No

No

Default = first toggle field element

Fault

No

Not calculated

Yes

Fault

Not calculated

No

Fault

Not calculated

Fault

Fault

Not calculated

See also

Variable parameters (Page 98)

SINUMERIK Integrate Run MyScreens

Programming Manual, 10/2020, A5E40869575B AD

109

Content      ..     48      49      50      51     ..