4 Options for the Interface Functions

In the following table, you will find all options which can be specified in the parameter options of the DM interface functions. Usually, these options can be connected by a logical or, so that a function including more than one valid option can be called.

Option	Function	Meaning
DMF_AcceptChild	DM_GetValue DM_SetValue	Is valid for the attribute AT_options of the canvas on Motif. This option denotes a canvas which can have child objects.
DMF_AppendValue	DM_StringChange DM_ValueChange	Append a data value to a collection (if index == NULL) or string.
DMF_CheckFuncarg	DM_InputHandler	All function arguments are taken to search for the function to be uninstalled.
DMF_CreateInvisible	DM_CreateObject	The newly created object is created invisibly - independent of how the attribute AT_visible is set in the copy model.
DMF_CreateModel	DM_CreateObject	The object to be newly created is generated as a model.
DMF_DisableHandler	DM_DispatchHandler DM_ErrorHandler DM_InputHandler DM_NetHandler	Deactivates a registered handler function.
DMF_DontFreeLastStrings	DM_GetContent DM_GetValue DM_GetValueIndex DM_GetVectorValue DM_ValueCount DM_ValueGet DM_ValueIndex	Usually, the internal strings are overwritten on every call to the DM_Get* or DM_Value* function. By this option you can keep the strings valid.
DMF_DontTrace	DM_DispatchHandler DM_InputHandler DM_QueueExtEvent DM_SendEvent DM_WaitForInput	Function call is not traced.
DMF_DontWait	DM_EventLoop	Event processing is not carried out "blockingly", i.e. if there is an event, it will be processed; if there is no event, go back immediately to the calling function.
DMF_EnableHandler	DM_DispatchHandler DM_ErrorHandler DM_InputHandler DM_NetHandler	Reactivates a previously deactivated handler function.
DMF_FatalNetErrors	DM_Initialize	Sets a compatible behavior to the IDM versions before A.05.01.d for the Distributed Dialog Managers (DDM), enforcing an immediate termination on client and server side when a network, protocol or version error occurs.
DMF_ForceDestroy	DM_Destroy DM_StopDialog	The option means that the specified object is deleted. On DM_Destroy this option has to be set, if the object is to be deleted.
DMF_GetLocalString	DM_GetValue DM_GetValueIndex DM_GetVectorValue DM_ValueCount DM_ValueGet DM_ValueIndex	Text is returned as string in the language which is currently set.
DMF_GetMasterString	DM_GetValue DM_GetValueIndex DM_GetVectorValue DM_ValueCount DM_ValueGet DM_ValueIndex	Text is returned as string in the original language.
DMF_GetTextID	DM_GetValue DM_GetValueIndex DM_GetVectorValue	Text is returned as text ID.
DMF_IgnoreExtEvent	DM_WaitForInput	External events are ignored.
DMF_IncludeIdent	DM_ErrMsgText	The name of the part which has produced the error appears in the error message. This may be the operation system, the window system or DM.
DMF_IncludeModule	DM_ErrMsgText	The name of the module in which the error occurred appears in the error message.
DMF_IncludeSeverity	DM_ErrMsgText	The severity of the error (warning, error, fatal error) is contained in the error text.
DMF_IncludeText	DM_ErrMsgText	The actual error text is contained in the error message.
DMF_InheritFromModel	DM_CreateObject	The object including the children specified for the model are created.
DMF_Inhibit	DM_SetContent DM_SetValue DM_SetValueIndex DM_SetVectorValue	No event is created for the setting of the attribute and thus no rule will be triggered "on Object .Attribute changed".
DMF_InhibitTag	DM_TraceMessage	The beginning of the line "[UM]" is not printed during tracing.
DMF_LogFile	DM_TraceMessage	Output not in tracefile, but in logfile. Note If the start option -IDMtracefile is set, everything will always be written in the tracefile. This is also valid if the option DMF_LogFile is set. This option does have the above described effect - output in logfile and not in tracefile - only, if -IDMtracefile is not set!
DMF_NoCriticalSection	DM_QueueExtEvent DM_SendEvent	Prevents the function from using a critical section on Microsoft Windows.
DMF_NoFocusFrame	DM_GetValue DM_SetValue	Is valid for the attribute AT_options of the canvas on Motif. This option denotes a canvas which is meant not to have a focus frame.
DMF_OmitActive	DM_GetContent DM_SetContent	The attribute AT_active is not to be transferred.
DMF_OmitSensitive	DM_GetContent DM_SetContent	The attribute AT_sensitive is not to be transferred.
DMF_OmitStrings	DM_GetContent DM_SetContent	The strings are not transferred.
DMF_OmitUserData	DM_GetContent	The attribute AT_userdata is not filled by DM_GetContent.
DMF_OperationMenu	DM_Control	Controls the display of the operation menu at the windows.
DMF_Printf	DM_TraceMessage	The parameter "string" is interpreted in the same way as in the C function "printf".
DMF_RegisterHandler	DM_DispatchHandler DM_ErrorHandler DM_InputHandler DM_NetHandler	A new handler is installed by means of this option.
DMF_ReplaceFunctions	DM_BindFunctions	A function table existing for the object is replaced completely with a new one.
DMF_SaveAll	DM_SaveProfile	Also saves inherited values of configurable records in the configuration file.
DMF_SetCodePage	DM_Control DM_ControlEx	The specified code page is used in the application and all texts are transformed in this code page.
DMF_SetFormatCodePage	DM_Control DM_ControlEx	Defines the code page in which format functions interpret and return strings.
DMF_SetUserCodePage	DM_ControlEx	Defines the character code for iconv and thus indirectly influences the IDM code page CP_ucp. The code page CP_ucp is activated by DMF_SetCodePage. (Only on platforms that support iconv).
DMF_ShipEvent	DM_SetContent DM_SetValue DM_SetValueIndex DM_SetVectorValue	An event is created for the setting of the attribute and in doing so, the rule ".attribute changed" which possibly exists is triggered.
DMF_SignalMode	DM_Control DM_ControlEx	This option specifies the way DM intercepts signals.
DMF_Silent	DM_BindCallBacks	No error messages about missing functions or about too many defined functions are printed.
DMF_SortBinary	DM_ValueChange	Binary sorting of a collection.
DMF_SortLinguistic	DM_ValueChange	Sorting of a collection according to linguistic rules.
DMF_SortReverse	DM_ValueChange	Sorting of a collection in reverse order.
DMF_StaticValue	DM_StringChange DM_StringInit DM_ValueChange DM_ValueGet DM_ValueInit	Conversion into a static or global value reference in the case of automatic conversion into a managed value reference.
DMF_Synchronous	DM_QueueExtEvent DM_SendEvent	This option can optimize internal processes, if the function is not called from a signal handler.
DMF_UpdateScreen	DM_Control DM_ControlEx	All actions which are executed internally are made visible on the screen.
DMF_UseUserData	DM_SetContent	In the DM_Content-Vector, the userdata is considered and assigned to the object.
DMF_Verbose	DM_BindCallBacks DM_DataChanged	DM_BindCallbacks: Error messages about missing functions or about too many functions are printed DM_DataChanged: Activates tracing of this function.
DMF_WaitForEvent	DM_EventLoop	The function waits for exactly one event and then returns.
DMF_WindowListMenu	DM_Control	Controls the display of the menu of the window lists at windows.
DMF_WithDrawHandler	DM_DispatchHandler DM_ErrorHandler DM_InputHandler DM_NetHandler	This option uninstalls a handler function.
DMF_XlateString	DM_SetValue DM_SetValueIndex DM_SetVectorValue	The specified string is translated in the currently active language, before it is assigned to the object. This is only possible, if the text and the translation exist already.