MKI_SettingSet (Settings) Changed in Version 2024.0

C++ Syntax

void

MKI_SettingSet(

 __int32 f_nMode,

 INT_PTR f_nValue );

Alters a setting of the serving application.

Parameters

Mode

[__int32] This value determines what setting is to be retrieved. Possible values are:

MKI_SETTING_DUPLICATE

Duplicate status (Value is handled as bool, true = Active, false = Inactive).

MKI_SETTING_SNAPACTIVE

Snap status (Value is handled as bool, true = Active, false = Inactive).

MKI_SETTING_SNAPMODE

Snap modes (Value is handled as __int32, bit-wise OR combination of MKI_SNAPMODE_*).

MKI_SETTING_SNAPRADIUS

Snap radius (Value is handled as __int32, 5..50).

MKI_SETTING_SNAPTOLERANCE

Snap radius (Value is handled as __int32, 0..10).

MKI_SETTING_ORTHO

Orthogonal mode (Value is handled as bool, true = Active, false = Disabled).

MKI_SETTING_ARCDIRECTION

Arc direction (Value is handled as bool, true = Positive, false = Negative).

MKI_SETTING_ARCMODE

Arc mode (Value is handled as __int32, see MKI_ARCMODE_*).

MKI_SETTING_AREAMODE

Area mode (Value is handled as bool, true = Inside, false = Overlapping).

MKI_SETTING_GEODISPLAY

Construction Aid display (Value is handled as bool, true = Visible, false = Invisible).

MKI_SETTING_GEOLOCKED Renamed in Version 2010.0

Construction Aid status (Value is handled as bool, true = Locked, false = Editable).

MKI_SETTING_GEOBACKGROUND

Construction Aid display order (Value is handled as bool, true = Background, false = Arbitrary).

MKI_SETTING_PAGEAUTOASSIGN New in Version 6.61

Automatically assign newly created objects to active page (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_MARKFORM New in Version 2023.1

Display form for markings (Value is handled as __int32, see MKI_MARKFORM_*).

MKI_SETTING_MARKSIZE New in Version 2023.1

Size for marking (Value is handled as __int32, 1000 = 1 % or 1 mm, always non-negative).

MKI_SETTING_MARKZOOMABLE New in Version 2023.1

Sizing mode for markings (Value is handled as bool, true = size is zoomable and given in millimeters, false = size is fixed and given in % of screen height).

MKI_SETTING_MARKCOLORED New in Version 2023.1

Color display mode for marking (Value is handled as bool, true = use object line color, false = use system default color).

MKI_SETTING_GRIDFORM New in Version 2023.1

Display form for grid points (Value is handled as __int32, see MKI_MARKFORM_*).

MKI_SETTING_GRIDSIZE New in Version 2023.1

Size for grid points (Value is handled as __int32, 1000 = 1 mm, always non-negative).

MKI_SETTING_SMALLDLG_COLOR New in Version 2022.2

Choose between large and small color dialog (Value is handled as bool, true = Small, false = Large). The user can block this setting!

MKI_SETTING_SMALLDLG_TEXT New in Version 2022.2

Choose between large and small text dialogs Value is handled as bool, true = Small, false = Large). The user can block this setting!

MKI_SETTING_SMALLDLG_PROP New in Version 2022.2

Choose between large and small property dialog (Value is handled as bool, true = Small, false = Large). The user can block this setting!

MKI_SETTING_SMALLDLG_XPROP_P New in Version 2024.0

Choose between large and small extended property dialog with passive pens (Value is handled as bool, true = Small, false = Large). The user can block this setting!

MKI_SETTING_SMALLDLG_XPROP_A New in Version 2024.0

Choose between large and small extended property dialog with active pens (Value is handled as bool, true = Small, false = Large). The user can block this setting!

MKI_SETTING_DISPLAY_LINES

Display line mode (Value is handled as __int32, see MKI_LINEDISPLAY_*).

MKI_SETTING_DISPLAY_FILLS

Display fillings (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_ERASERS

Display erasers colored (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_TEXTS

Display texts using original font (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_BOUNDARIES Changed in Version 2019.1

Display boundary lines (Value is handled as __int32, see MKI_BOUNDARYLINE_*).

MKI_SETTING_DISPLAY_VARS

Evaluate variables (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_BITMAPS

Display bitmaps (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_BLOCKS

Display blocks (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_MARKS

Display markings (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_POINTS Changed in Version 2014.0

Display point markings (Value is handled as __int32, see MKI_POINTDISPLAY_*).

MKI_SETTING_DISPLAY_OUTLINES

Display outlines (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_PERMONLY

Display only permanently selected objects (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_TERMS

Evaluate terms in variables (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_REFERENCES New in Version 6.20

Display references (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_HYPERLINKS New in Version 6.30

Display hyperlinks dyed (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_PAGELAYERS New in Version 6.50

Page layer display mode (Value is handled as __int32, see MKI_PAGELAYERS_*).

MKI_SETTING_DISPLAY_PAGEDISPLAY New in Version 6.50

Page object display mode (Value is handled as __int32, see MKI_PAGEDISPLAY_*).

MKI_SETTING_DISPLAY_PAGEGRAY New in Version 6.61

Page object graying mode (Value is handled as bool, true = Display hidden objects in gray, false = Do not display hidden objects).

MKI_SETTING_DISPLAY_WINDOWMODE New in Version 2024.0

Drawing window arrangement mode (Value is handled as __int32, see MKI_WINDOWMODE_*).

MKI_SETTING_EXTERNAL_XPROP

Display drawing using external properties (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_LINE_OPTIMIZE New in Version 2012.2

Optimize line types (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_SCROLL_STEP

Current scroll step in percent (Value is handled as __int32, 5..100).

MKI_SETTING_FONT_RESOLVE

Resolve TrueType font into curves (Value is handled as bool, true = Yes, false = No).

MKI_SETTING_FONT_MINIMUM

Minimum TrueType font size before graying it (Value is handled as __int32, 0..99).

MKI_SETTING_OUTPUT_PAGELAYERS New in Version 6.61

Page layers output mode (Value is handled as bool, true = Output all layers, false = Do not output hidden layers).

MKI_SETTING_OUTPUT_PAGEDISPLAY New in Version 6.61

Page object output mode (Value is handled as __int32, see MKI_PAGEDISPLAY_*).

MKI_SETTING_QUALITY_SCREEN New in Version 2010.0

Quality of screen display (Value is handled as __int32, unit is [1/1000mm], maximum quality is 1, minimum quality is 1000000).

MKI_SETTING_QUALITY_PRINT New in Version 2010.0

Quality of print-out (Value is handled as __int32, unit is [1/1000mm], maximum quality is 1, minimum quality is 1000000).

MKI_SETTING_QUALITY_CONVERT New in Version 2010.0

Quality of conversion/export (Value is handled as __int32, unit is [1/1000mm], maximum quality is 1, minimum quality is 1000000).

Value Changed in Version 2015.2

[INT_PTR] Value to which the desired setting shall be set. Depending on the type of setting to be altered, this value will either be interpreted as a boolean value (bool), a normal integer (__int32) or a bit-wise OR combination of several integer values (__int32).

Comment

Please note that this procedure is not able to alter all settings that can be determined by the MKI_SettingGet procedure! When calling this procedure with an invalid Mode parameter, it will return immediately without performing any action.

The application lets the user permanently block changes by any of the MKI_SETTING_SMALLDLG_* modes, so do not rely on such a change to have an effect!

If the status of the setting to be altered is displayed by the serving application (e.g. in a button in the panel window), this display will automatically be updated. If the setting influences the drawing's display, this will not automatically be updated. Instead, the plug-in should redraw the display by calling MKI_DrawWindowAll once after all settings have been modified.