3.58 DM_ResetValue

Mit Hilfe dieser Funktion werden Sie in die Lage versetzt, Attribute von DM-Objekten auf den Wert des zugehörigen Modells oder Defaults zurückzusetzen.

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

DM_Boolean DML_default DM_EXPORT DM_ResetValue
(
  DM_ID objectID;
  DM_Attribute attr;
  DM_UInt index;
  DM_Options options
)

Parameter

-> DM_ID objectID

Dieser Parameter beschreibt das Objekt, dessen Attribut Sie zurücksetzen möchten.

-> DM_Attribute attr

Dieser Parameter beschreibt das Attribut, das Sie von dem Objekt zurücksetzen möchten. Alle zugelassenen Attribute sind in der Datei IDMuser.h definiert.

-> DM_UInt index

Dieser Parameter wird nur bei Vektorattributen von Objekten ausgewertet und beschreibt den Index des gesuchten Unterobjekts (z.B. Text in Listbox).

-> DM_Options options

Über diesen Parameter wird gesteuert, ob der Dialog Manager durch das erfolgreiche Setzen des Attributes die Regelbearbeitung auslösen soll.

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.