# Acessibilidade

## Screen readers

O MuseScore Studio é compatível com NVDA no Windows e VoiceOver no macOS. O JAWS não é compatível no momento. O suporte para outros leitores de tela varia.

### Speech on Windows

Se a fala não estiver funcionando no MuseScore, tente pressionar `Alt`+`F` para focar no menu Arquivo e, em seguida, pressione `Esc` duas vezes para retornar ao ponto em que você estava no aplicativo. Nesse ponto, o leitor de tela deverá voltar a funcionar. Isso costuma ser necessário se você iniciar o leitor de tela depois que o MuseScore já estiver em execução.

Como mencionado acima, a narração do MuseScore com o JAWS não é tão completa quanto com o Narrator ou o NVDA.

| Leitor de tela                                                      | Tecla modificadora           | Atalho de liga/desliga             | Atalho de configurações |
| ------------------------------------------------------------------- | ---------------------------- | ---------------------------------- | ----------------------- |
| Narrador (integrado)                                                | `Narrador` = `Caps Lock`     | `Win`+`Ctrl`+`Enter`               | `Win`+`Ctrl`+`N`        |
| NVDA ([livre](https://www.nvaccess.org/download/))                  | `NVDA` = `Ins` / `Caps Lock` | Off: `NVDA`+`Q` Toggle: `NVDA`+`S` | `NVDA`+`N`              |
| JAWS ([pago](https://support.freedomscientific.com/Downloads/JAWS)) | `JAWS` = `Ins` / `Caps Lock` | Desligar: `JAWS`+`F4`              | `JAWS`+`J`              |

### Speech on macOS

O [modo Quick Nav](https://support.apple.com/guide/voiceover/with-quick-nav-vo27943/mac) do VoiceOver deve ser desativado ao usar o MuseScore 4. Você pode ativar ou desativar o Quick Nav pressionando as teclas de seta `Esquerda` e `Direita` simultaneamente enquanto o VoiceOver estiver em execução ou em **VoiceOver Utility > Commanders**.

A interface do MuseScore é navegável tanto com o cursor de tabulação quanto com o cursor do próprio VoiceOver. Em geral, é melhor usar o cursor de tabulação, pois ele corresponde à interface de outras plataformas e, portanto, é o que você encontrará descrito na maioria das documentações e tutoriais. Ao usar o cursor de tabulação, lembre-se de usar as teclas de seta e a tecla `Tab`, conforme descrito em [Navegando pela UI](#navigating-the-ui). O cursor do VoiceOver pode ser usado para acessar áreas do aplicativo que ainda não estão acessíveis ao cursor de tabulação.

| Leitor de tela        | Tecla modificadora                   | Atalho de liga/desliga | Atalho de configurações |
| --------------------- | ------------------------------------ | ---------------------- | ----------------------- |
| VoiceOver (integrado) | `VO` = `Ctrl`+`Option` / `Caps Lock` | `Cmd`+`F5`             | `VO`+`F8`               |

### Speech on Linux

No Linux, é necessário iniciar o leitor de tela antes de iniciar o MuseScore; caso contrário, os recursos de acessibilidade serão desabilitados para economizar recursos do sistema (o mesmo vale para todos os aplicativos Qt no Linux). Caso se esqueça de fazer isso, basta sair do MuseScore e iniciá-lo novamente, desta vez com o leitor de tela em execução.

O Orca é o leitor de tela mais completo disponível para Linux. O Orca é integrado ao ambiente de trabalho GNOME. Portanto, é recomendado que usuários Linux com necessidades de acessibilidade utilizem uma distribuição baseada no GNOME ou em um de seus derivados.

| Leitor de tela            | Tecla modificadora           | Atalho de liga/desliga | Atalho de configurações              |
| ------------------------- | ---------------------------- | ---------------------- | ------------------------------------ |
| Orca (integrado ao GNOME) | `Orca` = `Ins` / `Caps Lock` | `Super`+`Alt`+`S`      | `Orca`+`Space` or run `orca --setup` |

## Keyboard access

### Navigating the UI

A interface do usuário (UI) do MuseScore possui um sistema hierárquico de navegação por teclado, diferente do que você pode estar acostumado em outros aplicativos. No sistema do MuseScore, a tecla `Tab` pula alguns controles para economizar tempo. Para acessar esses controles, você precisa usar as teclas de seta, além da tecla `Tab`.

| Atalho                                          | Ação                                                                                                                                                         |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `F6` / `` ` `` / `Shift`+`F6` / `Shift`+`` ` `` | Move entre as seções da UI (`` ` `` é a tecla de acento grave ou crase, encontrada perto da tecla `Tab` ou `Shift` esquerdo na maioria dos teclados QWERTY). |
| `Tab` / `Shift`+`Tab`                           | Move entre os grupos de controle.                                                                                                                            |
| `Cima` / `Baixo` / `Esquerda` / `Direita`       | Move entre controles dentro de um grupo.                                                                                                                     |
| `Esc`                                           | Para de interagir com um controle de texto editável (para que você possa se afastar dele com as teclas de seta).                                             |
| `Enter` / `Return`                              | Ativa o controle atual.                                                                                                                                      |
| `Espaço`                                        | Ativa o controle atual ou seleciona um item em uma lista.                                                                                                    |

Observe que os atalhos de navegação da UI são fixos e não podem ser alterados, ao contrário dos atalhos para navegação de partituras, que podem ser [personalizados em Preferências](/pt_br/customization/keyboard-shortcuts.md).

### Navigating the score

Os seguintes atalhos são de particular valor para usuários de acessibilidade:

| Atalho                             | Ação                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Direita` / `Esquerda`             | **Move para a nota, acorde ou pausa próxima ou anterior.**                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `Alt`+`Direita` / `Alt`+`Esquerda` | **Move para o elemento próximo ou anterior.** Esses atalhos permitem que você visite todos os tipos de elementos de notação, não apenas notas e pausas.                                                                                                                                                                                                                                                                                                                                                     |
| `Alt`+`Cima` / `Alt`+`Baixo`       | **Move para a nota acima ou abaixo.** Esses atalhos permitem que você navegue entre notas individuais em um acorde e também alcance notas e pausas em outras vozes e em outras pautas.                                                                                                                                                                                                                                                                                                                      |
| `F2` / `Alt`+`Shift`+`E`           | **Editar o elemento selecionado.** Equivale a clicar duas vezes com o mouse. Use-o para editar objetos de texto ou ajustar o comprimento de linhas de dinâmica, ligaduras e chaves de voltas (use a tecla `Tab` para alterar a extremidade da linha que você está ajustando). Ao terminar a edição, pressione `Esc` para retornar ao modo Normal.                                                                                                                                                           |
| `Menu` / `Shift`+`F10`             | **Open context menu for selected element(s).** Equivalent to right-clicking with the mouse. It provides access to various options that depend on the element selected. Use this shortcut on a [range selection](/pt_br/basics/selecting-elements.md#Selecting_a_range_using_the_keyboard) to provide access to [Measure properties](/pt_br/notation/rhythm-meter-and-measures/measure-properties.md), and [Staff/Part properties](/pt_br/notation/instruments-staves-and-systems/staff-part-properties.md). |

Outros aspectos da navegação pelo teclado são descritos ao longo das páginas deste manual. Todos os atalhos de navegação e manipulação de partituras podem ser [personalizados em Preferências](/pt_br/customization/keyboard-shortcuts.md).

## Video tutorials

Os tutoriais de acessibilidade a seguir foram elaborados para ajudar você a começar a usar o MuseScore, usando seu teclado e leitor de tela. Eles não abrangem todos os aspectos do programa, mas devem fornecer uma base sólida para que você possa aproveitar ao máximo o restante deste Manual.

| Vídeo                                                     | Tópicos abordados                                                                                                                                                                                    |
| --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Instalando o MuseScore](https://youtu.be/TFdhtLIXLPc)    | Instalação do MuseScore no Windows, incluindo o Muse Hub e o Muse Sounds. O processo é semelhante no macOS e no Linux, embora no Linux você precise instalar o Muse Hub e o MuseScore separadamente. |
| [Configuração de partitura](https://youtu.be/Fh45A6V3410) | Configuração inicial da partitura, incluindo escolha dos instrumentos, armadura de clave, fórmula de compasso e outras configurações.                                                                |
| [Inserindo música](https://youtu.be/mkZPsGYZ3QQ)          | Entrada de notas básicas.                                                                                                                                                                            |
| [Adicionando marcações](https://youtu.be/oRrT4WpE0PY)     | Usando as paletas para adicionar marcações (e.g. dinâmica) à sua partitura.                                                                                                                          |
| [A interface do usuário](https://youtu.be/zxZ4OCBj00w)    | Janela principal do programa, para que você possa entender onde estão todos os diferentes painéis, barras de ferramentas e controles, e como acessá-los pelo teclado.                                |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://handbook.musescore.org/pt_br/navigation/accessibility.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
