Método Scenarios.Add (Excel)Scenarios.Add method (Excel)

Cria um novo cenário e o adiciona à lista de cenários disponíveis para a planilha atual.Creates a new scenario and adds it to the list of scenarios that are available for the current worksheet.

SintaxeSyntax

expression.expression. Add( _Name_ , _ChangingCells_ , _Values_ , _Comment_ , _Locked_ , _Hidden_ )

expressão Uma variável que representa um objeto Scenarios .expression A variable that represents a Scenarios object.

ParâmetrosParameters

NomeName Obrigatório/OpcionalRequired/Optional Tipo de dadosData type DescriçãoDescription
NameName ObrigatórioRequired StringString O nome do cenário.The scenario name.
ChangingCellsChangingCells ObrigatórioRequired VariantVariant Um objeto Range que se refere às células variáveis do cenário.A Range object that refers to the changing cells for the scenario.
ValoresValues OpcionalOptional VariantVariant Uma matriz que contém os valores de cenário para as células em ChangingCells.An array that contains the scenario values for the cells in ChangingCells. Se esse argumento for omitido, presume-se que os valores de cenário são os valores atuais das células em ChangingCells.If this argument is omitted, the scenario values are assumed to be the current values in the cells in ChangingCells.
CommentComment OpcionalOptional VariantVariant Uma cadeia de caracteres que especifica o texto de comentário para o cenário.A string that specifies comment text for the scenario. Quando um novo cenário é adicionado, nome do autor e a data são adicionados automaticamente no início do texto do comentário.When a new scenario is added, the author's name and date are automatically added at the beginning of the comment text.
LockedLocked OpcionalOptional VariantVariant True para bloquear o cenário para impedir alterações.True to lock the scenario to prevent changes. O valor padrão é True.The default value is True.
OcultoHidden OpcionalOptional VariantVariant True para ocultar o cenário.True to hide the scenario. O valor padrão é False.The default value is False.

Valor de retornoReturn value

Um objeto Scenario que representa o novo cenário.A Scenario object that represents the new scenario.

ComentáriosRemarks

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.A scenario name must be unique; Microsoft Excel generates an error if you try to create a scenario with a name that's already in use.

ExemploExample

Este exemplo adiciona um novo cenário a Sheet1.This example adds a new scenario to Sheet1.

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

Confira tambémSee also

Objeto ScenariosScenarios Object