11.45 setvalue()

boolean setvalue
(
      object    Obj  input,
      attribute Attr input,
      anyvalue  NewVal input
  { , integer   IntIdx input | index IdxIdx input }
  { , boolean   SendEvent := true input }
)

Parameter

object Obj input

Dieser Parameter beschreibt das Objekt, dessen Attribut Sie ändern möchten.

attribute Attr input

Dieser Parameter beschreibt das Objektattribut, das Sie ändern möchten.

anyvalue NewVal input

In diesem Parameter wird der Wert übergeben, den das Attribut annehmen soll.

integer IntIdx input
index IdxIdx input

Dieser optionale Parameter kann entweder ein Integerwert oder ein Indexwert sein. Er muss gesetzt werden, wenn ein vektorielles Attribut gesetzt werden soll. Soll dabei ein eindimensionales Attribut gesetzt werden, so muss hier eine Zahl angegeben werden. Soll ein zweidimensionales Attribut gesetzt werden, so muss hier ein Index angegeben werden.

boolean SendEvent := true input

Über diesen optionalen Parameter wird gesteuert, ob der Dialog Manager durch das erfolgreiche Setzen des Attributes die Regelbearbeitung auslösen soll oder nicht. Der Parameter muss mit false belegt sein, wenn keine Events verschickt werden sollen. Sollen Events verschickt werden, muss dieser Parameter mit true belegt oder weggelassen sein.

Rückgabewert

true

Das Setzen des Attributes wurde erfolgreich ausgeführt.

false

Das Attribut konnte nicht gesetzt werden.

Beispiele

• Setzen der Zelle 1,1 in einem Tablefield

  setvalue(Tablefield, .content, true, [1,1]);

• Mit Hilfe dieser Funktion können auch Attribute über Variablen geändert werden, z.B.

  rule void Set(attribute A)
  {
    setvalue(Win1, A, true);
    Pb1.sensitive := getvalue(Win2, A);
  }

Siehe auch

Methode :set()

C-Funktion DM_SetValue im Handbuch „C-Schnittstelle - Funktionen“