MKI_SettingGet (Settings) Changed in Version 2025.0

C++ Syntax

INT_PTR

MKI_SettingGet(

 __int32 f_nMode );

Retrieves 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 (return value is bool, true = Active, false = Inactive).

MKI_SETTING_SNAPACTIVE

Snap status (return value is bool, true = Active, false = Inactive).

MKI_SETTING_SNAPMODE

Snap modes (return value is __int32, bit-wise OR combination of MKI_SNAPMODE_*).

MKI_SETTING_SNAPRADIUS

Snap radius (return value is __int32, 5..50).

MKI_SETTING_SNAPTOLERANCE

Snap radius (return value is __int32, 0..10).

MKI_SETTING_ORTHO

Orthogonal mode (return value is bool, true = Active, false = Disabled).

MKI_SETTING_ARCDIRECTION

Arc direction (return value is bool, true = Positive, false = Negative).

MKI_SETTING_ARCMODE

Arc mode (return value is __int32, see MKI_ARCMODE_*).

MKI_SETTING_AREAMODE

Area mode (return value is bool, true = Inside, false = Overlapping).

MKI_SETTING_GEODISPLAY

Construction Aid display (return value is bool, true = Visible, false = Invisible).

MKI_SETTING_GEOLOCKED Renamed in Version 2010.0

Construction Aid status (return value is bool, true = Locked, false = Editable).

MKI_SETTING_GEOBACKGROUND

Construction Aid display order (return value is bool, true = Background, false = Arbitrary).

MKI_SETTING_PAGEAUTOASSIGN New in Version 6.61

Automatically assign newly created objects to active page (return value is bool, true = Yes, false = No).

MKI_SETTING_MARKFORM New in Version 2023.1

Display form for markings (return value is __int32, see MKI_MARKFORM_*).

MKI_SETTING_MARKSIZE New in Version 2023.1

Size for marking (return value is __int32, 1000 = 1 % or 1 mm, always non-negative).

MKI_SETTING_MARKZOOMABLE New in Version 2023.1

Sizing mode for markings (return value is 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 (return value is bool, true = use object line color, false = use system default color).

MKI_SETTING_GRIDFORM New in Version 2023.1

Display form for grid point (return value is __int32, see MKI_MARKFORM_*).

MKI_SETTING_GRIDSIZE New in Version 2023.1

Size for grid points (return value is __int32, 1000 = 1 mm, always non-negative).

MKI_SETTING_SMALLDLG_COLOR New in Version 2022.2

Use the small version of the color dialog (return value is bool, true = Yes, false = No).

MKI_SETTING_SMALLDLG_TEXT New in Version 2022.2

Use the small version of the text dialogs (return value is bool, true = Yes, false = No).

MKI_SETTING_SMALLDLG_PROP New in Version 2022.2

Use the small version of the property dialog (return value is bool, true = Yes, false = No).

MKI_SETTING_SMALLDLG_XPROP_P New in Version 2024.0

Use the small version of the extended property dialog with passive pens (return value is bool, true = Yes, false = No).

MKI_SETTING_SMALLDLG_XPROP_A New in Version 2024.0

Use the small version of the extended property dialog with active pens (return value is bool, true = Yes, false = No).

MKI_SETTING_COLOR_LAYERS

Color of grayed layers (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_GEOMETRY

Color of default Construction Aid objects (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_BLOCKS

Color of block reference texts (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_ERASERS

Color of erasers (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_POINTS

Color of definition point markings (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_MARKS

Color of markings (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_INPUT

Color of input rubber lines (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_OBJSEL

Color of permanently selected objects (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_OBJUSE

Color of identified objects (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_OBJIDENT

Color of object highlight when identification is inaccurate (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_POINTUSE

Color of identified points (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_CURSOR1

Color of "large" cross-hair in active window (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_CURSOR2

Color of "small" cross-hair in inactive windows (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_PAGES

Color of page display (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_DRAWAREA

Color of drawing area background (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_HYPERLINKS

Color of hyperlinks (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_HIGHLIGHT New in Version 2012.1

Color of highlights (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_TEMP Renamed in Version 2025.0

Color of temporary objects (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_NOTES New in Version 2020.1

Color of internal notes (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_DIALOG_TEXT New in Version 2024.0

Skin-adapted text color of dialogs (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_DIALOG_BACK New in Version 2024.0

Skin-adapted background color of dialogs (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_DIALOG_GRAYTEXT New in Version 2024.0

Skin-adapted text color of disabled items in dialogs (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_CONTROL_TEXT New in Version 2024.0

Skin-adapted text color of edit / list controls (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_CONTROL_BACK New in Version 2024.0

Skin-adapted background color of edit / list controls (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_CONTROL_HIGHTEXT New in Version 2024.0

Skin-adapted text color of highlighted items in edit / list controls (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_CONTROL_HIGHBACK New in Version 2024.0

Skin-adapted background color of highlighted items in edit / list controls (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_COLOR_CONTROL_GRAYTEXT New in Version 2024.0

Skin-adapted text color of disabled items in edit / list controls (return value is MKI_COLORVALUE in RGB format).

MKI_SETTING_DISPLAY_LINES

Display line mode (return value is __int32, see MKI_LINEDISPLAY_*).

MKI_SETTING_DISPLAY_FILLS

Display fillings (return value is bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_ERASERS

Display erasers dyed (return value is bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_TEXTS

Display texts using original font (return value is bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_BOUNDARIES Changed in Version 2019.1

Display boundary lines (return value is __int32, see MKI_BOUNDARYLINE_*).

MKI_SETTING_DISPLAY_VARS

Evaluate variables (return value is bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_TERMS

Evaluate terms in variables (return value is bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_BITMAPS

Display bitmaps (return value is bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_BLOCKS

Display blocks (return value is bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_MARKS

Display markings (return value is bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_POINT_SIZE New in Version 2018.0

Size of point markings in pixels in form of an offset from the center-point (return value is __int32, minimum is 2).

MKI_SETTING_DISPLAY_SCREENSCALE New in Version 2022.0

Current scaling factor in percent of the screen (return value is __int32, range is 50 .. 200).

MKI_SETTING_DISPLAY_SKINSCALE New in Version 2019.0

Current scaling factor in percent of skins elements (return value is __int32, range is 25 .. 400), which is the product of the user-defined scaling of user interface elements (50 .. 200%) and MKI_SETTING_DISPLAY_SCREENSCALE (50 .. 200%).

MKI_SETTING_DISPLAY_DIALOGSCALE Changed in Version 2022.0

Current scaling factor in percent of dialogs and menus (return value is __int32, range is 25 .. 400), which is the product of the user-defined scaling of menus and dialog windows (50 .. 200%) and MKI_SETTING_DISPLAY_SCREENSCALE (50 .. 200%).

MKI_SETTING_DISPLAY_POINTS Changed in Version 2014.0

Display point markings (return value is __int32, see MKI_POINTDISPLAY_*).

MKI_SETTING_DISPLAY_OUTLINES

Display outlines (return value is bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_PERMONLY

Display only permanently selected objects (return value is bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_TERMS

Evaluate terms in variables (return value is bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_REFERENCES New in Version 6.20

Display references (return value is bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_HYPERLINKS New in Version 6.30

Display hyperlinks dyed (return value is bool, true = Yes, false = No).

MKI_SETTING_DISPLAY_PAGELAYERS New in Version 6.50

Page layer display mode (return value is __int32, see MKI_PAGELAYERS_*).

MKI_SETTING_DISPLAY_PAGEDISPLAY New in Version 6.50

Page object display mode (return value is __int32, see MKI_PAGEDISPLAY_*).

MKI_SETTING_DISPLAY_PAGEGRAY New in Version 6.61

Page object graying mode (return value is 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 (return value is __int32, see MKI_WINDOWMODE_*).

MKI_SETTING_EXTERNAL_XPROP

Display drawing using external properties (return value is bool, true = Yes, false = No).

MKI_SETTING_LINE_OPTIMIZE New in Version 2012.2

Optimize line types (return value is bool, true = Yes, false = No).

MKI_SETTING_FONT_RESOLVE

Resolve TrueType font into curves (return value is bool, true = Yes, false = No).

MKI_SETTING_FONT_MINIMUM

Minimum TrueType font size before graying it (return value is __int32, 0..99).

MKI_SETTING_FONT_DIALOG_REGULAR New in Version 6.50

Standard font for dialog windows to be used for owner-draw controls (return value is HFONT).

MKI_SETTING_FONT_DIALOG_ITALIC New in Version 6.50

Standard italic font for dialog windows to be used for owner-draw controls (return value is HFONT).

MKI_SETTING_FONT_DIALOG_BOLD New in Version 6.50

Standard bold font for dialog windows to be used for owner-draw controls (return value is HFONT).

MKI_SETTING_FONT_DIALOG_STRIKE New in Version 6.50

Standard strikeout font for dialog windows to be used for owner-draw controls (return value is HFONT).

MKI_SETTING_FONT_DIALOG_SMALL New in Version 6.50

Standard small font for dialog windows to be used for owner-draw controls (return value is HFONT).

MKI_SETTING_FONT_DIALOG_HEIGHT New in Version 2022.0

Height of standard font for dialog windows in pixels (return value is __int32).

MKI_SETTING_FONT_SKIN_REGULAR New in Version 2022.0

Standard skin font for user interface controls (return value is HFONT).

MKI_SETTING_FONT_SKIN_UNDERLINE New in Version 2022.0

Standard underlined skin font for user interface controls (return value is HFONT).

MKI_SETTING_FONT_SKIN_HEIGHT New in Version 2022.0

Height of standard skin font for user interface controls (return value is __int32).

MKI_SETTING_OUTPUT_PAGELAYERS New in Version 6.61

Page layers output mode (return value is bool, true = Output all layers, false = Do not output hidden layers).

MKI_SETTING_OUTPUT_PAGEDISPLAY New in Version 6.61

Page object output mode (return value is __int32, see MKI_PAGEDISPLAY_*).

MKI_SETTING_QUALITY_SCREEN New in Version 2010.0

Quality of screen display (return value is __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 (return value is __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 (return value is __int32, unit is [1/1000mm], maximum quality is 1, minimum quality is 1000000).

Return Value

Returns the desired setting. Depending on the type of setting to be retrieved, this return value has to be interpreted as a boolean value (bool), a normal integer (__int32), a bit-wise OR combination of several integer values (__int32), a font handle (HFONT), or a color description (MKI_COLORVALUE in RGB format).