InputBox 함수

대화 상자에 프롬프트를 표시하고 사용자가 텍스트를 입력하거나 단추를 클릭할 때까지 기다린 다음 텍스트 상자의 내용이 포함된 문자열을 반환합니다.

구문

InputBox(prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )

InputBox 함수 구문에는 다음과 같은 인수가 사용됩니다.

인수	설명
프롬프트	필수 요소입니다. 대화 상자에서 메시지로 표시되는 문자열 식입니다. 프롬프트의 최대 길이는 사용되는 문자의 너비에 따라 약 1024자입니다. 프롬프트가 두 줄 이상으로 구성된 경우 각 줄 사이에 캐리지 리턴 문자(Chr(13)), 줄 바꿈 문자(Chr(10)) 또는 캐리지 리턴-줄 바꿈 문자 조합(Chr(13) & Chr(10))을 사용하여 줄을 구분할 수 있습니다.
제목	선택 요소입니다. 대화 상자의 제목 표시줄에 표시되는 문자열 식입니다. 제목을 생략하면 응용 프로그램 이름이 제목 표시줄에 배치됩니다.
기본값	선택 요소입니다. 다른 입력이 제공되지 않으면 텍스트 상자에 기본 응답으로 표시되는 문자열 식입니다. 기본값을 생략하면 텍스트 상자가 비어 표시됩니다.
엑스포스	선택 요소입니다. 화면 왼쪽 가장자리에서 대화 상자 왼쪽 가장자리의 가로 거리를 트윕 단위로 지정하는 숫자 식입니다. xpos를 생략하면 대화 상자가 가로로 가운데 맞춤됩니다.
YPOS	선택 요소입니다. 화면 맨 위에서 대화 상자 위쪽 가장자리의 세로 거리를 트윕 단위로 지정하는 숫자 식입니다. ypos를 생략하면 대화 상자가 화면의 약 1/3 아래에 수직으로 배치됩니다.
도움말 파일	선택 요소입니다. 대화 상자에 상황에 맞는 도움말을 제공하는 데 사용할 도움말 파일을 식별하는 문자열 식입니다. helpfile이 제공되는 경우 컨텍스트도 제공해야 합니다.
컨텍스트	선택 요소입니다. 도움말 작성자가 해당 도움말 항목에 할당한 도움말 컨텍스트 번호인 숫자 식입니다. 컨텍스트가 제공되는 경우 helpfile도 제공해야 합니다.

주의

도움말 파일과 컨텍스트가 모두 제공되면 사용자는 F1 키(Windows) 또는 HELP(Macintosh)를 눌러 컨텍스트에 해당하는 도움말 항목을 볼 수 있습니다. 또한 일부 호스트 응용 프로그램은 대화 상자에 도움말 단추를 자동으로 추가합니다. 사용자가 확인 을 클릭하거나 Enter 키를 누르면 InputBox 함수는 텍스트 상자에 있는 내용을 반환합니다. 사용자가 취소를 클릭하면 함수는 길이가 0인 문자열("")을 반환합니다.

예제

이 예제에서는 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)