توابع MsgBox در VBScript

دستورالعمل‌های مرجع فراموشی VBScript

تعریف و استفاده

توابع MsgBox می‌تواند یک پنجره‌ی پیام نشان دهد، منتظر کلیک کاربر بر روی یکی از دکمه‌ها است و سپس مقادیری که نشان‌دهنده‌ی دکمه‌ی فشرده شده است را بازگرداند.

توابع MsgBox می‌تواند مقادیر زیر را بازگرداند:

  • 1 = vbOK - دکمه‌ی تایید فشرده شده است.
  • 2 = vbCancel - دکمه‌ی لغو فشرده شده است.
  • 3 = vbAbort - دکمه‌ی پایان فشرده شده است.
  • 4 = vbRetry - دکمه تلاش کلیک شده است.
  • 5 = vbIgnore - دکمه نادیده‌گیری کلیک شده است.
  • 6 = vbYes - دکمه بله کلیک شده است.
  • 7 = vbNo - دکمه خیر کلیک شده است.

نکته:وقتی که پارامترهای helpfile و context مشخص شده باشند، کاربر می‌تواند با فشار دادن کلید F1 به کمکگاه نگاه کند.

توجه:لطفاً به Function InputBox مراجعه کنید.

جمله‌بندی

MsgBox(prompt[,buttons][,title][,helpfile,context])
پارامترها توضیح
prompt ضروری. عبارت رشته‌ای که در دیالوگ نمایش داده می‌شود. طول بیشینه prompt حدود 1024 کاراکتر است و بستگی به عرض کاراکترها دارد. اگر prompt شامل چند خط باشد، می‌توان خطوط را با کاراکترهای بازگشت به خط (Chr(13))، خط جدید (Chr(10)) یا ترکیب آن‌ها (Chr(13) & Chr(10)) از یکدیگر جدا کرد.
buttons

عبارت عددی، مجموع تعداد دکمه‌های نمایش داده شده و نوع آن‌ها، سبک آیکون‌ها، شناسه دکمه پیش‌فرض و سبک پیام‌های دایرگه است. اگر省ت شود، مقدار پیش‌فرض buttons برابر با 0 خواهد بود.

مقدار دکمه:

  • 0 = vbOKOnly - تنها نمایش دکمه تایید.
  • 1 = vbOKCancel - نمایش دکمه‌های تایید و لغو.
  • 2 = vbAbortRetryIgnore - نمایش دکمه‌های کناره‌گیری، تلاش و نادیده‌گیری.
  • 3 = vbYesNoCancel - نمایش دکمه‌های بله، خیر و لغو.
  • 4 = vbYesNo - نمایش دکمه‌های بله و خیر.
  • 5 = vbRetryCancel - نمایش دکمه‌های تلاش و لغو.
  • 16 = vbCritical - نمایش آیکون اطلاعیه بحرانی.
  • 32 = vbQuestion - نمایش آیکون سوال هشدار.
  • 48 = vbExclamation - نمایش آیکون پیام هشدار.
  • 64 = vbInformation - نمایش آیکون پیام اطلاعاتی.
  • 0 = vbDefaultButton1 - دکمه اول به عنوان دکمه پیش‌فرض است.
  • 256 = vbDefaultButton2 - دکمه دوم به عنوان دکمه پیش‌فرض است.
  • 512 = vbDefaultButton3 - دکمه سوم به عنوان دکمه پیش‌فرض است.
  • 768 = vbDefaultButton4 - دکمه چهارم به عنوان دکمه پیش‌فرض است.
  • 0 = vbApplicationModal - حالت برنامه: کاربر باید به پیام‌های دایرگه پاسخ دهد تا بتواند در برنامه فعلی کار کند.
  • 4096 = vbSystemModal - حالت سیستم: در حالی که کاربر به پیام‌دانی پاسخ نمی‌دهد، تمام برنامه‌ها معلق می‌شوند.

گروه اول از مقادیر (0 - 5) برای توصیف نوع و تعداد دکمه‌هایی که در دیالوگ نمایش داده می‌شود استفاده می‌شود؛ گروه دوم از مقادیر (16, 32, 48, 64) برای توصیف سبک آیکون استفاده می‌شود؛ گروه سوم از مقادیر (0, 256, 512) برای تعیین دکمه پیش‌فرض استفاده می‌شود؛ و گروه چهارم از مقادیر (0, 4096) برای تعیین سبک پیام‌دانی استفاده می‌شود. هنگام جمع‌آوری این اعداد برای تولید مقادیر parameters buttons، تنها یک عدد از هر گروه می‌توان استفاده کرد.
title عبارت رشته‌ای که در نوار عنوان نوار دیالوگ نمایش داده می‌شود. اگر title حذف شود، نام برنامه در نوار عنوان نمایش داده می‌شود.
helpfile عبارت رشته‌ای، برای شناسایی دستورالعمل کمک مرتبط با محیط برای دیالوگ استفاده می‌شود. اگر دستورالعمل helpfile ارائه شده باشد، باید دستورالعمل context ارائه شود. در سیستم‌های 16 بیتی در دسترس نیست.
context عبارت عددی، برای شناسایی شماره‌ی محیط که نویسنده‌ی دستورالعمل به موضوع کمک اختصاص داده است. اگر محیط ارائه شده باشد، باید دستورالعمل helpfile ارائه شود. در سیستم‌های 16 بیتی در دسترس نیست.

مثال

dim answer
answer=MsgBox("Hello everyone!",65,"Example")
document.write(answer)

دستورالعمل‌های مرجع فراموشی VBScript