다음을 통해 공유

NotifyIcon.ShowBalloonTip 메서드

  • 참조

정의

네임스페이스:
System.Windows.Forms
어셈블리:
System.Windows.Forms.dll

작업 표시줄에 풍선 팁을 표시합니다.

오버로드

ShowBalloonTip(Int32)

작업 표시줄에 지정된 기간에 대한 풍선 설명을 표시합니다.
ShowBalloonTip(Int32, String, String, ToolTipIcon)

지정된 기간 동안 작업 표시줄에 지정된 제목, 텍스트 및 아이콘을 포함하는 풍선 설명을 표시합니다.

ShowBalloonTip(Int32)

작업 표시줄에 지정된 기간에 대한 풍선 설명을 표시합니다.

public:
 void ShowBalloonTip(int timeout);
public void ShowBalloonTip (int timeout);
member this.ShowBalloonTip : int -> unit
Public Sub ShowBalloonTip (timeout As Integer)

매개 변수

timeout
Int32

풍선 설명에 기간이 밀리초 단위로 표시되어야 합니다. 이 매개 변수는 사용되지 않습니다. 이제 알림 표시 시간은 시스템 내게 필요한 옵션 설정에 기반합니다.

예외

ArgumentOutOfRangeException

timeout 가 0보다 작습니다.

예제

다음 코드 예제에서는 ShowBalloonTip 메서드를 사용하는 방법을 보여 줍니다. 이 예제를 실행하려면 라는 가 notifyIcon1포함된 Windows Form에 예제 코드를 붙여넣습니다NotifyIcon. 폼의 생성자 또는 Load 이벤트 처리 메서드에서 를 호출 SetBalloonTip 합니다.

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초입니다. 그러나 운영 체제에 따라 달라질 수 있습니다. 너무 크거나 너무 작은 시간 제한 값은 적절한 최소값 또는 최대값으로 조정됩니다. 또한 사용자가 컴퓨터를 사용하지 않는 것처럼 보이는 경우(키보드 또는 마우스 이벤트가 발생하지 않음) 시스템은 이번에는 시간 제한으로 계산되지 않습니다.

한 번에 하나의 풍선 팁만 작업 표시줄에 표시할 수 있습니다. 작업 표시줄에 풍선 팁이 현재 표시되면 풍선 팁을 표시하려고 하면 값이 timeout 무시됩니다. 운영 체제 및 다른에서 풍선 인지에 따라 동작이 약간 다릅니다. 또는 동일한, 애플리케이션입니다. 두 번째 풍선 다른 애플리케이션의 경우 첫 번째 풍선 설명의 값에 관계 없이 두 번째 표시 되기 전에 최소 제한 시간 값 표시 됩니다 timeout합니다. 대부분의 경우에는 동일한 애플리케이션에서 첫 번째 풍선 즉시 팁은 풍선 닫으면 다른 호출 하는 경우에 ShowBalloonTip 메서드 구성 됩니다. 경우에 따라 두 번째 풍선이 첫 번째 풍선 위에 열립니다.

제목 텍스트는 풍선 위쪽 근처에 굵은 글꼴로 표시됩니다.

적용 대상

ShowBalloonTip(Int32, String, String, ToolTipIcon)

지정된 기간 동안 작업 표시줄에 지정된 제목, 텍스트 및 아이콘을 포함하는 풍선 설명을 표시합니다.

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

풍선 설명에 기간이 밀리초 단위로 표시되어야 합니다. 이 매개 변수는 사용되지 않습니다. 이제 알림 표시 시간은 시스템 내게 필요한 옵션 설정에 기반합니다.

tipTitle
String

풍선 설명에 표시할 제목입니다.

tipText
String

풍선 팁에 표시할 텍스트입니다.

tipIcon
ToolTipIcon

ToolTipIcon 값 중 하나입니다.

예외

ArgumentOutOfRangeException

timeout 가 0보다 작습니다.

ArgumentException

tipText이 null 또는 빈 문자열인 경우

InvalidEnumArgumentException

tipIcon는 ToolTipIcon의 멤버가 아닙니다.

예제

다음 코드 예제에서는 ShowBalloonTip 메서드를 사용하는 방법을 보여 줍니다. 이 예제를 실행하려면 라는 가 notifyIcon1포함된 Windows Form에 예제 코드를 붙여넣습니다NotifyIcon. 이 예제의 Form1_DoubleClick 메서드를 폼의 DoubleClick 이벤트와 연결합니다.

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초입니다. 그러나 운영 체제에 따라 달라질 수 있습니다. 너무 크거나 너무 작은 시간 제한 값은 적절한 최소값 또는 최대값으로 조정됩니다. 또한 사용자가 컴퓨터를 사용하지 않는 것처럼 보이는 경우(키보드 또는 마우스 이벤트가 발생하지 않음) 시스템은 이번에는 시간 제한으로 계산되지 않습니다.

한 번에 하나의 풍선 팁만 작업 표시줄에 표시할 수 있습니다. 작업 표시줄에 풍선 팁이 현재 표시되면 풍선 팁을 표시하려고 하면 값이 timeout 무시됩니다. 운영 체제 및 다른에서 풍선 인지에 따라 동작이 약간 다릅니다. 또는 동일한, 애플리케이션입니다. 두 번째 풍선 다른 애플리케이션의 경우 첫 번째 풍선 설명의 값에 관계 없이 두 번째 표시 되기 전에 최소 제한 시간 값 표시 됩니다 timeout합니다. 대부분의 경우에는 동일한 애플리케이션에서 첫 번째 풍선 즉시 팁은 풍선 닫으면 다른 호출 하는 경우에 ShowBalloonTip 메서드 구성 됩니다. 경우에 따라 두 번째 풍선이 첫 번째 풍선 위에 열립니다.

제목 텍스트는 풍선 위쪽 근처에 굵은 글꼴로 표시됩니다.

적용 대상