Cómo: Esquematizar y ocultar el código

Artículo
08/10/2011

De forma predeterminada, todo el texto se muestra en el editor de código, pero puede hacer que no se vea parte del mismo. El editor de código le permite seleccionar una región de código y contraerla, de forma que aparezca debajo de un signo más (+).

Código después de contraerse

Haga clic en el signo más (+) situado junto al símbolo para expandir u ocular la región. El código esquematizado no se elimina, simplemente se oculta.

Código antes de contraerse

Los comandos Deshacer y Rehacerdel menú Edición afectan a estas acciones. Es decir, si crea una región contraíble, puede elegir Deshacer, para invertir esta acción. Además, Copiar, Cortar, Pegar y las operaciones de arrastrar y colocar conservan la información de la esquematización, pero no conservan el estado de la región contraíble. Por ejemplo, cuando copia una región que se contrae, la operación Pegar pegará el texto copiado como región expandida.

Después de esquematizar el código, puede expandir sólo aquellas secciones en las que desee trabajar, contraerlas cuando haya terminado y desplazarse a otras secciones. Durante la esquematización, podrá usar el comando Detener esquematización para quitar la información de esquematización sin alterar el código subyacente.

Precaución
Al invalidar la región, se pierde la región esquematizada. Por ejemplo, las operaciones de eliminar o Buscar y reemplazar pueden borrar el final de la región.

Los comandos siguientes están disponibles en el submenú Esquematización del menú Editar y en el menú contextual del editor de código:

Nota

Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de los valores de configuración o de edición activos. Para cambiar la configuración, elija la opción Importar y exportar configuraciones del menú Herramientas. Para obtener más información, vea Trabajar con valores de configuración.

Comando	Definición
Ocultar selección	Contrae el texto actualmente seleccionado. Para que se pueda ejecutar este comando, debe haber texto seleccionado. Las teclas de método abreviado son CTRL+M y, a continuación, CTRL+H. Nota Este comando está disponible en Visual C# cuando está desactivada la opción Esquematización automática o está seleccionada la opción Detener esquematización.No está disponible en Visual Basic.
Alternar expansión de esquematización	Invierte el estado oculto o expandido de la sección de esquematización más interna en la que esté situado el cursor cuando se encuentre en una sección contraída anidada. Las teclas de método abreviado son CTRL+M y, a continuación, CTRL+M.
Alternar toda la esquematización	Establece todos los procedimientos en el mismo estado oculto o expandido. Si algunas regiones están expandidas y otras están ocultas, entonces las regiones ocultas estarán expandidas. Las teclas de método abreviado son CTRL+M y, a continuación, CTRL+L.
Detener esquematización	Quita toda la información de esquematización del documento completo. Todas las regiones se ven y se han quitado los símbolos, pero el código subyacente permanece igual. Las teclas de método abreviado son CTRL+M y, a continuación, CTRL+P.
Iniciar esquematización automática	Este comando sólo está disponible cuando está desactivada la opción Esquematización automática. Utilice este comando para habilitar la esquematización automática en el IDE.
Detener ocultar actual	Quita la información de esquematización para la región definida por el usuario que está seleccionada actualmente. Las teclas de método abreviado son CTRL+M y, a continuación, CTRL+U. Nota Este comando está disponible en Visual C# cuando está desactivada la opción Esquematización automática o está seleccionada la opción Detener esquematización. No está disponible en Visual Basic.
Contraer a definiciones	Contrae los miembros de todos los tipos, de manera que todos los miembros que pertenecen a un tipo se vean claramente. Idéntico al comando Contraer bloque, salvo en que el entorno se ejecuta automáticamente a través de todo el código del documento, crea regiones en cada uno de los procedimientos y después las oculta. Las teclas de método abreviado son CTRL+M y, a continuación, CTRL+O.
Contraer bloque: <límite lógico>	(Visual C++) El entorno se sirve del servicio del lenguaje de programación para determinar automáticamente los límites lógicos con el fin de crear una región en la función que contiene el punto de inserción y, a continuación, la oculta. Por ejemplo, si el punto de inserción se encuentra dentro de un bucle, se creará una región para esta instrucción y la región quedará oculta. Cada vez que ejecute este comando, el siguiente nivel superior que contenga una instrucción se contraerá hasta que termine en la parte superior de un procedimiento u otra definición de nivel superior dentro del código.
Contraer todo el contenido de: <estructuras lógicas>	(Visual C++) Realiza la misma función que Contraer bloque, sólo que contrae de forma recursiva todas las estructuras lógicas incluidas en la función en un solo paso.

Crear secciones contraíbles de código en Visual C++

Para crear secciones contraíbles de código

Seleccione la sección deseada de código o texto.

Nota

Para habilitar el comando Ocultar selección, seleccione una secuencia continua de texto.
Haga clic con el botón secundario del mouse en la selección y elija Esquematización en el menú contextual.
Elija Ocultar selección en el submenú Esquematización.

La selección se contrae debajo de la línea de nivel superior seleccionada y aparece un signo más (+) en el margen indicador a la izquierda de la línea.

Para que se contraiga el código que va entre llaves

Haga clic con el botón secundario del mouse en el editor de código de una sección de código de Visual C++ que vaya entre llaves ("{}") y seleccione Esquematización en el menú contextual.
Elija Contraer bloque en el submenú Esquematización.

Un signo menos (-) aparece en el margen del indicador situado junto a la línea con la llave de apertura ("{"). Al seleccionar este signo, todas las líneas subsiguientes hasta la llave de cierre ("}") coincidente se contraen debajo de la línea de nivel superior de esta sección y aparece un signo más (+).

Nota

Esta opción se habilita cuando está programando en Visual C++.

Para crear estructuras lógicas incluidas entre llaves contraíbles

Haga clic con el botón secundario del mouse en el editor de código de una sección de código de Visual C++ que vaya entre llaves ("{}") con estructuras lógicas que también vayan entre llaves ("{}") y seleccione Esquematización en el menú contextual.
Elija Contraer todo el contenido de: <estructura lógica> en el submenú Esquematización.

Un signo menos (-) aparece en el margen del indicador situado junto a la llave de apertura ("{") de cada subsección de código que también vaya entre llaves. Al seleccionar este signo, todas las líneas subsiguientes hasta la llave de cierre ("}") coincidente se contraen debajo de la línea de nivel superior de la subsección y aparece un signo más (+).

Nota

Esta opción se habilita sólo cuando está programando en Visual C++.

Contraer y expandir código

Para contraer y expandir una sección de código

Para mostrar todas las líneas de una sección contraída, haga clic en el signo más (+) en el margen del indicador.
Para ocultar una sección expandida, haga clic en el signo menos (-) en el margen del indicador.

También puede utilizar los comandos Alternar expansión de esquematización o Alternar toda la esquematización para ocultar todas las secciones contraíbles o para que se vean todas ellas.

Para contraer y expandir varias secciones contraíbles de código

Seleccione secciones contiguas de código contraíble en el editor de código.
Haga clic con el botón secundario del mouse en la selección y elija Esquematización en el menú contextual.
Elija Alternar expansión de esquematización en el submenú Esquematización.

Si se expande alguna de las secciones seleccionadas, se contraen todas las secciones seleccionadas. Si se contraen todas las secciones seleccionadas, se expanden todas ellas.

Para contraer o expandir todas las secciones contraíbles de código

Haga clic con el botón secundario del mouse en el editor de código y elija Esquematización en el menú contextual.
Elija Alternar expansión de esquematización en el submenú Esquematización.

Si se contrae alguna de las secciones contraíbles, se expanden todas las secciones.

Si se expanden todas las secciones, se contraen todas ellas.

Para contraer todas las definiciones

Haga clic con el botón secundario del mouse en el editor de código y elija Esquematización en el menú contextual.
Elija Contraer a definiciones en el submenú Esquematización.

Se contraen todas las secciones contraíbles del módulo actual.

Esquematización automática

Los diversos lenguajes de desarrollo admiten un modo de edición en el que siempre está activada la esquematización automática. A medida que escribe las nuevas definiciones, el editor de código automáticamente crea las secciones contraíbles alrededor de los bloques del nuevo código. Una vez seleccionada la opción que habilita el modo de esquematización del lenguaje de desarrollo, los comandos están disponibles desde el menú contextual del editor de código que expandirá y contraerá las secciones seleccionadas, todas las definiciones y cada sección contraíble, así mismo activará y desactivará la esquematización automática.

Para crear secciones contraíbles de código automáticamente

Seleccione la opción que habilita el modo de esquematización del lenguaje en el que está programando.

Para obtener información adicional acerca de las opciones que habilitan la esquematización automática en lenguajes de programación concretos, vea Opciones específicas de VB, Basic, Editor de texto, Opciones (Cuadro de diálogo), Formato, C/C++, Editor de texto, Opciones (Cuadro de diálogo) y Formato, C#, Editor de texto, Opciones (Cuadro de diálogo).
Agregue un nuevo procedimiento, función, enumeración u otro bloque de código a su código.

Un signo menos (-) aparece en el margen del indicador situado junto al lado de la línea de nivel superior. Al seleccionar este signo, el código agregado se contrae debajo de la línea de nivel superior y aparece un símbolo de signo más (+).

Para desactivar la esquematización de una sección contraíble

Haga clic con el botón secundario del mouse en una sección contraíble del editor de código y elija Esquematización en el menú contextual.
Elija Detener ocultar actual.

La sección se expande y el signo menos (-) para contraerla ya no se muestra en el margen del indicador.

Para desactivar la esquematización automática y expandir todas las secciones contraídas

Haga clic con el botón secundario del mouse en el editor de código y elija Esquematización en el menú contextual.
Elija Detener esquematización.

Se expanden las secciones contraídas y ya no se mostrarán los signos menos (-) para contraer en el margen del indicador.

Para restaurar la esquematización automática y contraer todas las secciones expandidas

Haga clic con el botón secundario del mouse en el editor de código, y elija Esquematización en el menú contextual.
Elija Iniciar esquematización automática.

Se contraen todas las secciones contraíbles debajo de sus líneas de nivel superior y se muestran los signos más (+) para expandirlas en el margen del indicador.

Vea también