Embedded Winget

arg

• Value is formatted as if it’s an argument on a command line. Numbers are left alone; booleans are 0 or 1; size and position have their X and Y values separated by a space; pretty much everything else is DM-escaped and enclosed in quotes.
• DM-escape the value as if it’s in a quoted string but do not include the quotes. Size and position values both use , to separate their X and Y values.
• Value is formatted as a DM-escaped string with surrounding quotes.
• Format value for a URL-encoded parameter list (see list2params), escaping characters as needed.
• JSON formatting. Numbers are left unchanged; size or position values are turned into objects with x and y items; boolean values are true or false.
• JSON formatting, but DM-escaped so it can be included in a quoted string. Quotes are not included.
• Does not change the value’s text representation in any way; assumes it’s already formatted correctly for the purpose. This is similar to as arg but does no escaping and no quotes.

Commands that are initiated by the skin (like button.command, map.on-show, etc.) have a special syntax that allows you to include information that would normally require a winget call. By including [[*something*]] in the command, the double-bracketed text will be replaced by the result of running a winget on that parameter.

A value of [[id.parameter]] will run a winget on the control with the given ID. Just using [[parameter]] will run a winget for the control that initiated this command. You can also use parent in place of the ID to do something with the parent of the control, or parent.id for access to a sibling control. Position and size parameters can be further broken down by appending .x or .y to get at the numbers directly.

Several commands already support some special cases like [[*]] or [[width]] or such, where the special-case values are relevant to the command. An example is that in on-size the value of [[*]] is a size value. The Any macro, gamepad macros, and mouse macros, also support this syntax; see macros for more info.

You can choose how embedded wingets get formatted by following the value with as and a type, such as [[window.size as string]]. There are several types you can use, and different types of parameters get formatted differently:

The arg type is the default, unless the [[…]] expression has double quotes on both sides, in which case escaped is the default.

See also

Client commands