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.