Office.SettingsChangedEventArgs interface
Proporciona información sobre la configuración que generó el evento settingsChanged.
Para agregar un controlador de eventos para el evento settingsChanged, use el método addHandlerAsync del objeto Office.Settings .
El evento settingsChanged se desencadena solo cuando el script del complemento llama al método Settings.saveAsync para conservar la copia en memoria de la configuración en el archivo de documento. El evento settingsChanged no se desencadena cuando se llama a los métodos Settings.set o Settings.remove.
El evento settingsChanged se diseñó para permitirle controlar posibles conflictos cuando dos o más usuarios intentan guardar la configuración al mismo tiempo cuando el complemento se usa en un documento compartido (coautor).
Importante: El código del complemento puede registrar un controlador para el evento settingsChanged cuando el complemento se ejecuta con cualquier cliente de Excel, pero el evento se desencadenará solo cuando el complemento se cargue con una hoja de cálculo que se abra en Excel en la Web y más de un usuario edite la hoja de cálculo (coautoría). Por lo tanto, de forma eficaz, el evento settingsChanged solo se admite en Excel en la Web en escenarios de coautoría.
Propiedades
| settings | Obtiene un objeto Office.Settings que representa la configuración que generó el evento settingsChanged. |
| type | Obtenga un valor de enumeración Office.EventType que identifique el tipo de evento que se generó. |
Detalles de las propiedades
settings
Obtiene un objeto Office.Settings que representa la configuración que generó el evento settingsChanged.
settings: Settings;Valor de propiedad
type
Obtenga un valor de enumeración Office.EventType que identifique el tipo de evento que se generó.
type: EventType;