NotifyIcon.ShowBalloonTip NotifyIcon.ShowBalloonTip NotifyIcon.ShowBalloonTip NotifyIcon.ShowBalloonTip Method

정의

작업 표시줄에 풍선 설명을 표시합니다. Displays the balloon tip in the taskbar.

오버로드

ShowBalloonTip(Int32) ShowBalloonTip(Int32) ShowBalloonTip(Int32) ShowBalloonTip(Int32)

작업 표시줄에 지정된 기간에 대한 풍선 설명을 표시합니다. Displays a balloon tip in the taskbar for the specified time period.

ShowBalloonTip(Int32, String, String, ToolTipIcon) ShowBalloonTip(Int32, String, String, ToolTipIcon) ShowBalloonTip(Int32, String, String, ToolTipIcon) ShowBalloonTip(Int32, String, String, ToolTipIcon)

지정된 기간 동안 작업 표시줄에 지정된 제목, 텍스트 및 아이콘을 포함하는 풍선 설명을 표시합니다. Displays a balloon tip with the specified title, text, and icon in the taskbar for the specified time period.

ShowBalloonTip(Int32) ShowBalloonTip(Int32) ShowBalloonTip(Int32) ShowBalloonTip(Int32)

작업 표시줄에 지정된 기간에 대한 풍선 설명을 표시합니다. Displays a balloon tip in the taskbar for the specified time period.

public:
 void ShowBalloonTip(int timeout);
public void ShowBalloonTip (int timeout);
member this.ShowBalloonTip : int -> unit
Public Sub ShowBalloonTip (timeout As Integer)
매개 변수
timeout
Int32 Int32 Int32 Int32

풍선 설명에 기간이 밀리초 단위로 표시되어야 합니다. The time period, in milliseconds, the balloon tip should display.

이 매개 변수는 Windows Vista에서 사용되지 않습니다. This parameter is deprecated as of Windows Vista. 이제 알림 표시 시간은 시스템 내게 필요한 옵션 설정에 기반합니다. Notification display times are now based on system accessibility settings.

예외

예제

다음 코드 예제에서는 ShowBalloonTip 메서드를 사용하는 방법을 보여 줍니다.The following code example demonstrates how to use the ShowBalloonTip method. 이 예제를 실행 하려면 예제 코드를 포함 하는 Windows 폼에 붙여를 NotifyIcon 라는 notifyIcon1합니다.To run this example, paste the example code into a Windows Form that contains a NotifyIcon named notifyIcon1. 호출 SetBalloonTip 폼의 생성자에서 또는 Load 이벤트 처리 메서드.Call SetBalloonTip from the form's constructor or Load event-handling method.

private void SetBalloonTip()
{
    notifyIcon1.Icon = SystemIcons.Exclamation;
    notifyIcon1.BalloonTipTitle = "Balloon Tip Title";
    notifyIcon1.BalloonTipText = "Balloon Tip Text.";
    notifyIcon1.BalloonTipIcon = ToolTipIcon.Error;
    this.Click += new EventHandler(Form1_Click);
}

void Form1_Click(object sender, EventArgs e) 
{
    notifyIcon1.Visible = true;
    notifyIcon1.ShowBalloonTip(30000);

}
Private Sub SetBalloonTip()
    notifyIcon1.Icon = SystemIcons.Exclamation
    notifyIcon1.BalloonTipTitle = "Balloon Tip Title"
    notifyIcon1.BalloonTipText = "Balloon Tip Text."
    notifyIcon1.BalloonTipIcon = ToolTipIcon.Error

End Sub

Sub Form1_Click(ByVal sender As Object, ByVal e As EventArgs) _
    Handles Me.Click

    notifyIcon1.Visible = True
    notifyIcon1.ShowBalloonTip(30000)

End Sub

설명

하지만 최소 및 최대 제한 시간 값에 운영 체제에서 적용 되 고는 일반적으로 10 초에서 30 초를 각각 운영 체제에 따라 달라질 수 있습니다.Minimum and maximum timeout values are enforced by the operating system and are typically 10 and 30 seconds, respectively, however this can vary depending on the operating system. 너무 크거나 너무 작은 시간 제한 값은 적절 한 최소 또는 최대 값으로 조정 됩니다.Timeout values that are too large or too small are adjusted to the appropriate minimum or maximum value. 또한 사용자는 컴퓨터 (키보드 또는 마우스 이벤트가 발생)를 사용 하는 표시 되지 않는 경우 다음 시스템 계산 하지 않습니다이 시간 제한으로.In addition, if the user does not appear to be using the computer (no keyboard or mouse events are occurring) then the system does not count this time towards the timeout.

하나의 풍선 작업 표시줄에서 한 번에 표시할 수 있습니다.Only one balloon tip can display on the taskbar at a time. 작업 표시줄 원인에 현재 표시 되어 하나 풍선 표시 하려고를 timeout 값이 무시 됩니다.Attempting to display a balloon tip when one is currently displayed on the taskbar causes the timeout value to be ignored. 운영 체제 및 다른에서 풍선 인지에 따라 동작이 약간 다릅니다. 또는 동일한, 응용 프로그램입니다.The behavior is slightly different depending on the operating system and whether the balloon tip is from another, or the same, application. 두 번째 풍선 다른 응용 프로그램의 경우 첫 번째 풍선 설명의 값에 관계 없이 두 번째 표시 되기 전에 최소 제한 시간 값 표시 됩니다 timeout합니다.When the second balloon tip is from another application, the first balloon tip will display for the minimum timeout value before the second appears, regardless of the value of timeout. 대부분의 경우에는 동일한 응용 프로그램에서 첫 번째 풍선 즉시 팁은 풍선 닫으면 다른 호출 하는 경우에 ShowBalloonTip 메서드 구성 됩니다.In most cases, if the balloon tips are from the same application, the first balloon tip immediately closes when another call to the ShowBalloonTip method is made. 일부 경우에는 두 번째 풍선 첫 번째 풍선 위에 열립니다.In some cases the second balloon will open on top of the first balloon.

제목 텍스트 풍선의 위쪽에 굵은 글꼴로 표시 됩니다.The title text will display in a bold font near the top of the balloon.

ShowBalloonTip(Int32, String, String, ToolTipIcon) ShowBalloonTip(Int32, String, String, ToolTipIcon) ShowBalloonTip(Int32, String, String, ToolTipIcon) ShowBalloonTip(Int32, String, String, ToolTipIcon)

지정된 기간 동안 작업 표시줄에 지정된 제목, 텍스트 및 아이콘을 포함하는 풍선 설명을 표시합니다. Displays a balloon tip with the specified title, text, and icon in the taskbar for the specified time period.

public:
 void ShowBalloonTip(int timeout, System::String ^ tipTitle, System::String ^ tipText, System::Windows::Forms::ToolTipIcon tipIcon);
public void ShowBalloonTip (int timeout, string tipTitle, string tipText, System.Windows.Forms.ToolTipIcon tipIcon);
member this.ShowBalloonTip : int * string * string * System.Windows.Forms.ToolTipIcon -> unit
Public Sub ShowBalloonTip (timeout As Integer, tipTitle As String, tipText As String, tipIcon As ToolTipIcon)
매개 변수
timeout
Int32 Int32 Int32 Int32

풍선 설명에 기간이 밀리초 단위로 표시되어야 합니다. The time period, in milliseconds, the balloon tip should display.

이 매개 변수는 Windows Vista에서 사용되지 않습니다. This parameter is deprecated as of Windows Vista. 이제 알림 표시 시간은 시스템 내게 필요한 옵션 설정에 기반합니다. Notification display times are now based on system accessibility settings.

tipTitle
String String String String

풍선 설명에 표시할 제목입니다. The title to display on the balloon tip.

tipText
String String String String

풍선 설명에 표시할 텍스트입니다. The text to display on the balloon tip.

tipIcon
ToolTipIcon ToolTipIcon ToolTipIcon ToolTipIcon

ToolTipIcon 값 중 하나입니다. One of the ToolTipIcon values.

예외

tipTextnull 또는 빈 문자열인 경우 tipText is null or an empty string.

예제

다음 코드 예제에서는 ShowBalloonTip 메서드를 사용하는 방법을 보여 줍니다.The following code example demonstrates how to use the ShowBalloonTip method. 이 예제를 실행 하려면 예제 코드를 포함 하는 Windows 폼에 붙여를 NotifyIcon 라는 notifyIcon1합니다.To run this example, paste the example code into a Windows Form that contains a NotifyIcon named notifyIcon1. 연결 된 Form1_DoubleClick 폼의이 예제에서 메서드 DoubleClick 이벤트입니다.Associate the Form1_DoubleClick method in this example with the form's DoubleClick event.

void Form1_DoubleClick(object sender, EventArgs e)
{
    notifyIcon1.Visible = true;
    notifyIcon1.ShowBalloonTip(20000, "Information", "This is the text",
        ToolTipIcon.Info );
}
Sub Form1_DoubleClick(ByVal sender As Object, ByVal e As EventArgs) _
        Handles Me.DoubleClick

    notifyIcon1.Visible = True
    notifyIcon1.ShowBalloonTip(20000, "Information", "This is the text", _
            ToolTipIcon.Info)
End Sub

설명

하지만 최소 및 최대 제한 시간 값에 운영 체제에서 적용 되 고는 일반적으로 10 초에서 30 초를 각각 운영 체제에 따라 달라질 수 있습니다.Minimum and maximum timeout values are enforced by the operating system and are typically 10 and 30 seconds, respectively, however this can vary depending on the operating system. 너무 크거나 너무 작은 시간 제한 값은 적절 한 최소 또는 최대 값으로 조정 됩니다.Timeout values that are too large or too small are adjusted to the appropriate minimum or maximum value. 또한 사용자는 컴퓨터 (키보드 또는 마우스 이벤트가 발생)를 사용 하는 표시 되지 않는 경우 다음 시스템 계산 하지 않습니다이 시간 제한으로.In addition, if the user does not appear to be using the computer (no keyboard or mouse events are occurring) then the system does not count this time towards the timeout.

하나의 풍선 작업 표시줄에서 한 번에 표시할 수 있습니다.Only one balloon tip can display on the taskbar at a time. 작업 표시줄 원인에 현재 표시 되어 하나 풍선 표시 하려고를 timeout 값이 무시 됩니다.Attempting to display a balloon tip when one is currently displayed on the taskbar causes the timeout value to be ignored. 운영 체제 및 다른에서 풍선 인지에 따라 동작이 약간 다릅니다. 또는 동일한, 응용 프로그램입니다.The behavior is slightly different depending on the operating system and whether the balloon tip is from another, or the same, application. 두 번째 풍선 다른 응용 프로그램의 경우 첫 번째 풍선 설명의 값에 관계 없이 두 번째 표시 되기 전에 최소 제한 시간 값 표시 됩니다 timeout합니다.When the second balloon tip is from another application, the first balloon tip will display for the minimum timeout value before the second appears, regardless of the value of timeout. 대부분의 경우에는 동일한 응용 프로그램에서 첫 번째 풍선 즉시 팁은 풍선 닫으면 다른 호출 하는 경우에 ShowBalloonTip 메서드 구성 됩니다.In most cases, if the balloon tips are from the same application, the first balloon tip immediately closes when another call to the ShowBalloonTip method is made. 일부 경우에는 두 번째 풍선 첫 번째 풍선 위에 열립니다.In some cases the second balloon will open on top of the first balloon.

제목 텍스트 풍선의 위쪽에 굵은 글꼴로 표시 됩니다.The title text will display in a bold font near the top of the balloon.

보안

UIPermission
windows 응용 프로그램에 액세스 합니다. for access to application windows. 연관 된 열거: AllWindows Related enumeration: AllWindows

적용 대상