XL2002: Using a Worksheet Function in a Visual Basic Macro (291309)



The information in this article applies to:

  • Microsoft Excel 2002

This article was previously published under Q291309
For a Microsoft Excel 2000 version of this article, see 213765.
For a Microsoft Excel 98 and earlier version of this article, see 161120.

SUMMARY

You can call most built-in Microsoft Excel worksheet functions directly from a Microsoft Visual Basic for Applications macro. This article describes how to use a built-in worksheet function in a macro.

MORE INFORMATION

Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific requirements.

Using a Worksheet Function

You can use most built-in worksheet functions in a macro by calling the function as a method of the Application object or the WorksheetFunction object. For example, to successfully call the ACOS worksheet function, you can use the following line of code in a macro:
X = WorksheetFunction.Acos(-1)
				
NOTE: If you attempt to use a built-in worksheet function without qualifying the function with the Application or WorksheetFunction object, you may receive the following error message:
Sub or Function Not Defined
Visual Basic for Applications provides many functions that are equivalent to the built-in worksheet functions in Microsoft Excel. However, not all of the built-in worksheet functions will work with the Application or WorksheetFunction objects. You cannot use a built-in worksheet function in a macro by calling the function as a method of the Application object or the WorksheetFunction object if there is an equivalent function in Visual Basic.

REFERENCES

For additional information about the worksheet functions that are notsupported with the Application or WorksheetFunction objects, click the article number below to view the article in the Microsoft Knowledge Base:

213660 XL: Not All Worksheet Functions Supported As Methods of Application Object

For more information about a complete list of the worksheet functions that you can call with the Application object, in the Visual Basic Editor, click Microsoft Visual Basic Help on the Help menu, type list of worksheet functions available to visual basic in the Office Assistant or the Answer Wizard, and then click Search to view the topic.

For more information about using Microsoft Excel Worksheet functions in Visual Basic, in the Visual Basic Editor, click Microsoft Visual Basic Help on the Help menu, type using Microsoft Excel worksheet functions in visual basic in the Office Assistant or the Answer Wizard, and then click Search to view the topic.

Modification Type:MinorLast Reviewed:10/11/2006
Keywords:kbdtacode kbhowto kbProgramming KB291309