Name
GetRef Function
Syntax
GetRef(procname)procnameUse: Required
Data Type: String
Name of a sub or function
Return Value
A Long containing a reference to
procname.
Description
Returns a reference to a sub or function. This reference can be used for such purposes as binding to events or defining callback functions.
Rules at a Glance
GetRef can be used whenever a function or procedure reference is expected.
When using GetRef to define event handlers for events, the
Setkeyword is required. For example, the code required to bind the Window.OnLoad event to a procedure named ShowGreetingDialog is:Set Window.OnLoad = GetRef("ShowGreetingDialog")
Example
<HTML>
<HEAD>
<TITLE>The VBScript GetRef Function</TITLE>
</HEAD>
<BODY>
<SCRIPT LANGUAGE="VBSCRIPT">
Set popWin = Window.CreatePopup( )
Set Window.Onload = GetRef("ShowPopup")
Sub ShowPopup( )
Set popBody = popWin.Document.Body
popBody.Style.BackgroundColor = "lightblue"
popBody.Style.Border = "solid black"
popBody.innerHTML = "Click outside <B>popup</B> to close."
popWin.Show 100, 100, 220, 30, Document.body
End Sub
</SCRIPT>
</BODY>
</HTML>Programming Tips and Gotchas
A common use of GetRef is to bind to DHTML events in Internet Explorer. You can use GetRef to bind to any of the events in the DHTML object model.
GetRef can be used to pass the address of a procedure to a routine that expects the address of a callback function as an argument.
VBA/VBScript Differences
The GetRef function is not supported by VBA. However, similar functionality is provided ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access