Scenarios.Add method (Excel)

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

Sintaxe

expressão. Adicionar (Nome, Alterar Células, Valores, Comentário, Bloqueado, Oculto)

expressão Uma variável que representa um objeto Cenários .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Name	Obrigatório	String	O nome do cenário.
ChangingCells	Obrigatório	Variant	Um objeto Intervalo que se refere às células em mudança para o cenário.
Valores	Opcional	Variant	Uma matriz que contém os valores de cenário para as células em ChangingCells. Se este argumento for omitido, presume-se que os valores do cenário são os valores atuais nas células em ChangingCells.
Comentário	Opcional	Variant	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	Variant	True para bloquear o cenário e evitar alterações. O valor padrão é True.
Oculto	Opcional	Variant	True para ocultar o cenário. O valor padrão é False.

Valor de retorno

Um objeto cenário 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.