Método Scenarios.Add (Excel)

Cria um novo cenário e o adiciona à lista de cenários disponíveis para a planilha atual.

Sintaxe

expressão. Adicionar (Nome, ChangingCells, Valores, Comentário, Bloqueado, Oculto)

Expressão Uma variável que representa um objeto Scenarios .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Name	Obrigatório	String	O nome do cenário.
ChangingCells	Obrigatório	Variantes	Um objeto Range que se refere às células em alteração para o cenário.
Valores	Opcional	Variantes	Uma matriz que contém os valores de cenário para as células em ChangingCells. Se esse argumento for omitido, os valores de cenário serão considerados os valores atuais nas células em ChangingCells.
Comentário	Opcional	Variantes	Uma sequência de caracteres que especifica o texto de comentário para o cenário. Quando um novo cenário é adicionado, o nome do autor e a data são adicionados automaticamente no início do texto de comentário.
Locked	Opcional	Variantes	True para bloquear o cenário e evitar alterações. O valor padrão é True.
Oculto	Opcional	Variantes	True para ocultar o cenário. O valor padrão é False.

Valor de retorno

Um objeto Scenario que representa o novo cenário.

Comentários

Um nome de cenário precisa ser exclusivo; o Microsoft Excel gerará um erro se você tentar criar um cenário com um nome que já esteja em uso.

Exemplo

Este exemplo adiciona um novo cenário a Sheet1.

Worksheets("Sheet1").Scenarios.Add Name:="Best Case", _ 
 ChangingCells:=Worksheets("Sheet1").Range("A1:A4"), _ 
 Values:=Array(23, 5, 6, 21), _ 
 Comment:="Most favorable outcome."

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.