[jackhill/qmk/firmware.git] / docs / keycodes_us_ansi_shifted.md

# US ANSI Shifted Symbols

These keycodes correspond to characters that are "shifted" on a standard US ANSI keyboard. They do not have keycodes of their own but are simply shortcuts for `LSFT(kc)`, and as such send a Left Shift with the unshifted keycode, not the symbol itself.

## Caveats

Unfortunately, these keycodes cannot be used in Mod-Taps or Layer-Taps, since any modifiers specified in the keycode are ignored.

Additionally, you may run into issues when using Remote Desktop Connection on Windows. Because these codes send shift very fast, Remote Desktop may miss the codes.

To fix this, open Remote Desktop Connection, click on "Show Options", open the the "Local Resources" tab. In the keyboard section, change the drop down to "On this Computer". This will fix the issue, and allow the characters to work correctly.

## Keycodes

|Key                     |Aliases            |Description|
|------------------------|-------------------|-----------|
|`KC_TILDE`              |`KC_TILD`          |`~`        |
|`KC_EXCLAIM`            |`KC_EXLM`          |`!`        |
|`KC_AT`                 |                   |`@`        |
|`KC_HASH`               |                   |`#`        |
|`KC_DOLLAR`             |`KC_DLR`           |`$`        |
|`KC_PERCENT`            |`KC_PERC`          |`%`        |
|`KC_CIRCUMFLEX`         |`KC_CIRC`          |`^`        |
|`KC_AMPERSAND`          |`KC_AMPR`          |`&`        |
|`KC_ASTERISK`           |`KC_ASTR`          |`*`        |
|`KC_LEFT_PAREN`         |`KC_LPRN`          |`(`        |
|`KC_RIGHT_PAREN`        |`KC_RPRN`          |`)`        |
|`KC_UNDERSCORE`         |`KC_UNDS`          |`_`        |
|`KC_PLUS`               |                   |`+`        |
|`KC_LEFT_CURLY_BRACE`   |`KC_LCBR`          |`{`        |
|`KC_RIGHT_CURLY_BRACE`  |`KC_RCBR`          |`}`        |
|`KC_PIPE`               |                   |`\|`       |
|`KC_COLON`              |`KC_COLN`          |`:`        |
|`KC_DOUBLE_QUOTE`       |`KC_DQUO`, `KC_DQT`|`"`        |
|`KC_LEFT_ANGLE_BRACKET` |`KC_LABK`, `KC_LT` |`<`        |
|`KC_RIGHT_ANGLE_BRACKET`|`KC_RABK`, `KC_GT` |`>`        |
|`KC_QUESTION`           |`KC_QUES`          |`?`        |
Commit	Line	Data
7b0356d1	1	# US ANSI Shifted Symbols
9b879b12	2
f6ec2ce2	3	These keycodes correspond to characters that are "shifted" on a standard US ANSI keyboard. They do not have keycodes of their own but are simply shortcuts for `LSFT(kc)`, and as such send a Left Shift with the unshifted keycode, not the symbol itself.
9b879b12	4
f6ec2ce2	5	## Caveats
9b879b12	6
f6ec2ce2	7	Unfortunately, these keycodes cannot be used in Mod-Taps or Layer-Taps, since any modifiers specified in the keycode are ignored.
f6ec2ce2	8
9374c0c9 DJ	9	Additionally, you may run into issues when using Remote Desktop Connection on Windows. Because these codes send shift very fast, Remote Desktop may miss the codes.
	10
	11	To fix this, open Remote Desktop Connection, click on "Show Options", open the the "Local Resources" tab. In the keyboard section, change the drop down to "On this Computer". This will fix the issue, and allow the characters to work correctly.
	12
f6ec2ce2	13	## Keycodes
9b879b12	14
40de65ea	15	\|Key \|Aliases \|Description\|
	16	\|------------------------\|-------------------\|-----------\|
	17	\|`KC_TILDE` \|`KC_TILD` \|`~` \|
	18	\|`KC_EXCLAIM` \|`KC_EXLM` \|`!` \|
	19	\|`KC_AT` \| \|`@` \|
	20	\|`KC_HASH` \| \|`#` \|
	21	\|`KC_DOLLAR` \|`KC_DLR` \|`$` \|
	22	\|`KC_PERCENT` \|`KC_PERC` \|`%` \|
	23	\|`KC_CIRCUMFLEX` \|`KC_CIRC` \|`^` \|
	24	\|`KC_AMPERSAND` \|`KC_AMPR` \|`&` \|
	25	\|`KC_ASTERISK` \|`KC_ASTR` \|`*` \|
	26	\|`KC_LEFT_PAREN` \|`KC_LPRN` \|`(` \|
	27	\|`KC_RIGHT_PAREN` \|`KC_RPRN` \|`)` \|
	28	\|`KC_UNDERSCORE` \|`KC_UNDS` \|`_` \|
	29	\|`KC_PLUS` \| \|`+` \|
	30	\|`KC_LEFT_CURLY_BRACE` \|`KC_LCBR` \|`{` \|
	31	\|`KC_RIGHT_CURLY_BRACE` \|`KC_RCBR` \|`}` \|
	32	\|`KC_PIPE` \| \|`\\|` \|
	33	\|`KC_COLON` \|`KC_COLN` \|`:` \|
	34	\|`KC_DOUBLE_QUOTE` \|`KC_DQUO`, `KC_DQT`\|`"` \|
	35	\|`KC_LEFT_ANGLE_BRACKET` \|`KC_LABK`, `KC_LT` \|`<` \|
	36	\|`KC_RIGHT_ANGLE_BRACKET`\|`KC_RABK`, `KC_GT` \|`>` \|
	37	\|`KC_QUESTION` \|`KC_QUES` \|`?` \|