InputBox, functie
Van toepassing op
Hiermee wordt een bericht weergegeven in een dialoogvenster, wordt er gewacht totdat de gebruiker tekst invoert of op een knop klikt, en wordt er een tekenreeks geretourneerd met de inhoud van het tekstvak.
Syntaxis
InputBox(prompt [, titel ] [, standaard ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
De syntaxis van de functie InputBox bevat deze argumenten:
| Argument | Beschrijving |
|---|---|
| tekst | Vereist. Een tekenreeksexpressie die als het bericht wordt weergegeven in het dialoogvenster. De maximale lengte van de prompt is ongeveer 1024 tekens, afhankelijk van de breedte van de gebruikte tekens. Als de prompt uit meer dan één regel bestaat, kunt u de regels scheiden met behulp van een regelterugloopteken (Chr(13)), een regelinvoerteken (Chr(10)) of een combinatie van tekentekens voor de invoer van de rijbaan (Chr(13) & Chr(10)) tussen elke regel. |
| titel | Optioneel. Een tekenreeksexpressie die wordt weergegeven op de titelbalk van het dialoogvenster. Als u de titel weglaat, wordt de naam van de toepassing in de titelbalk geplaatst. |
| standaard | Optioneel. Een tekenreeksexpressie die wordt weergegeven in het tekstvak als er geen andere tekst is opgegeven. Als u de standaardinstelling weglaat, wordt het tekstvak leeg weergegeven. |
| xpos | Optioneel. Een numerieke expressie die, in twips, de horizontale afstand aangeeft tussen de linkerrand van het dialoogvenster en de linkerkant van het scherm. Als xpos wordt weggelaten, wordt het dialoogvenster horizontaal gecentreerd. |
| ypos | Optioneel. Een numerieke expressie die, in twips, de verticale afstand aangeeft tussen de bovenrand van het dialoogvenster en de bovenrand van het scherm. Als ypos wordt weggelaten, wordt het dialoogvenster verticaal ongeveer een derde van de weg naar beneden in het scherm geplaatst. |
| helpbestand | Optioneel. Een tekenreeksexpressie die verwijst naar het Help-bestand met contextafhankelijke Help-informatie voor het dialoogvenster. Als er een helpbestand wordt opgegeven, moet er ook context worden opgegeven. |
| Context | Optioneel. Een numerieke expressie die verwijst naar het nummer voor Help-context dat door de schrijver van de Help-informatie is toegewezen aan het betreffende Help-onderwerp. Als er context wordt opgegeven, moet ook het helpbestand worden opgegeven. |
Opmerkingen
Wanneer zowel helpbestand als context zijn opgegeven, kan de gebruiker op F1 (Windows) of HELP (Macintosh) drukken om het Help-onderwerp weer te geven dat overeenkomt met de context. Sommige hosttoepassingen voegen ook automatisch een Help-knop toe aan het dialoogvenster. Als de gebruiker op OK klikt of op Enter drukt, retourneert de functie InputBox de inhoud van het tekstvak. Als de gebruiker op Annuleren klikt, retourneert de functie een tekenreeks met de lengte nul ("").
Opmerking
Als u meer wilt opgeven dan het eerste benoemde argument, moet u InputBox gebruiken in een expressie. Als u op bepaalde plekken argumenten wilt weglaten, moet u daar wel een komma als scheidingsteken typen.
Voorbeeld
Opmerking
In de volgende voorbeelden wordt het gebruik van deze functie in een VBA-module (Visual Basic for Applications) toegelicht. Meer informatie over het werken met VBA vindt u door in de vervolgkeuzelijst naast Zoeken de optie Referentie voor ontwikkelaars te selecteren en een of meer termen in het zoekvenster te typen.
In dit voorbeeld ziet u hoe u de functie InputBox op verschillende manieren kunt gebruiken om de gebruiker te vragen een waarde in te voeren. Als u de argumenten voor de x- en y-posities weglaat, wordt het dialoogvenster automatisch gecentreerd voor de desbetreffende assen. De variabele MyValue bevat de waarde die de gebruiker heeft ingevoerd als de gebruiker op OK klikt of op enter drukt. Als de gebruiker op Annuleren klikt, wordt er een tekenreeks met de lengte nul ("") geretourneerd.
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)