Evaluate Method

         Example         Applies To

Converts a Microsoft Excel name to an object or a value.

Syntax

expression.Evaluate(Name)

expression   Optional for Application, required for Chart, DialogSheet, and Worksheet. An expression that returns an object in the Applies To list.

Name   Required String. The name of the object, using the naming convention of Microsoft Excel.

Remarks

The following types of names in Microsoft Excel can be used with this method:

• A1-style references. You can use any reference to a single cell in A1-style notation. All references are considered to be absolute references.
  
  
• Ranges. You can use the range, intersect, and union operators (colon, space, and comma, respectively) with references.
  
  
• Defined names. You can specify any name in the language of the macro.
  
  
• External references. You can use the ! operator to refer to a cell or to a name defined in another workbook — for example, Evaluate("[BOOK1.XLS]Sheet1!A1").

Note   Using square brackets (for example, "[A1:C5]") is identical to calling the Evaluate method with a string argument. For example, the following expression pairs are equivalent.

[a1].Value = 25
Evaluate("A1").Value = 25

trigVariable = [SIN(45)]
trigVariable = Evaluate("SIN(45)")

Set firstCellInSheet = Workbooks("BOOK1.XLS").Sheets(4).[A1]
Set firstCellInSheet = _
    Workbooks("BOOK1.XLS").Sheets(4).Evaluate("A1")

The advantage of using square brackets is that the code is shorter. The advantage of using Evaluate is that the argument is a string, so you can either construct the string in your code or use a Visual Basic variable.