대화 상자에 프롬프트를 표시하고, 사용자가 텍스트를 입력하거나 단추를 클릭할 때까지 기다린 다음, 텍스트 상자의 내용이 포함된 String을 반환합니다.
구문
InputBox ( prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
InputBox 함수 구문에는 다음과 같은 인수가 사용됩니다.
인수 |
설명 |
---|---|
프롬프트 |
필수 요소입니다. 대화 상자에서 메시지로 표시되는 문자열 식입니다. 프롬프트의 최대 길이는 사용된 문자의 너비에 따라 약 1024자입니다. 프롬프트가 둘 이상의 줄로 구성된 경우 캐리지 리턴 문자(Chr(13)), 줄 바꿈 문자(Chr(10) 또는 캐리지 리턴-줄 바꿈 문자 조합(Chr(13) & Chr(10))을 사용하여 줄을 구분 할 수 있습니다. |
클릭하십시오. |
선택 요소입니다. 대화 상자의 제목 표시줄에 표시되는 문자열 식입니다. 제목을 생략하면 애플리케이션 이름이 제목 표시줄에 배치됩니다. |
기본값 |
선택 요소입니다. 다른 입력이 제공되지 않으면 텍스트 상자에 기본 응답으로 표시되는 문자열 식입니다. 기본값을 생략하면 텍스트 상자가 비어 표시됩니다. |
xpos |
선택 요소입니다. 화면의 왼쪽 가장자리에서 대화 상자 왼쪽 가장자리의 가로 거리를 twips 단위로 지정하는 숫자 식입니다. xpos를 생략하면 대화 상자가 가로 가운데에 배치됩니다. |
ypos |
선택 요소입니다. 화면 위쪽에서 대화 상자 위쪽 가장자리의 세로 거리를 twips 단위로 지정하는 숫자 식입니다. ypos를 생략하면 대화 상자가 화면 아래쪽의 약 3분의 1에 수직으로 배치됩니다. |
Helpfile |
선택 요소입니다. 대화 상자에 컨텍스트를 구분하는 도움말을 제공하는 데 사용할 도움말 파일을 식별하는 문자열 식입니다. 도움말 파일이 제공된 경우 컨텍스트도 제공해야 합니다. |
context |
선택 요소입니다. 도움말 작성자가 적절한 도움말 항목에 할당한 도움말 컨텍스트 번호인 숫자 식입니다. 컨텍스트가 제공된 경우 도움말 파일도 제공해야 합니다. |
주의
도움말 파일 과 컨텍스트가 모두 제공되면 사용자는 F1(Windows) 또는 HELP(Macintosh)를 눌러 컨텍스트에 해당하는 도움말 항목을 볼 수 있습니다. 일부 호스트 응용 프로그램 대화 상자에 도움말 단추를 자동으로 추가합니다. 사용자가 확인을 클릭하거나 Enter 키를 누르면 InputBox 함수는 텍스트 상자에 있는 모든 항목을 반환합니다. 사용자가 취소를 클릭하면 함수는 길이가 0인 문자열("")을 반환합니다.
참고: 첫 번째 명명된 인수보다 더 많은 인수를 지정하려면 식InputBox 를 사용해야 합니다. 일부 위치 인수를 생략하려면 해당 쉼표 구분 기호를 포함해야 합니다.
예제
참고: VBA(Visual Basic for Applications) 모듈에서 이 함수를 사용하는 경우를 예로 들어 보겠습니다. VBA 사용에 대해 자세히 알아보려면 검색 옆의 드롭다운 목록에서 개발자 참고를 선택하고 검색 상자에 검색어를 하나 이상 입력하세요.
이 예제에서는 InputBox 함수를 사용하여 사용자에게 값을 입력하라는 메시지를 표시하는 다양한 방법을 보여 줍니다. x 및 y 위치를 생략하면 대화 상자가 자동으로 해당 축의 가운데에 배치됩니다. 변수 MyValue 사용자가 확인을 클릭하거나 ENTER 키를 누를 때 사용자가 입력한 값이 포함됩니다. 사용자가 취소를 클릭하면 길이가 0인 문자열이 반환됩니다.
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)