SmartClick Settings / INI / Registry Notes

Settings (INI File / Registry Notes)

The following logic is used to manage SmartClick settings:

The initial defaults are in the SMARTCLK.INI file.

SmartClick can run exclusively from the INI file. This is accomplished by setting the DoNotUseRegistry=1 in the [Settings] section. This approach will use the SMARTCLK.INI file to hold all settings & configuration information. This approach means that every user of SmartClick on the machine SmartClick is installed on will have the same settings.

SmartClick can use the registry to hold different settings for different users. If DoNotUseRegistry=0 in the SMARTCLK.INI file, then the INI file will be used to establish the initial defaults, but from then on settings will be saved in the registry under the current user (e.g. HKEY_CURRENT_USER\SOFTWARE\Innovation Management Group, Inc.\SmartClick). This approach means that different users on the same machine can have customized settings.

The following documents the entries in the registry / INI file. The section (e.g. square-brackets heading) corresponds to a sub-key in the registry.

Version=1.70

Registry Only, used to track version of software installed - if this is different than the current running version, an automatic update will occur based on the current release.

[Settings]

DoNotUseRegistry=0

INI file only. If DoNotUseRegistry=1, then all settings will be saved in the INI file. If DoNotUseRegistry=0, then the INI settings will be used only as the original default settings to establish the current users original settings.

DisplayWindow=0

This is used to track whether the Info file (countdown display window) is visible. 1 is Yes, 0 is No.

DragPrompts=1

Sound setting. If DragPrompts=1, then spoken drag prompts are played during the drag sequence. Set DragPrompts=0 to bypass these.

DwellTime=1500

This is the dwell time in milliseconds, e.g. hover time to wait within Jitter distance prior to a click event. 1000 is 1 second.

Jitter=10

This is the distance in pixels

MenuCount=40

This is an internal setting for delays while the SmartClick menu is visible. A larger number means a longer delay.

Mode=16777217

This is an internal setting used to track SmartClick's status, and visible icons. It should not be modified.

PlaySounds=1

If PlaySounds=1, then click & double-click sounds will be played at each SmartClick event

QuietSounds=1

This is available if PlaySounds=1. When QuietSounds=1, a softer, quieter sound will be played for clicks and double-clicks.

ReleaseRequired=0

This is available only if SingleClicker=1. By default, SingleClicker actions will occur on the down button event. If ReleaseRequired=1, then the SingleClicker action will require the down, then up button events.

SingleClicker=0

If SingleClicker=1, then the SingleClicker mode is in use. This bypasses the hover/dwell wait time for event, and expects the user to perform a single click to activate the SmartClick action. Primarily used when a user can single click, but can't double-click or right-click. TouchScreen and SingleClicker are mutually exclusive, and TouchScreen should be 0 if SingleClicker=1.

SingleOnly=0

This is a setting (only available in menu from tray icon) that when enabled, performs the SmartClick action, then goes into an idle state. Due to changes in SmartClick's operation, it is not supported, and may not be fully functional. It is an obsolete setting, it should not be modified.

StartCount=30

This is an internal setting for delays - it is overridden internally based on the dwell setting. It is an obsolete setting, it should not be modified.

TouchScreen=0

If TouchScreen=1, then the touchscreen mode is in use. TouchScreen and SingleClicker are mutually exclusive, and SingleClicker should be 0 if TouchScreen=1.

Palette Icon Notes:

For entries in the palette that are actual Palette Icons to display, the actual value is used to indicate the order. Left most/top most is 1, next is 2, third is 4, fourth is 8, etc. Internally a 32 bit value is used to track modes & the order of the icons, so a value as a power of 2 is required.

ColorRef Notes

ColorRef entries are 0x00BBGGRR entries in Hex, where BB is Blue entries, GG is Green entries, and RR is Red entries. For example, 0x00FFFFFF is white.

[Palette]

Activate=32

This is the palette icon Active/Idle (SmartClick Light bulb)

Alt=0

This is the palette icon Alt key

AutoFit=1

AutoFit=1 means the automatic resize to screen upon orientation flip will occur.

AutoKeys=0

This setting determines the auto-repeat mode of operation. If AutoKeys=1 then the down/up keys will be used when in Auto-Repeat.

If AutoKeys=0, then the mouse click will be repeated.

AutoRepeat=8

This is the palette icon for Auto Repeat

BumpFlip=1

If BumpFlip=1, then the automatic switching of orientation is enabled, and an automatic switch in orientation will occur when pushed onto the opposite screen edge, e.g. if horizontal, you will flip to vertical when the left or right side of the screen is bumped.

ButtonBorder=2

This is the border between the buttons and the palette edge in pixels.

ButtonColor=65535

This is the color of the button background. It is a ColorRef entry, displayed in decimal.

ButtonHeight=32

This is the button height in pixels.

ButtonSpacing=4

This is the pixel spacing between buttons on the palette

ButtonWidth=32

This is the button width in pixels.

ChordClick=0

This is the palette icon Left-Right chord click

CloseWindow=16

This is the palette icon close active window

Control=0

This is the palette icon Control key

DoubleClick=1

This is the palette icon DoubleClick

Drag=2

This is the palette icon Drag

EscapeKey=0

This is the palette icon for the Escape key

HidePalette=0

This is the palette icon for Hide Palette

ImageDisplay=1

This setting indicates whether there is an image (palette icon) displayed on the palette for the corresponding palette icon.

MiddleClick=0

This is the palette icon for Middle click

MiddleDoubleClick=0

This is the palette icon for Middle double click

MovePalette=64

This is the palette icon for move palette

PaletteColor=12632256

This is the color of the palette background. It is a ColorRef entry, displayed in decimal.

PaletteType=0

The palette type is used by SmartClick Preferences to track small, medium, large, or custom.

PaletteX=443

PaletteY=263

These are the opening (top/left) position of the SmartClick palette.

Preferences=128

This is the palette icon for SmartClick Preferences

Reserved1=0

Reserved2=0

Reserved3=0

Reserved4=0

Reserved5=0

Reserved6=0

Reserved7=0

Reserved8=0

Reserved9=0

These are reserved entries for additional palette icons.

RightClick=4

This is the palette icon for right click

RightDoubleClick=0

This is the palette icon for right double click

Shift=0

This is the palette icon for shift key

SingleClick=0

This is an original setting for the left click. It is an obsolete setting, it should not be modified.

SnapToEdge=1

If SnapToEdge=1, then when SmartClick is within SnapToEdgePixels of an edge, SmartClick will "attract" to the edge.

SnapToEdgePixels=15

This is number of pixels the SmartClick palette must be from a screen edge in order to "snap" to the edge.

TextColor=0

This is the color of the text on the palette. It is a ColorRef entry, displayed in decimal.

TextDisplay=1

If TextDisplay=1, then the text is visible on the palette. If TextDisplay=0, then no text is used, only the image.

Vertical=0

This indicates the orientation of the palette. Vertical=0 means the palette is horizontal, and Vertical=1 means the palette is vertical.

WheelDown=0

WheelUp=0

X1Click=0

X2Click=0

These entries are reserved for additional palette icons, not used.

[Keyboard]

ActivationKey=Ctrl-A

This is the setting for the keyboard control (e.g. Ctrl-Down A Ctrl-Up) used to toggle the active/idle state of SmartClick.

OnOffKey=Ctrl-S

This is the setting for the keyboard control (e.g. Ctrl-Down S Ctrl-Up) used to toggle the visible/not visible state of SmartClick.

[Display]

DisplayChangeEnabled=2

The DisplayChangeEnabled is a setting to handle changes in resolution when SmartClick is running. DisplayChangeEnabled=0 means that no SmartClick action is taken. DisplayChangeEnabled=1 means that a basic approach is used to handle changes, and DisplayChangeEnabled=2 means a "smart" algorithm is used to handle repositioning.

SmartClick Copyright © 2003-2014 Innovation Management Group, Inc.

All Rights Reserved.