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 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)
