Wyświetla monit w oknie dialogowym, czeka na wprowadzenie tekstu przez użytkownika lub kliknięcie przycisku i zwraca ciąg zawierający zawartość pola tekstowego.
Składnia
InputBox ( prompt [ ,title ] [ ,default ] [, xpos ] [, ypos ] [, helpfile ] [ ,kontekst ] )
W składni funkcji InputBox występują następujące argumenty:
|
Argument |
Opis |
|
monituj |
Argument wymagany. Wyrażenie ciągu wyświetlane jako komunikat w oknie dialogowym. Maksymalna długość monitu wynosi około 1024 znaków, w zależności od szerokości używanych znaków. Jeśli wiersz monitu składa się z więcej niż jednego wiersza, można oddzielić wiersze za pomocą znaku powrotu karetki (Chr(13), znaku kanału liniowego (Chr(10 ))lub połączenia znaków powrotu karetki - linefeed (Chr(13) & Chr(10)) między poszczególnymi wierszami. |
|
tytuł |
Argument opcjonalny. Wyrażenie ciągu wyświetlane na pasku tytułu okna dialogowego. Jeśli pominiesz tytuł,nazwa aplikacji zostanie umieszczona na pasku tytułu. |
|
domyślne |
Argument opcjonalny. Wyrażenie ciągu wyświetlane w polu tekstowym jako odpowiedź domyślna, jeśli nie podano żadnych innych danych wejściowych. Jeśli pominiesz wartość domyślną,pole tekstowe będzie puste. |
|
xpos |
Argument opcjonalny. Wyrażenie liczbowe, które określa w twipach odległość poziomą lewej krawędzi okna dialogowego od lewej krawędzi ekranu. Jeśli pominiesz xpos, okno dialogowe zostanie wyśrodkowane w poziomie. |
|
ypos |
Argument opcjonalny. Wyrażenie liczbowe, które określa w twipach odległość pionową górnej krawędzi okna dialogowego od górnej krawędzi ekranu. Jeśli ypos zostanie pominięty, okno dialogowe zostanie w pionie umieszczonych w przybliżeniu o jedną trzecią odległości w dół ekranu. |
|
helpfile |
Argument opcjonalny. Wyrażenie ciągu identyfikujące plik Pomocy do użycia w celu zapewnienia Pomocy kontekstowej dla okna dialogowego. Jeśli jest podany plik HelpFile,należy także podać kontekst. |
|
kontekst |
Argument opcjonalny. Wyrażenie liczbowe, które jest numerem kontekstowym Pomocy przypisanym do odpowiedniego tematu Pomocy przez autora Pomocy. Jeśli kontekst jest podany, musi być również podany plik helpfile. |
Spostrzeżenia
Po podano zarówno plik Pomocy, jak i kontekst, użytkownik może nacisnąć klawisz F1 (Windows) lub HELP (Macintosh), aby wyświetlić temat Pomocy odpowiadający kontekstowi. Niektóre aplikacja hosta, na przykład Microsoft Office Excel 2007, również automatycznie dodają do okna dialogowego przycisk Pomoc. Jeśli użytkownik kliknie przycisk OK lub naciśnie klawisz ENTER, funkcja InputBox zwróci wszystko, co znajduje się w polu tekstowym. Jeśli użytkownik kliknie przycisk Anuluj,funkcja zwróci ciąg znaków o zerowej długości ("").
Uwaga: Aby określić więcej niż pierwszy nazwany argument, należy użyć pola InputBox w wyrażenie. Aby pominąć pewne argumenty pozycyjne, należy uwzględnić odpowiedni ogranicznik przecinków.
Przykład
Uwaga: Poniższe przykłady przedstawiają sposób użycia tej funkcji w module języka Visual Basic for Applications (VBA). Aby uzyskać dodatkowe informacje na temat pracy w języku VBA, wybierz pozycję Dokumentacja dewelopera z listy rozwijanej obok przycisku Wyszukaj i wprowadź odpowiednie terminy w polu wyszukiwania.
W tym przykładzie pokazano różne sposoby używania funkcji InputBox w celu monitowania użytkownika o wprowadzenie wartości. Jeśli zostaną pominięte pozycje x i y, okno dialogowe zostanie automatycznie wyśrodkowane dla odpowiednich osi. Zmienna MyValue wartość wprowadzona przez użytkownika, jeśli użytkownik kliknie przycisk OK lub naciśnie klawisz ENTER. Jeśli użytkownik kliknie przycisk Anuluj,zostanie zwrócony ciąg znaków o zerowej długości.
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)
