Cambiar la configuración de la vista mediante la API heredadoChanging View Settings by Using the Legacy API

Configuración de características del editor principal, como el ajuste automático de línea, el margen de selección y el espacio virtual, se puede modificar por el usuario por medio de la opciones cuadro de diálogo.Settings for core editor features, such as word wrap, selection margin, and virtual space, can be changed by the user by means of the Options dialog box. Sin embargo, también es posible cambiar esta configuración mediante programación.However, it is also possible to change these settings programmatically.

Cambiar la configuración mediante la API heredadoChanging Settings by Using the Legacy API

El IVsTextEditorPropertyCategoryContainer interfaz expone un conjunto de propiedades del editor de texto.The IVsTextEditorPropertyCategoryContainer interface exposes a set of text editor properties. La vista de texto contiene una categoría de propiedades (GUID_EditPropCategory_View_MasterSettings) que representa el grupo de configuración mediante programación modificada para la vista de texto.The text view contains a category of properties (GUID_EditPropCategory_View_MasterSettings) that represents the group of programmatically changed settings for the text view. Una vez que se cambiaron ver la configuración de esta manera, no se puede cambiar en el opciones cuadro de diálogo hasta que se restablecen.Once view settings have been changed in this way, they cannot be changed in the Options dialog box until they are reset.

Aquí te mostramos el proceso típico para cambiar la configuración de vista para una instancia del editor principal.Following is the typical process for changing view settings for an instance of the core editor.

  1. Llame a QueryInterface en el (VsTextView) para el IVsTextEditorPropertyCategoryContainer interfaz.Call QueryInterface on the (VsTextView) for the IVsTextEditorPropertyCategoryContainer interface.

  2. Llame a la GetPropertyCategory método, especificando un valor de GUID_EditPropCategory_View_MasterSettings para el rguidCategory parámetro.Call the GetPropertyCategory method, specifying a value of GUID_EditPropCategory_View_MasterSettings for the rguidCategory parameter.

    Esto devuelve un puntero a la IVsTextEditorPropertyCategoryContainer interfaz, que contiene el conjunto de propiedades forzadas para la vista.Doing this returns a pointer to the IVsTextEditorPropertyCategoryContainer interface, which contains the set of forced properties for the view. Cualquier configuración de este grupo de forma permanente se convierten obligatoriamente.Any settings in this group are permanently forced. Si una configuración no está en este grupo, se seguirá las opciones especificadas en el opciones cuadro de diálogo o los comandos del usuario.If a setting is not in this group, then it will follow the options specified in the Options dialog box or the user's commands.

  3. Llame a la SetProperty método, especificando el valor de la configuración adecuada en la idprop parámetro.Call the SetProperty method, specifying the appropriate settings value in the idprop parameter.

    Por ejemplo, para forzar ajuste automático de línea, llame a SetProperty y especifique un valor de VSEDITPROPID_ViewLangOpt_WordWrap, vt para el idprop parámetro.For example, to force word wrap, call SetProperty and specify a value of VSEDITPROPID_ViewLangOpt_WordWrap, vt for the idprop parameter. En esta llamada, vt es una variante del tipo VT_BOOL y vt.boolVal es VARIANT_TRUE.In this call, vt is a VARIANT of type VT_BOOL and vt.boolVal is VARIANT_TRUE.

Restablecer la configuración de vista modificadaResetting Changed View Settings

Para restablecer cualquier configuración para una instancia del editor principal de la vista modificada, llame a la RemoveProperty método y especifique el valor de configuración adecuado en el idprop parámetro.To reset any changed view setting for an instance of the core editor, call the RemoveProperty method and specify the appropriate setting value in the idprop parameter.

Por ejemplo, para permitir el ajuste de línea flotar libremente, se podría quitar de la categoría de propiedad llamando a RemoveProperty y especificando un valor de VSEDITPROPID_ViewLangOpt_WordWrap para el idprop parámetro.For example, to allow word wrap to float freely, you would remove it from the property category by calling RemoveProperty and specifying a value of VSEDITPROPID_ViewLangOpt_WordWrap for the idprop parameter.

Para quitar configuración de todos los modificada para el editor principal a la vez, especifique un valor de VSEDITPROPID_ViewComposite_AllCodeWindowDefaults, vt para el idprop parámetro.To remove all changed settings for the core editor at once, specify a value of VSEDITPROPID_ViewComposite_AllCodeWindowDefaults, vt for the idprop parameter. En esta llamada, vt es una variante del tipo VT_BOOL y vt.boolVal es VARIANT_TRUE.In this call, vt is a VARIANT of type VT_BOOL and vt.boolVal is VARIANT_TRUE.

Vea tambiénSee Also

Dentro del Editor de núcleo Inside the Core Editor
Obtener acceso a Text vista mediante la API heredado Accessing theText View by Using the Legacy API
Opciones (cuadro de diálogo)Options Dialog Box