Interaction.MsgBox(Object, MsgBoxStyle, Object) 메서드

정의

대화 상자에 메시지를 표시하고 사용자가 단추를 클릭할 때까지 기다린 다음 사용자가 클릭한 단추를 나타내는 정수(integer)를 반환합니다.

public static Microsoft.VisualBasic.MsgBoxResult MsgBox(object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, object Title = default);
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 = Nothing) As MsgBoxResult

매개 변수

Prompt
Object

필수 사항입니다. String 대화 상자에 메시지로 표시되는 식입니다. 최대 길이는 사용된 문자의 Prompt 너비에 따라 약 1024자입니다. 둘 이상의 줄로 구성된 경우 Prompt 캐리지 리턴 문자(13)), 줄 바꿈 문자(Chr(Chr(10)) 또는 캐리지 리턴/줄 바꿈 문자 조합(Chr(13)Chr(10))을 사용하여 각 줄을 구분할 수 있습니다.

Buttons
MsgBoxStyle

Optional. 표시할 단추의 수와 유형, 사용할 아이콘 스타일, 기본 단추의 ID 및 메시지 상자의 형식을 지정하는 값의 합계인 숫자 식입니다. 생략 Buttons하면 기본값은 0입니다.

Title
Object

Optional. String 대화 상자의 제목 표시줄에 표시되는 식입니다. 생략 Title하면 애플리케이션 이름이 제목 표시줄에 배치됩니다.

반품

다음 값 중 하나입니다.

상수Value
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

예외

Prompt 가 식이 String 아니거나 Title 잘못되었습니다.

프로세스가 사용자 대화형 모드에서 실행되고 있지 않습니다.

하나 이상의 매개 변수가 멤버 또는 MsgBoxStyle 열거형이 MsgBoxResult 아닙니다.

예제

이 예제에서는 이 함수를 MsgBox 사용하여 예 및 아니요 단추가 있는 대화 상자에 심각한 오류 메시지를 표시합니다. 아니요 단추는 기본 응답으로 지정됩니다. 이 작업은 상수 값을 하나의 숫자 식으로 결합하여 MsgBox 수행합니다. 이 경우 4(예/아니요 단추 조합) 및 16( 중요 메시지 창) 및 256(기본 단추로 두 번째 단추)을 추가하면 총 276이 제공됩니다. 함수에서 MsgBox 반환되는 값은 사용자가 선택한 단추에 따라 달라집니다. 예는 6의 값을 반환합니다. 값 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

설명

위치 인수를 생략하는 경우 해당 쉼표 구분 기호를 유지해야 합니다.

대화 상자에 취소 단추가 표시되면 ESC 키를 누르면 취소를 클릭하는 것과 같은 효과가 있습니다.

대화 상자에 도움말 단추가 포함된 경우 대화 상자에 상황에 맞는 도움말이 제공됩니다. 그러나 다른 단추 중 하나를 선택할 때까지 값이 반환되지 않습니다. Windows 양식 애플리케이션에서 Help 단추를 선택하면 양식에 대한 HelpRequested 이벤트가 실행됩니다.

메모

이 함수는 MsgBoxUIPermissionSafeTopLevelWindows 부분 신뢰 상황에서의 실행에 영향을 줄 수 있는 수준에서 필요합니다. 자세한 내용은 UIPermission를 참조하세요.

MsgBoxStyle 열거형 값은 다음 표에 나와 있습니다.

회원 Value Description
회원 Value Description
OKOnly 0 확인 단추만 표시합니다.
OKCancel 1 확인 및 취소 단추를 표시합니다.
AbortRetryIgnore 2 중단, 다시 시도 및 무시 단추를 표시합니다.
YesNoCancel 3 예, 아니요 및 취소 단추를 표시합니다.
YesNo 4 예 및 아니요 단추를 표시합니다.
RetryCancel 5 다시 시도 및 취소 단추를 표시합니다.
Critical 16 중요 메시지 아이콘을 표시합니다.
Question 32 경고 쿼리 아이콘을 표시합니다.
Exclamation 48 경고 메시지 아이콘을 표시합니다.
Information 64 정보 메시지 아이콘을 표시합니다.
DefaultButton1 0 첫 번째 단추는 기본값입니다.
DefaultButton2 256 두 번째 단추는 기본값입니다.
DefaultButton3 512 세 번째 단추는 기본값입니다.
ApplicationModal 0 애플리케이션이 모달입니다. 사용자는 현재 애플리케이션에서 작업을 계속하기 전에 메시지 상자에 응답해야 합니다.
SystemModal 4096 시스템이 모달입니다. 모든 애플리케이션에는 사용자가 messagebox에 응답할 때까지 일시 중단 됩니다.
MsgBoxSetForeground 65536 메시지 상자 창을 전경 창으로 지정합니다.
MsgBoxRight 524288 텍스트가 오른쪽 맞춤입니다.
MsgBoxRtlReading 1048576 텍스트가 히브리어 및 아랍어 시스템에서 오른쪽에서 왼쪽으로 읽기로 표시되도록 지정합니다.

첫 번째 값 그룹(0-5)은 대화 상자에 표시되는 단추의 수와 유형을 설명합니다. 두 번째 그룹(16, 32, 48, 64)은 아이콘 스타일을 설명합니다. 세 번째 그룹(0, 256, 512)은 기본값인 단추를 결정합니다. 네 번째 그룹(0, 4096)은 메시지 상자의 형식을 결정하며, 다섯 번째 그룹은 메시지 상자 창이 텍스트의 맞춤 및 방향과 함께 전경 창인지 여부를 지정합니다. 인수에 대한 최종 값을 만들기 위해 Buttons 숫자를 추가할 때 각 그룹에서 하나의 숫자만 사용합니다.

적용 대상

추가 정보