C++ Syntax

class MKI_ENGINE_DATA

{

public:

__int32 m_nUserMode;

HICON m_hAppIcon;

MKI_STR32W m_szAppTitle;

MKI_STR64W m_szExitCommand;

MKI_ABOUT_PROC m_pfnAboutCallback;

MKI_STR64A m_szLicenseName,

m_szLicenseCode;

void

Init( const LPCWSTR f_szTitle );

};

This structure contains global settings for the engine.

Only available in CAD6engine!

Element Description

m_nUserMode

[__int32] Desired modes for a possible user interface to be displayed later by means of MKI_EngineUserInterface(). These modes do not influence or disable any internal API commands, only the amount of menu commands presented to the user. It can be a bit-wise OR combination of multiple flags (see MKI_USERMODE_*).

Hiding specific command sets from the user interface does not guarantee that the respective commands cannot be used by the user via other methods (although it is very unlikely). If you wish to make absolutely sure that your drawing data remains unchanged, save it before calling the user interface and reload it once the interface was closed again. Unless you disable it, a technically gifted user can extend the CAD6engine (and thus your application) with plug-ins that can make any changes to the data.

m_hAppIcon

[HICON] Handle of the icon to be used in all dialog windows and the user interface. May only be nullptr if you'll neither call any dialog function nor the user interface. There is not default icon!

m_szAppTitle

[MKI_STR32W] Title of the product that calls the engine. This name will be displayed in the caption of the user interface (if invoked). If empty, a standard text such as "CAD6engine" will be used.

m_szExitCommand

[MKI_STR64W] Command to be added to the "File" menu to exit the user interface. If empty, a standard command such as "Close Window" will be used.

m_pfnAboutCallback

[MKI_ABOUT_PROC] Address of a function that will be called when the user selects a special "About AppTitle..." command that will be added to the "Help" menu of the interface. Use that function to display information about your application to the user. If nullptr, no such special menu command will be available.

m_szLicenseName

[MKI_STR64A] The licensee name you received from us (e.g. "ACME Corp."). This is an ANSI string! You can either copy your license information here or leave it blank if you already copied the license information to the user's computer using our unlock tool mkunlock.exe (the engine will then read that data from the registry database).

m_szLicenseCode

[MKI_STR64A] License code you received from us (e.g. "1A2B3-C4D5E-6F7G8-H1Z2Y-3X4W5"). This is an ANSI string! You can either copy your license information here or leave it blank if you already copied the license information to the user's computer using our unlock tool mkunlock.exe (the engine will then read that data from the registry database).

MKD Syntax

Unused.