Zobrazí výzvu v dialogovém okně, počká, až uživatel zadá text nebo klikne na tlačítko, a vrátí řetězec obsahující obsah textového pole.
Syntaxe
InputBox(prompt [, nadpis ] [, výchozí ] [, xpos ] [, ypos ] [, soubor nápovědy ] [, kontext ] )
Syntaxe funkce InputBox obsahuje tyto argumenty:
| Argument | Popis |
|---|---|
| výzva | Povinný argument. Řetězcový výraz zobrazený jako zpráva v dialogovém okně. Maximální délka výzvy je přibližně 1024 znaků v závislosti na šířce použitých znaků. Pokud se výzva skládá z více než jednoho řádku, můžete řádky oddělit pomocí znaku návratu na začátek řádku (Chr(13)), znaku odřádkování (Chr(10)) nebo kombinace znaků návratu na začátek řádku a řádku (Chr(13) & Chr(10)) mezi jednotlivými řádky. |
| Nadpis | Nepovinný argument. Řetězcový výraz zobrazený v záhlaví dialogového okna Pokud název vynecháte, umístí se název aplikace do záhlaví. |
| výchozí | Nepovinný argument. Řetězcový výraz zobrazený v textovém poli jako výchozí odpověď pokud není zadaný žádný jiný vstup. Pokud toto pole vynecháte, zobrazí se textové pole prázdné. |
| XPOS | Nepovinný argument. Číselný výraz, který určuje vodorovnou vzdálenost levého okraje dialogového okna od levého okraje obrazovky. Pokud tento argument XPOS vynecháte, bude dialogové okno vodorovně zarovnáno na střed. |
| ypos | Nepovinný argument. Číselný výraz, který určuje svislou vzdálenost horního okraje dialogového okna od horního okraje obrazovky. Pokud ypos vynecháte, je dialogové okno umístěno svisle přibližně v jedné třetině obrazovky směrem dolů. |
| soubor nápovědy | Nepovinný argument. Řetězcový výraz určující soubor nápovědy, který se má použít k poskytnutí kontextové nápovědy k dialogovému oknu. Pokud je poskytnut soubor nápovědy , musí být také poskytnut kontext . |
| Souvislosti | Nepovinný argument. Číselný výraz představující kontextové číslo nápovědy přiřazené příslušnému tématu nápovědy autorem nápovědy. Pokud je poskytnut kontext , musí být také poskytnut soubor nápovědy . |
Poznámky
Pokud je k dispozici soubor nápovědy i kontext , může uživatel stisknutím klávesy F1 (Windows) nebo NÁPOVĚDY (Macintosh) zobrazit téma nápovědy odpovídající kontextu. Některé hostitelské aplikace také do dialogového okna automaticky přidají tlačítko Nápověda . Pokud uživatel klikne na OK nebo stiskne ENTER, funkce InputBox vrátí všechno, co je v textovém poli. Pokud uživatel klikne na Zrušit, vrátí funkce řetězec nulové délky ("").
Poznámka
Pokud chcete zadat více než první pojmenovaný argument, musíte použít InputBox ve výrazu. Pokud chcete některé poziční argumenty vynechat, musíte použít odpovídající oddělovač čárek.
Příklad
Poznámka
Následující příklady ukazují použití této funkce v modulu VBA (Visual Basic pro Applications). Pokud chcete další informace o práci s modulem VBA, vyberte Referenční informace pro vývojáře, které najdete v rozevíracím seznamu vedle položky Hledat a do vyhledávacího pole napište požadované pojmy.
Tento příklad ukazuje různé způsoby, jak pomocí funkce InputBox vyzvat uživatele k zadání hodnoty. Pokud jsou pozice x a y vynechány, dialogové okno se automaticky zarovná na střed pro příslušné osy. Proměnná MyValue obsahuje hodnotu zadanou uživatelem, pokud uživatel klikne na OK nebo stiskne klávesu ENTER . Pokud uživatel klikne na Zrušit, vrátí se řetězec nulové délky.
Dim Message, Title, Default, MyValue
Message = "Enter a value between 1 and 3" ' Set prompt.
Title = "InputBox Demo" ' Set title.
Default = "1" ' Set default.
' Display message, title, and default value.
MyValue = InputBox(Message, Title, Default)
' Use Helpfile and context.
' The Help button is added automatically.
MyValue = InputBox(Message, Title,,,,"DEMO.HLP", 10)
' Display dialog box at position 100, 100.
MyValue = InputBox(Message, Title, Default, 100, 100)