Promotic
WikipediaLinkedInYoutubeTwitterFacebook

MsgBox - funkce jazyka VBScript

Popis:
Zobrazí zprávu v okně a čeká na kliknutí uživatelem na tlačítko.

Pro potřeby systému PROMOTIC je vhodnější použít metodu: Pm.MessageBox.

Syntaxe:
MsgBox(prompt As String, [buttons As Integer], [title As String], [helpfile As String], [context As Integer]) As String
Volání:
s = MsgBox(prompt[, buttons][, title][, helpfile, context])
Parametry:
prompt(String) Text, který je zobrazen v okně. Maximální délka textu je 1024 znaků. Pokud má být text složen z více řádků, lze na jejich rozdělení použít konstanty vbCr, vbLf nebo vbCrLf.
buttons[nepovinné] (Integer) Součet čísel (konstant) odpovídající tlačítkům, druhu okna, implicitního tlačítka a způsobu chování aplikace. Když je parametr vynechán, pak implicitní hodnota je vbOKOnly.
vbOKOnly - Zobrazit pouze tlačítko OK
vbOKCancel - Zobrazit tlačítka OK a Storno
vbAbortRetryIgnore - Zobrazit tlačítka ABORT, RETRY a IGNORE
vbYesNoCancel - Zobrazit tlačítka YES, NO a Storno
vbYesNo - Zobrazit tlačítka YES a NO
vbRetryCancel - Zobrazit tlačítka RETRY a Storno
vbCritical - Zobrazit ikonu "Kritická zpráva"
vbQuestion - Zobrazit ikonu "Dotaz varování"
vbExclamation - Zobrazit ikonu "Varování"
vbInformation - Zobrazit ikonu "Varování"
vbDefaultButton1 - 1.tlačítko je implicitně nastaveno
vbDefaultButton2 - 2.tlačítko je implicitně nastaveno
vbDefaultButton3 - 3.tlačítko je implicitně nastaveno
vbDefaultButton4 - 4.tlačítko je implicitně nastaveno
vbApplicationModal - Režim Application modal. Pokud chce uživatel pokračovat v aktivitách v dané aplikaci, musí zareagovat na zprávu zobrazenou v okně.
vbSystemModal - Režim System modal. Dokud nezareaguje uživatel na zprávu zobrazenou v okně, budou všechny aplikace pozastaveny.
title[nepovinné] (String) Řetězec zobrazený v záhlaví okna. Pokud je parametr vynechán, v záhlaví bude zobrazen název aplikace.
helpfile[nepovinné] (String) Cesta k souboru nápovědy, který bude využit v okně. Pokud je parametr zadán, musí být také zadán parametr context.
context[nepovinné] (Integer) Číslo tématu nápovědy ze souboru nápovědy. Pokud je parametr zadán, musí být také zadán parametr helpfile.
Vrácená hodnota:
Vrací hodnotu odpovídající stisknutému tlačítku. Hodnoty odpovídají následujícím konstantám:
vbOK - Stisknuto tlačítko OK
vbCancel - Stisknuto tlačítko Storno
vbAbort - Stisknuto tlačítko ABORT (ZRUŠIT)
vbRetry - Stisknuto tlačítko RETRY (OPAKOVAT)
vbIgnore - Stisknuto tlačítko IGNORE (IGNOROVAT)
vbYes - Stisknuto tlačítko YES (ANO)
vbNo - Stisknuto tlačítko NO (NE)
Poznámka:

Jestliže jsou zadány argumenty helpfile a context, v okně je automaticky zobrazeno tlačítko Nápověda.

Jestliže je v okně tlačítko Storno, stisk klávesy Esc má stejný efekt jako kliknutí na Storno.

Příklad:
Následující příklad zobrazí informační okno s tlačítky OK a Storno. Funkce vrací hodnotu vbOK nebo vbCancel v závislosti na stisknutém tlačítku.
If vbOK = MsgBox("Hello World!", vbOKCancel+vbInformation, "MsgBox Example") Then ...
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice