Interaction.MsgBox(Object, MsgBoxStyle, Object) Interaction.MsgBox(Object, MsgBoxStyle, Object) Interaction.MsgBox(Object, MsgBoxStyle, Object) Method

정의

대화 상자에 메시지를 표시하고 사용자가 단추를 클릭할 때까지 대기한 다음 클릭된 단추를 나타내는 정수를 반환합니다.Displays a message in a dialog box, waits for the user to click a button, and then returns an integer indicating which button the user clicked.

public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, object Title = null);
static member MsgBox : obj * Microsoft.VisualBasic.MsgBoxStyle * obj -> Microsoft.VisualBasic.MsgBoxResult
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, Optional Title As Object = null) As MsgBoxResult

매개 변수

Prompt
Object Object Object

필수 요소.Required. String 대화 상자에서 메시지로 표시되는 식입니다.expression displayed as the message in the dialog box. Prompt의 최대 길이는 대략 1024자이며 사용되는 문자의 너비에 따라 달라집니다.The maximum length of Prompt is approximately 1024 characters, depending on the width of the characters used. Prompt가 두 줄 이상으로 구성되는 경우 캐리지 리턴 문자(Chr(13)), 줄 바꿈 문자(Chr(10)) 또는 각 줄 사이에 캐리지 리턴/줄 바꿈 조합(Chr(13) & Chr(10))을 사용하여 줄을 구분할 수 있습니다.If Prompt consists of more than one line, you can separate the lines using a carriage return character (Chr(13)), a line feed character (Chr(10)), or a carriage return/linefeed character combination (Chr(13) & Chr(10)) between each line.

Buttons
MsgBoxStyle MsgBoxStyle MsgBoxStyle

선택 사항입니다.Optional. 표시할 단추의 수와 형식, 사용할 아이콘 스타일, 기본 단추의 ID 및 메시지 상자의 모달을 지정하는 값의 합을 나타내는 숫자 식입니다.Numeric expression that is the sum of values specifying the number and type of buttons to display, the icon style to use, the identity of the default button, and the modality of the message box. Buttons를 생략한 경우 기본값은 0입니다.If you omit Buttons, the default value is zero.

Title
Object Object Object

선택 사항입니다.Optional. String 대화 상자의 제목 표시줄에 표시되는 식입니다.expression displayed in the title bar of the dialog box. Title을 생략하면 응용 프로그램 이름이 제목 표시줄에 나타납니다.If you omit Title, the application name is placed in the title bar.

반환

상수Constant Value
OK 11
Cancel 22
Abort 33
Retry 44
Ignore 55
Yes 66
No 77

예외

Prompt String 식이 아니거나 Title이 올바르지 않습니다.is not a String expression, or Title is invalid.

프로세스가 사용자 대화형 모드로 실행되고 있지 않습니다.Process is not running in User Interactive mode.

하나 이상의 매개 변수가 MsgBoxResult 또는 MsgBoxStyle 열거형의 멤버가 아닙니다.One or more parameters not a member of MsgBoxResult or MsgBoxStyle enumeration.

예제

이 예제에서는 MsgBox 예 및 아니요 단추가 있는 대화 상자에 오류 메시지를 표시 하는 함수입니다.This example uses the MsgBox function to display a critical-error message in a dialog box with Yes and No buttons. 아니요 단추는 기본적으로 지정 됩니다.The No button is specified as the default response. 결합 하 여 이렇게는 MsgBox 하나의 숫자 식으로 상수 값입니다.This is done by combining the MsgBox constant values into one numeric expression. 이 예제의 경우 4를 추가 (는 예/아니요 단추 조합) 및 16 (합니다 중대 오류 메시지 창) 256 (기본 단추를 두 번째 단추)을 통해 276 총 및 합니다.In this case, adding 4 (the Yes/No button combination) and 16 (the Critical Message window) and 256 (the second button as default button) gives a total of 276. 반환 된 값을 MsgBox 함수는 사용자가 선택한 단추에 따라 달라 집니다. 예 6; 값을 반환 합니다. 7의 값을 반환 되지 않습니다.The value returned by the MsgBox function depends on the button chosen by the user: Yes returns a value of 6; No returns a value of 7.

' The following example requires that Option Infer be set to On.

' Define the message you want to see inside the message box.
Dim msg = "Do you want to continue?"

' Display a simple message box.
MsgBox(msg)

' Define a title for the message box.
Dim title = "MsgBox Demonstration"

' Add the title to the display.
MsgBox(msg, , title)

' Now define a style for the message box. In this example, the
' message box will have Yes and No buttons, the default will be
' the No button, and a Critical Message icon will be present.
Dim style = MsgBoxStyle.YesNo Or MsgBoxStyle.DefaultButton2 Or
            MsgBoxStyle.Critical

' Display the message box and save the response, Yes or No.
Dim response = MsgBox(msg, style, title)

' Take some action based on the response.
If response = MsgBoxResult.Yes Then
    MsgBox("YES, continue!!", , title)
Else
    MsgBox("NO, stop!!", , title)
End If

설명

위치 인수를 생략 하면 해당 쉼표 구분 기호를 유지 해야 합니다.If you omit any positional arguments, you must retain the corresponding comma delimiter.

대화 상자를 표시 하는 경우는 취소할 ESC 키를 누르면 단추를 클릭 하는 것과 동일한 효과가 취소If the dialog box displays a Cancel button, pressing the ESC key has the same effect as clicking Cancel

대화 상자에는 도움말 단추 상황에 맞는 도움말 대화 상자에 제공 됩니다.If the dialog box contains a Help button, context-sensitive Help is provided for the dialog box. 그러나 값이 없는 다른 단추 중 하나 선택 될 때까지 반환 됩니다.However, no value is returned until one of the other buttons is chosen. Windows Form 응용 프로그램에서 선택 합니다 도움말 실행 단추를 HelpRequested 폼에 대 한 이벤트.In Windows Form applications, choosing the Help button executes the HelpRequested event for the form.

참고

MsgBox 함수에는 필요 UIPermissionSafeTopLevelWindows 수준 부분 신뢰 상황에서 해당 실행에 영향을 줄 수 있습니다.The MsgBox function requires UIPermission at the SafeTopLevelWindows level, which may affect its execution in partial-trust situations. 자세한 내용은 UIPermission를 참조하십시오.For more information, see UIPermission.

MsgBoxStyle 열거형 값은 다음 표에 나열 됩니다.The MsgBoxStyle enumeration values are listed in the following table.

멤버Member Value 설명Description
멤버Member Value 설명Description
OKOnly 00 확인 표시 단추에만 해당 합니다.Displays OK button only.
OKCancel 11 확인 표시 및 취소 단추Displays OK and Cancel buttons.
AbortRetryIgnore 22 중단, 다시 시도 및 무시 단추가 표시 됩니다.Displays Abort, Retry, and Ignore buttons.
YesNoCancel 33 이 예로 표시 됩니다, 아니요 및 취소 단추가 있습니다.Displays Yes, No, and Cancel buttons.
YesNo 44 예 및 아니요 단추가 표시 됩니다.Displays Yes and No buttons.
RetryCancel 55 다시 시도 및 취소 단추를 표시합니다.Displays Retry and Cancel buttons.
Critical 1616 중요 한 메시지 아이콘을 표시 합니다.Displays Critical Message icon.
Question 3232 경고 쿼리 아이콘을 표시 합니다.Displays Warning Query icon.
Exclamation 4848 경고 메시지 아이콘을 표시 합니다.Displays Warning Message icon.
Information 6464 정보 메시지 아이콘을 표시 합니다.Displays Information Message icon.
DefaultButton1 00 첫 번째 단추가 기본 단추입니다.First button is default.
DefaultButton2 256256 두 번째 단추가 기본 단추입니다.Second button is default.
DefaultButton3 512512 세 번째 단추가 기본 단추입니다.Third button is default.
ApplicationModal 00 응용 프로그램 모달입니다.Application is modal. 사용자는 현재 응용 프로그램에서 작업을 계속 하기 전에 messagebox에 응답 해야 합니다.The user must respond to the message box before continuing work in the current application.
SystemModal 40964096 시스템 모달입니다.System is modal. 모든 응용 프로그램에는 사용자가 messagebox에 응답할 때까지 일시 중단 됩니다.All applications are suspended until the user responds to the message box.
MsgBoxSetForeground 6553665536 메시지 상자 창에 전경 창으로 지정합니다.Specifies the message box window as the foreground window.
MsgBoxRight 524288524288 텍스트를 오른쪽에 맞춥니다.Text is right-aligned.
MsgBoxRtlReading 10485761048576 텍스트를 오른쪽에서 왼쪽 히브리어 및 아랍어 시스템에서 읽는 표시를 지정 합니다.Specifies text should appear as right-to-left reading on Hebrew and Arabic systems.

값 (0-5)의 첫 번째 그룹 수와 대화 상자에서 표시 되는 단추의 종류를 설명 합니다.The first group of values (0-5) describes the number and type of buttons displayed in the dialog box. 두 번째 그룹 (16, 32, 48, 64) 아이콘 스타일을 설명합니다.The second group (16, 32, 48, 64) describes the icon style. 세 번째 그룹 (0, 256, 512) 단추는 기본값을 결정 합니다.The third group (0, 256, 512) determines which button is the default. 네 번째 그룹 (0, 4096) 메시지 상자의 모달 결정 및 다섯 번째 그룹은 메시지 상자 창에는 전경 창이 맞춤 및 텍스트 방향을 함께 있는지 여부를 지정 합니다.The fourth group (0, 4096) determines the modality of the message box, and the fifth group specifies whether or not the message box window is the foreground window, along with the alignment and direction of the text. 에 대 한 최종 값을 만들 수는 숫자를 추가 하는 경우는 Buttons 인수를 사용 하 여 각 그룹에서 하나의 숫자만 합니다.When adding numbers to create a final value for the Buttons argument, use only one number from each group.

적용 대상

추가 정보