Skip to content

System and Config

Asketyll edited this page Jul 2, 2026 · 4 revisions

System & Config

Update checks, language, variable & configuration management, tests, and documentation.

Update

CheckForUpdate

macro vba run [ARES]CheckForUpdate

Manually checks GitHub for a newer ARES release; bypasses the mute / ignore-version preferences (which only affect the automatic startup check).

Variable Default Purpose
ARES_Update_Mute False When True, silences the automatic startup update check.
ARES_Update_Ignore_Version (empty) A specific release the automatic check skips.

Language

Forces the ARES interface language. Restart afterwards.

macro vba run [ARES]English
macro vba run [ARES]Français
Variable Default Purpose
ARES_Language (empty) Language read by ARES. When empty, ARES falls back to MicroStation's CONNECTUSER_LANGUAGE.

Window positions

The option dialogs remember where you last placed them on screen — across MicroStation restarts and on multi-monitor setups. To forget every saved position and re-center any dialog currently open:

macro vba run [ARES]ResetFormPositions
Variable Default Purpose
ARES_Form_Layout (empty) Internal — each dialog's last position (percent of the virtual desktop). Managed automatically; not meant to be edited by hand.

Variable management

Reset all ARES variables to their default values:

macro vba run [ARES]ResetARESVariables

Remove all ARES variables:

macro vba run [ARES]RemoveARESVariables

Configuration files

Export the current configuration to a file:

macro vba run [ARES]ExportARESConfig

Import a configuration from a file:

macro vba run [ARES]ImportARESConfig

Display a summary of the current configuration:

macro vba run [ARES]ShowARESConfigSummary

Testing

⚠️ Deprecated / unmaintained — these commands are no longer kept up to date and may not reflect the current code.

Run all ARES unit tests:

macro vba run [ARES]RunARESTests

Run the ARES performance tests:

macro vba run [ARES]RunARESPerformanceTests

Documentation

Open this wiki in your default browser, in your ARES language:

macro vba run [ARES]OpenARESWiki

➡️ See Configuration Variables for the full list of every ARES variable.

Clone this wiki locally