Zobrazenie výzvy v dialógovom okne, čakanie, kým používateľ zadá text alebo klikne na tlačidlo, a vrátenie reťazca s obsahom textového poľa.
Syntax
InputBox(výzva [, názov ] [, predvolené ] [, xpos ] [, ypos ] [, súbor pomocníka ] [, kontext ] )
Syntax funkcie InputBox má tieto argumenty:
| Argument | Popis |
|---|---|
| výzva | Povinný argument. Reťazcový výraz, ktorý sa zobrazí ako správa v dialógovom okne. Maximálna dĺžka výzvy je približne 1 024 znakov, v závislosti od šírky použitých znakov. Ak výzva pozostáva z viacerých riadkov, môžete ich oddeliť znakom konca riadka (Chr(13)), znakom posunu riadka (Chr(10)) alebo kombináciou znakov zakončenia riadka a posunu riadka (Chr(13) & Chr(10)) medzi jednotlivými riadkami. |
| názov | Voliteľný argument. Reťazcový výraz, ktorý sa zobrazí v záhlaví dialógového okna. Ak názov nezadáte, v záhlaví okna sa umiestní názov aplikácie. |
| predvolená hodnota | Voliteľný argument. Reťazcový výraz, ktorý sa zobrazí v textovom poli ako predvolená odpoveď, ak nie je k dispozícii iná vstupná hodnota. Ak vynecháte predvolené hodnotenie, zobrazené textové pole bude prázdne. |
| pozx | Voliteľný argument. Číselný výraz, ktorý v dvanástinách bodov určuje vodorovnú vzdialenosť medzi ľavým okrajom dialógového okna a ľavým okrajom obrazovky. Ak sa argument xpos vynechá, dialógové okno sa vyrovná na stred vo vodorovnom smere. |
| pozy | Voliteľný argument. Číselný výraz, ktorý v dvanástinách bodov určuje zvislú vzdialenosť medzi horným okrajom dialógového okna a horným okrajom obrazovky. Ak sa argument pozy vynechá , dialógové okno sa vo zvislom smere umiestni približne v jednej tretine vzdialenosti od dolného okraja obrazovky. |
| súbor pomocníka | Voliteľný argument. Reťazcový výraz identifikujúci súbor Pomocníka, ktorý sa používa na poskytovanie kontextového Pomocníka pre dialógové okno. Ak je k dispozícii súbor pomocníka , musí byť poskytnutý aj kontext . |
| kontext | Voliteľný argument. Numerický výraz, ktorý je kontextovým číslom Pomocníka, ktoré priradil autor Pomocníka príslušnej téme Pomocníka. Ak je k dispozícii kontext , musí sa poskytnúť aj súbor pomocníka . |
Poznámky:
Ak je k dispozícii súbor pomocníka aj kontext , používateľ môže stlačením klávesu F1 (Windows) alebo POMOCNÍKA (Macintosh) zobraziť tému Pomocníka zodpovedajúcu kontextu. Niektoré hostiteľské aplikácie tiež automaticky pridajú do dialógového okna tlačidlo Pomocník . Ak používateľ klikne na tlačidlo OK alebo stlačí kláves ENTER, funkcia InputBox vráti všetko, čo sa nachádza v textovom poli. Ak používateľ klikne na tlačidlo Zrušiť, funkcia vráti reťazec s nulovou dĺžkou ("").
Poznámka
Ak chcete zadať viac ako prvý pomenovaný argument, musíte vo výraze použiť pole InputBox . Ak chcete vynechať niektoré pozičné argumenty, musíte zadať príslušný oddeľovač vo forme čiarky.
Príklad
Poznámka
Nasledujúce príklady ukazujú použitie tejto funkcie v module jazyka Visual Basic for Applications (VBA). Ak chcete získať ďalšie informácie o práci s jazykom VBA, vyberte z rozbaľovacieho zoznamu vedľa položky Hľadať možnosť Odkaz pre vývojára a do vyhľadávacieho poľa zadajte nejaké výrazy.
Na tomto príklade sú znázornené rôzne spôsoby použitia funkcie InputBox na vyzvanie používateľa na zadanie hodnoty. Ak sa pozície x a y vynechajú, dialógové okno sa automaticky umiestni do stredu príslušných osí. Premenná MyValue obsahuje hodnotu, ktorú používateľ zadá, ak klikne na tlačidlo OK alebo stlačí kláves ENTER. Ak používateľ klikne na tlačidlo Zrušiť, vráti sa reťazec s nulovou dĺžkou ("").
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)