Skip to content

Commit 6c8810c

Browse files
authored
Update application-patterns-for-visual-studio.md
Link to api for "default control button". Replace "These buttons are mapped to shortcut keys **by default**" as they are not unless using [MessageDialog.Show](https://learn.microsoft.com/en-us/dotnet/api/microsoft.visualstudio.platformui.messagedialog.show?view=visualstudiosdk-2022)
1 parent eed65e8 commit 6c8810c

File tree

1 file changed

+3
-8
lines changed

1 file changed

+3
-8
lines changed

docs/extensibility/ux-guidelines/application-patterns-for-visual-studio.md

Lines changed: 3 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -381,7 +381,8 @@ In general, **OK**, **Cancel**, and **Help** buttons should be arranged horizont
381381

382382
![Acceptable configurations for control buttons in Visual Studio dialogs](../../extensibility/ux-guidelines/media/0704-04_controlbuttonconfig.png "0704-04_ControlButtonConfig")<br />Acceptable configurations for control buttons in Visual Studio dialogs
383383

384-
The dialog must include a default control button. To determine the best command to use as the default, choose from the following options (listed in order of precedence):
384+
The dialog must include a default control button. This is a button that is invoked by pressing the Enter key - see [Button IsDefault](http://dotnet/api/system.windows.controls.button.isdefault?view=netframework-4.7.2)
385+
.To determine the best command to use as the default, choose from the following options (listed in order of precedence):
385386

386387
- Choose the safest and most secure command as the default. This means choosing the command most likely to prevent data loss and avoid unintended system access.
387388

@@ -390,13 +391,7 @@ The dialog must include a default control button. To determine the best command
390391
Avoid choosing a permanently destructive action for the default command. If such a command is present, choose a safer command as the default instead.
391392

392393
#### Access keys
393-
Do not use access keys for **OK**, **Cancel**, or **Help** buttons. These buttons are mapped to shortcut keys by default:
394-
395-
| Button name | Keyboard shortcut |
396-
| --- | --- |
397-
| OK | Enter |
398-
| Cancel | Esc |
399-
| Help | F1 |
394+
Do not use access keys for **OK** or **Cancel**. Enter and Escape shortcuts can be set with [Button IsDefault](http://dotnet/api/system.windows.controls.button.isdefault?view=netframework-4.7.2) and [Button IsCancel](http://dotnet/api/system.windows.controls.button.iscancel?view=netframework-4.7.2) respectively.
400395

401396
#### Imagery
402397
Use images sparingly in dialogs. Don't use large icons in dialogs merely to use up space. Use images only if they are an important part of conveying the message to the user, like warning icons or status animations.

0 commit comments

Comments
 (0)