다음을 통해 공유


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

정의

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

public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, object? Title = default);
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.OkOnly, Optional Title As Object = Nothing) As 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(10)) 또는 캐리지 리턴/줄 바꿈 문자 조합(Chr(Chr(13)& Chr(10))을 사용하여 줄을 구분할 수 있습니다.

Buttons
MsgBoxStyle

선택 사항입니다. 표시할 단추의 수와 형식, 사용할 아이콘 스타일, 기본 단추의 ID 및 메시지 상자의 모달을 지정하는 값의 합을 나타내는 숫자 식입니다. Buttons를 생략한 경우 기본값은 0입니다.

Title
Object

선택 사항입니다. 대화 상자의 제목 표시줄에 표시되는 String 식입니다. Title을 생략하면 애플리케이션 이름이 제목 표시줄에 나타납니다.

반환

다음 값 중 하나입니다.

상수
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

예외

PromptString 식이 아니거나 Title이 올바르지 않습니다.

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

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

예제

이 예제에서는 함수를 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 Form 애플리케이션에서 선택 합니다 도움말 실행 단추를 HelpRequested 폼에 대 한 이벤트.

참고

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

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

멤버 Description
멤버 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 애플리케이션 모달입니다. 사용자는 현재 애플리케이션에서 작업을 계속 하기 전에 messagebox에 응답 해야 합니다.
SystemModal 4096 시스템이 모달입니다. 모든 애플리케이션에는 사용자가 messagebox에 응답할 때까지 일시 중단 됩니다.
MsgBoxSetForeground 65536 메시지 상자 창을 포그라운드 창으로 지정합니다.
MsgBoxRight 524288 텍스트가 오른쪽 맞춤입니다.
MsgBoxRtlReading 1048576 텍스트가 히브리어 및 아랍어 시스템에서 오른쪽에서 왼쪽으로 읽기로 표시되도록 지정합니다.

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

적용 대상

추가 정보