Método Scenarios.Add (Excel)

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

Sintaxe

mais simples. 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 Variant Um objeto Range que se refere às células variáveis para o cenário.
Valores Opcional Variant Uma matriz que contém os valores de cenário para as células em ChangingCells. Se esse argumento for omitido, os valores do cenário serão considerados 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 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.

  • Last updated on