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 [; title ] [; default ] [; xpos ] [, ypos ] [, helpfile ] [, context ] )
Syntaxe funkce InputBox má 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 řádku (Chr(13)), znaku kanálu řádku (Chr(10)) nebo kombinace znaků návratu na řádek (Chr(13) & Chr(10)) mezi jednotlivými řádky. |
Název |
Nepovinný argument. Řetězcový výraz zobrazený v záhlaví dialogového okna Pokud název vynecháte, název aplikace se umístí do záhlaví. |
výchozí |
Nepovinný argument. Řetězcový výraz se zobrazí v textovém poli jako výchozí odpověď, pokud není zadaný žádný jiný vstup. Pokud vynecháte výchozí, textové pole se zobrazí prázdné. |
xpos |
Nepovinný argument. Číselný výraz, který v twipech určuje vodorovnou vzdálenost levého okraje dialogového okna od levého okraje obrazovky. Pokud xpos vynecháte, bude dialogové okno vodorovně zarovnané na střed. |
ypos |
Nepovinný argument. Číselný výraz, který v twipech určuje svislou vzdálenost horního okraje dialogového okna od horního okraje obrazovky. Pokud je ypos vynechán, je dialogové okno umístěné svisle přibližně o třetinu směrem dolů na obrazovce. |
Helpfile |
Nepovinný argument. Řetězcový výraz, který identifikuje soubor nápovědy, který se má použít k poskytnutí kontextové nápovědy pro dialogové okno. Pokud je k dispozici soubor nápovědy , je nutné zadat také kontext . |
Kontextu |
Nepovinný argument. Číselný výraz, který je číslem kontextu nápovědy, které autor nápovědy přiřadil příslušnému tématu nápovědy. Pokud je zadaný kontext , musí být k dispozici také soubor nápovědy . |
Poznámky
Po zadání souboru nápovědy i kontextu může uživatel stisknutím klávesy F1 (Windows) nebo HELP (Macintosh) zobrazit téma nápovědy odpovídající kontextu. Některé Hostitelská aplikace, například Microsoft Office Excel 2007, také automaticky přidají do dialogového okna tlačítko Nápověda . Pokud uživatel klikne na OK nebo stiskne enter , vrátí funkce InputBox vše, co je v textovém poli. Pokud uživatel klikne na Tlačítko Storno, vrátí funkce řetězec nulové délky ("").
Poznámka: Chcete-li zadat více než první pojmenovaný argument, musíte použít InputBox v Výraz. Chcete-li vynechat některé poziční argumenty, musíte zahrnout odpovídající oddělovač čárky.
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 použití funkce InputBox k výzvě uživatele k zadání hodnoty. Pokud jsou vynechány pozice x a y, dialogové okno se automaticky zacentruje 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)