Afișează o solicitare într-o casetă de dialog, așteaptă ca utilizatorul să introducă text sau să facă clic pe un buton și returnează un șir care conține conținutul casetei text.
Sintaxă
InputBox(prompt [, titlu ] [, implicit ] [, xpos ] [, ypos ] [, fișier de ajutor ] [, context ] )
Sintaxa funcției InputBox are următoarele argumente:
| Argument | Descriere |
|---|---|
| solicitare | Obligatoriu. Expresie șir afișată ca mesaj în caseta de dialog. Lungimea maximă a solicitării este de aproximativ 1024 de caractere, în funcție de lățimea caracterelor utilizate. Dacă solicitarea constă din mai multe linii, puteți separa liniile utilizând un caracter sfârșit de linie (Chr(13)), un caracter flux de linie (Chr(10)) sau o combinație de caractere sfârșit-linie (Chr(13) & Chr(10)) între fiecare linie. |
| titlu | Opțional. Expresie șir afișată în bara de titlu a casetei de dialog. Dacă omiteți titlul, numele aplicației este plasat în bara de titlu. |
| implicit | Opțional. Expresie șir afișată în caseta text ca răspuns implicit dacă nu se furnizează nicio altă intrare. Dacă omiteți valoarea implicită, caseta text se afișează necompletată. |
| XPOs | Opțional. Expresie numerică care specifică, în twips, distanța orizontală a marginii din stânga a casetei de dialog față de marginea din stânga a ecranului. Dacă xpos este omis, caseta de dialog este centrată pe orizontală. |
| ypos | Opțional. Expresie numerică ce specifică, în twips, distanța verticală a marginii superioare a casetei de dialog față de partea superioară a ecranului. Dacă ypos este omis, caseta de dialog este poziționată vertical, la aproximativ o treime din partea de jos a ecranului. |
| FișierAjutor | Opțional. Expresie șir care identifică fișierul de ajutor de utilizat pentru a furniza ajutor dependent de context pentru caseta de dialog. Dacă s-a furnizat fișierul de ajutor , trebuie furnizat și contextul . |
| context | Opțional. Expresie numerică care este numărul contextului de ajutor atribuit subiectului de ajutor corespunzător de către autorul ajutorului. Dacă este furnizat context , trebuie furnizat și fișierul de ajutor . |
Observații
Atunci când se furnizează atât fișier de ajutor , cât și context , utilizatorul poate apăsa pe F1 (Windows) sau pe HELP (Macintosh) pentru a vedea subiectul de ajutor corespunzător contextului. De asemenea, unele aplicații gazdă adaugă automat un buton Ajutor în caseta de dialog. Dacă utilizatorul face clic pe OK sau apasă pe ENTER, funcția InputBox returnează orice element din caseta text. Dacă utilizatorul face clic pe Anulare, funcția returnează un șir de lungime zero ("").
Notă
Pentru a specifica mai mult decât primul argument denumit, trebuie să utilizați InputBox într-o expresie. Pentru a omite unele argumente poziționale, trebuie inclus delimitatorul de virgulă corespunzător.
Exemplu
Notă
Exemplele care urmează demonstrează utilizarea acestei funcții într-un modul Visual Basic for Applications (VBA). Pentru mai multe informații despre lucrul cu VBA, selectați Referințe pentru dezvoltatori în lista verticală de lângă Căutare și introduceți unul sau mai mulți termeni în caseta de căutare.
Acest exemplu arată diverse modalități de a utiliza funcția InputBox pentru a solicita utilizatorului să introducă o valoare. Dacă pozițiile x și y sunt omise, caseta de dialog este centrată automat pentru axele respective. Variabila MyValue conține valoarea introdusă de utilizator dacă utilizatorul face clic pe OK sau apasă tasta ENTER. Dacă utilizatorul face clic pe Anulare, se returnează un șir de lungime zero.
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)