O'Reilly logo

VBScript in a Nutshell by Ron Petrusha, Paul Lomax, Matt Childs

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Name

MsgBox Function

Syntax

MsgBox(prompt[, buttons][, title][, helpfile, context])
prompt

Use: Required

Data Subtype: String

The text of the message to display in the message box dialog.

buttons

Use: Optional

Data Subtype: Numeric

The sum of the Button, Icon, Default Button, and Modality constant values.

title

Use: Optional

Data Subtype: String

The title displayed in the titlebar of the message box dialog.

helpfile

Use: Optional

Data Subtype: String

An expression specifying the name of the help file to provide help functionality for the dialog.

context

Use: Optional

Data Subtype: Numeric

An expression specifying a context ID within helpfile.

Return Value

A Variant of subtype Integer indicating the button clicked by the user.

Description

Displays a dialog box containing a message, buttons, and optional icon to the user. The action taken by the user is returned by the function as an integer value.

Rules at a Glance

  • prompt can contain approximately 1,000 characters, including carriage return characters such as the built-in vbCrLf constant.

  • In order to divide prompt onto multiple lines, you can use any of the vbCr, vbLf, vbCrLf, or vbNewLine constants. For example:

    SMsg = "This is line 1" & vbCrLf & _
    "This is line 2"
  • If the title parameter is omitted, the text of title depends on the type of script being executed, as the following table shows:

    Script Type

    Caption

    ASP script

    not applicable

    IE script

    “VBScript”

    Outlook form

    “VBScript”

    WSH script

    “VBScript”

  • If the helpfile parameter is provided, ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required