Cambiar la configuración de vista mediante el uso de la API heredadaChange view settings by using the legacy API

Configuración de las características del editor de núcleo, como el ajuste de palabra, margen de selección y el espacio virtual, puede cambiarse 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 el uso de la API heredadaChange 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 la configuración de la vista se han cambiado en este modo, no puede cambiarse 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.

Siguiente es el proceso típico para cambiar la configuración de vista para una instancia del editor de núcleo.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 de la vista.Doing this returns a pointer to the IVsTextEditorPropertyCategoryContainer interface, which contains the set of forced properties for the view. Permanentemente se fuerza la cualquier configuración de este grupo.Any settings in this group are permanently forced. Si una configuración no está en este grupo, 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 el idprop parámetro.Call the SetProperty method, specifying the appropriate settings value in the idprop parameter.

    Por ejemplo, para forzar ajuste, llamar 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 de 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.

Configuración de la vista de restablecimiento cambiadoReset changed view settings

Para restablecer cualquier vista modificada para una instancia del editor de núcleo, llame a la RemoveProperty método y especificar el valor de la configuración adecuada 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, lo haría quita de la categoría de propiedad mediante una llamada 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 la configuración de todo esto cambió para el editor básico 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 de 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
Vista de acceso a Text mediante el uso de la API heredada Access theText view by using the legacy API
Opciones (cuadro de diálogo)Options Dialog Box