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 ] [, helpfile ] [, context ] )
Sintaxa funcției InputBox are următoarele argumente:
|
Argument |
Descriere |
|
Prompt |
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 de 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 setarea implicită, caseta text se afișează goală. |
|
xpos |
Opțional. Expresie numerică care specifică, în twips, distanța orizontală a marginii din stânga a casetei de dialog de la marginea stângă a ecranului. Dacă xpos este omis, caseta de dialog este centrată pe orizontală. |
|
erori y |
Opțional. Expresie numerică care specifică, în twips, distanța verticală a marginii superioare a casetei de dialog față de partea de sus a ecranului. Dacă se omite ypos , caseta de dialog este poziționată pe verticală aproximativ o treime din drumul de jos al ecranului. |
|
helpfile |
Opțional. Expresie șir care identifică fișierul Ajutor de utilizat pentru a furniza Ajutor contextual pentru caseta de dialog. Dacă este furnizat helpfile , trebuie furnizat și contextul . |
|
Contextul |
Opțional. Expresie numerică care este numărul de context Ajutor atribuit subiectului de Ajutor corespunzător de autorul Ajutorului. Dacă este furnizat contextul , trebuie furnizat și helpfile . |
Observații
Atunci când sunt furnizate atât helpfile , cât și contextul , utilizatorul poate apăsa F1 (Windows) sau HELP (Macintosh) pentru a vizualiza subiectul de Ajutor corespunzător contextului. Unele aplicație gazdă, de exemplu, Microsoft Office Excel 2007, adaugă automat un buton Ajutor în caseta de dialog. Dacă utilizatorul face clic pe OK sau apasă pe ENTER, funcția InputBox returnează ceea ce se află în 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-un expresie. Pentru a omite unele argumente poziționale, trebuie să includeți 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)
