3.59 DM_ResetValueIndex

Mit Hilfe dieser Funktion werden Sie in die Lage versetzt, Attribute mit zwei Indices auf den Wert des zugehörigen Defaultattributs (mit Index 0) zurückzusetzen.

Die dabei zulässigen Attribute für den jeweiligen Objekttyp entnehmen Sie bitte der „Objektreferenz“.

DM_Boolean DML_default DM_EXPORT DM_ResetValueIndex
(
  DM_ID objectID,
  DM_Attribute attr,
  DM_Value *index,
  DM_Options options
)

Parameter

-> DM_ID objectID

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

-> DM_Attribute attr

Dieser Parameter beschreibt das Objektattribut, das Sie ändern möchten. Alle zugelassenen Attribute sind in der Datei IDMuser.h definiert.

-> DM_Value *index

Hier kann der Datentyp des Index (enum, index) und dessen Wert angegeben werden.

-> DM_Options options

Über diesen Parameter wird gesteuert, ob der Dialog Manager durch das erfolgreiche Zurücksetzen des Attributes die Regelbearbeitung auslösen soll oder nicht.

Option

Bedeutung

DMF_Inhibit

Diese Option bedeutet, dass der Funktionsaufruf keine internen Ereignisse auslösen soll. Wenn dieses Flag gesetzt ist, kann vor allem bei vielen Attribut-Änderungen durch die Anwendung viel Performance gewonnen werden.

DMF_ShipEvent

Diese Option bedeutet, dass der Funktionsaufruf die internen Ereignisse auslösen soll. Dadurch werden Regeln ausgelöst, die für dieses Objekt definiert sind und auf das Ändern des angegebenen Attributes reagieren.

Rückgabewert

TRUE

Das Attribut konnte erfolgreich zurückgesetzt werden.

FALSE

Das Attribut konnte nicht zurückgesetzt werden.