Name

GetObject Function

Class

Microsoft. VisualBasic.Interaction

Syntax

GetObject([pathname] [, class])
pathname

Use: Optional

Data Type: String

The full path and name of the file containing the COM (or ActiveX) object.

class

Use: Optional

Data Type: String

The class of the object. The class argument has these parts:

Appname

Use: Required

Data Type: String

The name of the application.

Objecttype

Use: Required

Data Type: String

The class of object to create, delimited from Appname by using a point (.). For example, Appname.Objecttype

Return Value

Returns a reference to an ActiveX object

Description

Accesses an ActiveX server held within a specified file

Rules at a Glance

  • Although both pathname and class are optional, at least one parameter must be supplied.

  • In situations where you cannot create a project-level reference to an ActiveX object, you can use the GetObject function to assign an object reference from an external ActiveX object to an object variable.

  • GetObject is used when there is a current instance of the ActiveX object; to create the instance, use the CreateObject function.

  • If you specify pathname as a zero-length string, GetObject will return a new instance of the object—unless the object is registered as single instance, in which case the current instance will be returned.

  • If you omit the pathname, the current instance of the object will be returned.

  • An error is generated if pathname is not specified and no current instance of the object can be found.

  • The object variable you will ...

Get VB .NET Language in a Nutshell now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.