Zobrazí výzvu v dialogovém okně, čeká na zadání textu nebo kliknutí na tlačítko a vrátí řetězec obsahující obsah textového pole.
Syntaxe
InputBox ( výzva [, název ] [ ,default ] [, xpos ] [, ypos ] [, helpfile ][, kontext ] )
Syntaxe funkce InputBox obsahuje následující 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ě 1 024 znaků v závislosti na šířce použitých znaků. Pokud se výzva skládá z více řádků, můžete řádky oddělit znakem návratu na řádek ( Chr(13)), znakem funkce linefeed(Chr(10)) nebo kombinaci znaků návrat na řádek - linefeed (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 vysídíte,název aplikace se umístí 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 výchozí hodnotu vyprázdníte,zobrazí se textové pole prázdné. |
|
xpos |
Nepovinný argument. Číselný výraz určující v twipech vodorovnou vzdálenost levého okraje dialogového okna od levého okraje obrazovky. Pokud xpos vypošlete, bude dialogové okno umístěno vodorovně na střed. |
|
ypos |
Nepovinný argument. Číselný výraz určující v twipech svislou vzdálenost horního okraje dialogového okna od horního okraje obrazovky. Pokud ypos vyjmete, bude dialogové okno svisle umístěné přibližně o jednu třetinu dolů po displeji. |
|
helpfile |
Nepovinný argument. Řetězcový výraz identifikující soubor nápovědy k poskytnutí kontextové nápovědy pro toto dialogové okno. Pokud je nápověda k dispozici, musí se poskytnuta také kontext. |
|
kontext |
Nepovinný argument. Číselný výraz, který je číslem kontextu nápovědy přiřazeným příslušnému tématu nápovědy autorem. Pokud je kontext k dispozici, musí být také k dispozici helpfile. |
Poznámky
Pokud je k dispozici nápověda i kontext, může uživatel stisknutím kláves F1 (Windows) nebo HELP (Macintosh) zobrazit téma nápovědy odpovídající příslušnému kontextu. Některé Hostitelská aplikace, například Microsoft Office Excel 2007, také automaticky přidávají do dialogového okna tlačítko Nápověda. Pokud uživatel klikne na OK nebo stiskne klávesu ENTER, vrátí funkce InputBox, co v textovém poli je. Pokud uživatel klikne na tlačítko Zrušit,vrátí funkce řetězec nulové délky ("").
Poznámka: Pokud chcete zadat víc než první pojmenovaný argument, musíte v textovém poli Výraz. Pokud chcete některé argumenty pozice vynechat, je nutné zahrnovat odpovídající oddělovač.
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ě k zadání hodnoty uživatele. Pokud umístění x a y vyjmete, dialog se automaticky umístí na střed příslušné osy. Proměnná MyValue obsahuje hodnotu zadanou uživatelem v případě, že 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)
