Estrutura de tópicosOutlining

Você pode optar por ocultar a exibição de algum código recolhendo uma região do código para que ele apareça sob um sinal de adição (+).You can choose to hide some code from view by collapsing a region of code so that it appears under a plus sign (+). Você expande uma região recolhida clicando no sinal de adição.You expand a collapsed region by clicking the plus sign. Se for um usuário de teclado, você poderá escolher Ctrl+M+M para recolher e expandir.If you are a keyboard user, you can choose Ctrl+M+M to collapse and expand. Você também pode recolher uma região de estrutura de tópicos clicando duas vezes em qualquer linha na região na margem da estrutura de tópicos, que aparece à esquerda do código.You can also collapse an outlining region by double-clicking any line in the region on the outlining margin, which appears just to the left of the code. Você pode ver o conteúdo de uma região recolhida como uma dica de ferramenta quando focaliza a região recolhida.You can see the contents of a collapsed region as a tooltip when you hover over the collapsed region.

Note

Este tópico aplica-se ao Visual Studio no Windows.This topic applies to Visual Studio on Windows. Para o Visual Studio para Mac, confira Editor de código-fonte (Visual Studio para Mac).For Visual Studio for Mac, see Source editor (Visual Studio for Mac).

As regiões na margem da estrutura de tópicos também são realçadas quando você focaliza a margem com o mouse.Regions in the outlining margin are also highlighted when you hover over the margin with the mouse. A cor de realce padrão pode parecer bastante esmaecida em algumas configurações de cor.The default highlighting color may seem rather faint in some color configurations. Você pode alterá-la em Ferramentas > Opções > Ambiente > Fontes e Cores > Região recolhível.You can change it in Tools > Options > Environment > Fonts and Colors > Collapsible Region.

Quando você trabalha no código de estrutura de tópicos, pode expandir as seções nas quais deseja trabalhar, recolhê-las quando terminar e passar para outras seções.When you work in outlined code, you can expand the sections you want to work on, collapse them when you are done, and then move to other sections. Quando você não quiser que a estrutura de tópicos seja exibida, você pode usar o comando Interromper Estrutura de Tópicos para remover as informações de estrutura de tópicos sem afetar o código subjacente.When you do not wish to have outlining displayed, you can use the Stop Outlining command to remove the outline information without disturbing your underlying code.

Os comandos Desfazer e Refazer no menu Editar afetam essas ações.The Undo and Redo commands on the Edit menu affect these actions. As operações de Copiar, Recortar, Colar e do tipo "arrastar e soltar" retêm informações de estrutura de tópico, mas não o estado da região recolhível.The Copy, Cut, Paste, and drag-and-drop operations retain outlining information, but not the state of the collapsible region. Por exemplo, quando você copia uma região recolhida, a operação Colar colará o texto copiado como uma região expandida.For example, when you copy a region that is collapsed, the Paste operation will paste the copied text as an expanded region.

Caution

Quando você altera uma região de estrutura de tópicos, a estrutura de tópicos pode ser perdida.When you change an outlined region, the outlining may be lost. Por exemplo, exclusões ou operações de Localizar e Substituir podem apagar o fim da região.For example, deletions or Find and Replace operations may erase the end of the region.

Os comandos a seguir podem ser encontrados no submenu Editar > Estrutura de Tópicos.The following commands can be found on the Edit > Outlining submenu.

Ocultar SeleçãoHide Selection (Ctrl+M, Ctrl+H) – recolhe um bloco de código selecionado que normalmente não estaria disponível para a estrutura de tópicos, por exemplo, um bloco if.(Ctrl+M, Ctrl+H) - Collapses a selected block of code that would not normally be available for outlining, for example an if block. Para remover a região personalizada, use Interromper Ocultação Atual (ou Ctrl+M, Ctrl+U).To remove the custom region, use Stop Hiding Current (or Ctrl+M, Ctrl+U). Não disponível no Visual Basic.Not available in Visual Basic.
Ativar/Desativar Expansão da Estrutura de TópicosToggle Outlining Expansion – Reverte o estado atual oculto ou expandido da seção de estrutura de tópicos mais interna quando o cursor está em uma seção recolhida aninhada.- Reverses the current hidden or expanded state of the innermost outlining section when the cursor lies in a nested collapsed section.
Ativar/Desativar Estrutura de Tópicos para TudoToggle All Outlining (Ctrl+M, Ctrl+L) – define todas as regiões para o mesmo estado recolhido ou expandido.(Ctrl+M, Ctrl+L) - Sets all regions to the same collapsed or expanded state. Se algumas regiões estiverem expandidas e algumas estiverem recolhidas, as regiões recolhidas serão expandidas.If some regions are expanded and some collapsed, then the collapsed regions are expanded.
Interromper Estrutura de TópicosStop Outlining (Ctrl+M, Ctrl+P) – remove todas as informações de estrutura de tópicos do documento inteiro.(Ctrl+M, Ctrl+P) - Removes all outlining information for the entire document.
Interromper Ocultação AtualStop Hiding Current (Ctrl+M, Ctrl+U) – remove as informações de estrutura de tópicos da região definida pelo usuário selecionada no momento.(Ctrl+M, Ctrl+U) - Removes the outlining information for the currently selected user-defined region. Não disponível no Visual Basic.Not available in Visual Basic.
Recolher para DefiniçõesCollapse to Definitions (Ctrl+M, Ctrl+O) – recolhe os membros de todos os tipos.(Ctrl+M, Ctrl+O) - Collapses the members of all types.
Recolher bloco:<limite lógico>Collapse Block:<logical boundary> (Visual C++) Recolhe uma região na função que contém o ponto de inserção.(Visual C++) Collapses a region in the function containing the insertion point. Por exemplo, se o ponto de inserção estiver dentro de um loop, o loop será ocultado.For example, if the insertion point lies inside a loop, the loop is hidden.
Recolher tudo: <estruturas lógicas>Collapse All in: <logical structures> (Visual C++) Recolhe todas as estruturas de dentro da função.(Visual C++) Collapses all the structures inside the function.

Você também pode usar o SDK do Visual Studio para definir as regiões de texto que deseja expandir ou recolher.You can also use the Visual Studio SDK to define the text regions you want to expand or collapse. Confira Passo a passo: Estrutura de tópicos.See Walkthrough: Outlining.

Consulte tambémSee also