Skip to content

Latest commit

 

History

History
264 lines (244 loc) · 5.79 KB

CONFIG.md

File metadata and controls

264 lines (244 loc) · 5.79 KB
Raw

TranslucentFlyouts

Due to the numerous configurable options, this page may not be updated promptly. Therefore, we appeal to everyone to improve this documentation together, and any PRs are welcome!

Other languages

简体中文
Deutsch

Description

Target version:

  • V2.0.0-alpha.4
  • V2.0.x
  • V2.1.0

Note:
Earlier versions are not supported, and the content displayed on this page and its subpages may be outdated for updated versions.

The current version of TranslucentFlyouts uses the registry to store configuration information.
Storage location: HKEY_CURRENT_USER\SOFTWARE\TranslucentFlyouts\
The values here are used to define the common appearance of pop-up menus and dropdown controls. Values in child items with the same name will be given priority.

Related child items can be found at:

Values

Type: DWORD

Name Accepted Values Description
EffectType
Default Value: 5
None: 0
Fully Transparent: 1
Solid Color: 2
Blurred: 3
Acrylic: 4
Modern Acrylic: 5
Acrylic Background Layer: 6
Mica Background Layer: 7
Mica Variant Background Layer: 8
Effect and background type used for pop-up controls.

Windows 10:  Not supported: 6, 7, 8; using 5 is equivalent to using 4
Windows 11 22H2+:  Not supported: 2, 3
Windows 11 (Before Build 22000):  Not supported: 6, 8
Note: When using 6, 7, 8, the Fluent Menu animation will not be rendered correctly
CornerType
Default Value: 3
Don't Change: 0
Sharp Corner: 1
Large Round Corner: 2
Small Round Corner: 3
Corner type used for pop-up controls.

Windows 10:  Not supported
EnableDropShadow
Default Value: 0
Disable: 0
Enable: 1
Enable an additional border with a shadow.
Note: Only visible when EffectType is 4 or 5 and CornerType is 1.
NoBorderColor
Default Value: 0
Use Border Color: 0
Do Not Use Border Color: 1
Do not render system borders.

Windows 10:  Only supports removing the system border of pop-up menus.
EnableMiniDump
Default Value: 1
Disable: 0
Enable: 1
Hook all unhandled exceptions from other applications and redirect crash dumps to the install directory, in the event that a crash may be related to TranslucentFlyouts.
EnableThemeColorization
Default Value: 0
Disable: 0
Enable: 1
Use your current theme color as the system border color.
This option is ignored when DarkMode_BorderColor/LightMode_BorderColor values are present.
DarkMode_BorderColor
Default Value: Theme-defined value
Border color in dark mode (AARRGGBB).

Windows 10:  Only supports overriding the system border color of pop-up menus.
Windows 11:  The alpha channel will always be ignored when CornerType is not 1.
LightMode_BorderColor
Default Value: Theme-defined value
Border color in light mode (AARRGGBB).

Windows 10:  Only supports overriding the system border color of pop-up menus.
Windows 11:  The alpha channel will always be ignored when using rounded corners.
DarkMode_GradientColor
Default Value: 0x412B2B2B
Overlay color in dark mode (AARRGGBB), used by EffectType.

Note: This value will be ignored when EffectType is 6, 7, or 8.
LightMode_GradientColor
Default Value: 0x9EDDDDDD
Overlay color in light mode (AARRGGBB), used by EffectType.

Note: This value will be ignored when EffectType is 6, 7, or 8.
Disabled
Default Value: 0
Disable: 0
Enable: 1
Disable TranslucentFlyouts.
The translucent and animation effects for pop-up menus and dropdown controls will be disabled.

Reading Order

Sometimes, some values may not be created yet and do not exist. In this case, TranslucentFlyouts will use a specific reading order as a fallback to read existing values as much as possible. You can use this feature to create a unified configuration that applies to multiple users.

  1. HKEY_CURRENT_USER\SOFTWARE\TranslucentFlyouts\
  2. HKEY_LOCAL_MACHINE\SOFTWARE\TranslucentFlyouts\
  3. Use default values