Office.SettingsChangedEventArgs interface
Fornece informações sobre as configurações que geraram o evento settingsChanged.
Para adicionar um processador de eventos para o evento settingsChanged, utilize o método addHandlerAsync do objeto Office.Settings .
O evento settingsChanged é acionado apenas quando o script do suplemento chama o método Settings.saveAsync para manter a cópia dentro da memória das definições no ficheiro de documento. O evento settingsChanged não é disparado quando os métodos Settings.set ou Settings.remove são chamados.
O evento settingsChanged foi concebido para lhe permitir lidar com potenciais conflitos quando dois ou mais utilizadores estão a tentar guardar as definições ao mesmo tempo que o suplemento é utilizado num documento partilhado (cocriado).
Importante: o código do suplemento pode registar um processador para o evento SettingsChanged quando o suplemento está em execução com qualquer cliente do Excel, mas o evento só será acionado quando o suplemento for carregado com uma folha de cálculo aberta no Excel na Web e mais do que um utilizador estiver a editar a folha de cálculo (cocriação). Por conseguinte, efetivamente, o evento settingsChanged só é suportado em Excel na Web em cenários de cocriação.
Propriedades
| settings | Obtém um objeto Office.Settings que representa as definições que geraram o evento SettingsChanged. |
| type | Obtenha um valor de enumeração Office.EventType que identifique o tipo de evento que foi gerado. |
Detalhes da propriedade
settings
Obtém um objeto Office.Settings que representa as definições que geraram o evento SettingsChanged.
settings: Settings;Valor da propriedade
type
Obtenha um valor de enumeração Office.EventType que identifique o tipo de evento que foi gerado.
type: EventType;