OnBeforeDisplayDayToolTip メソッド (UltraMonthViewMulti)

Day のツールチップが表示される前に、BeforeDisplayDayToolTip イベントを発生させます。

シンタックス

Visual Basic

'宣言
 
Protected Overrides Sub OnBeforeDisplayDayToolTip( _
   ByVal e As DayToolTipEventArgs _
) 

C#

protected override void OnBeforeDisplayDayToolTip( 
   DayToolTipEventArgs e
)

パラメータ

e

イベントのデータを提供する DayToolTipEventArgs。

解説

イベントが発生すると、デリゲートを通じてイベント ハンドラーが呼び出されます。

OnBeforeDisplayDayToolTip メソッドを使用すれば、デリゲートを関連付けなくても、派生クラスでイベントを処理できます。これは、派生クラスでイベントを処理する際によく用いられる手法です。

継承時の注意: 派生クラスで OnBeforeDisplayDayToolTip をオーバーライドする場合は、登録されたデリゲートがイベントを受信できるようにするため、必ず基本クラスの OnBeforeDisplayDayToolTip メソッドを呼び出してください。

使用例

NOTE: This example requires that the control's TipStyle property be set to 'Custom', like so:
Me.ultraMonthViewMulti1.TipStyle = Infragistics.Win.UltraWinSchedule.TipStyleDay.Custom

Visual Basic

Private Sub ultraMonthViewMulti1_BeforeDisplayDayToolTip(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinSchedule.DayToolTipEventArgs) Handles ultraMonthViewMulti1.BeforeDisplayDayToolTip

       '	The BeforeDisplayDayToolTip event is a "cancelable" event,
       '	which means that the action to which it corresponds can be
       '	prevented from happening by canceling the event.
       '	
       '	Canceling an event is very simple - just set the 'Cancel'
       '	property of the event arguments to true. The action will then
       '	be prevented from happening, and the corresponding "After"
       '	event will not fire.

       '	If the day for which the tooltip is being displayed is a weekend
       '	day, cancel the event and return, which will prevent tooltips
       '	from being displayed for weekend days
       If (e.Date.DayOfWeek = System.DayOfWeek.Saturday Or _
         e.Date.DayOfWeek = System.DayOfWeek.Sunday) Then
           e.Cancel = True
           Return
       End If

       '	Get the name of the day of the week
       Dim dayOfWeek As String = e.Day.DayOfWeek.LongDescriptionResolved

       '	Determine whether there is activity for the day if there isn't,
       '	we will set the ToolTip property of the event arguments to
       '	"No activity", and return.
       If (Not e.Day.HasActivity) Then
           e.ToolTip = dayOfWeek + ": No activity"
           Return
       Else
           '	The day has activity, determine what kind(s) and how many
           Dim tipText As String = String.Empty
           If (e.Day.Appointments.Count > 0) Then
               tipText += e.Day.Appointments.Count.ToString() + " Appointment(s)" + vbCrLf
           End If
           If (e.Day.Holidays.Count > 0) Then
               tipText += e.Day.Holidays.Count.ToString() + " Holiday(s)" + vbCrLf
           End If

           If (e.Day.Notes.Count > 0) Then
               tipText += e.Day.Notes.Count.ToString() + " Note(s)" + vbCrLf
           End If
           '	Set the ToolTip property to the custom string we built
           e.ToolTip = dayOfWeek + ":" + vbCrLf + tipText
       End If

   End Sub

NOTE: This example requires that the control's TipStyle property be set to 'Custom', like so:
this.ultraMonthViewMulti1.TipStyle = Infragistics.Win.UltraWinSchedule.TipStyleDay.Custom;

C#

private void ultraMonthViewMulti1_BeforeDisplayDayToolTip(object sender, Infragistics.Win.UltraWinSchedule.DayToolTipEventArgs e)
{

	//	The BeforeDisplayDayToolTip event is a "cancelable" event,
	//	which means that the action to which it corresponds can be
	//	prevented from happening by canceling the event.
	//	
	//	Canceling an event is very simple - just set the 'Cancel'
	//	property of the event arguments to true. The action will then
	//	be prevented from happening, and the corresponding "After"
	//	event will not fire.

	//	If the day for which the tooltip is being displayed is a weekend
	//	day, cancel the event and return, which will prevent tooltips
	//	from being displayed for weekend days
	if ( e.Date.DayOfWeek == System.DayOfWeek.Saturday ||
		 e.Date.DayOfWeek == System.DayOfWeek.Sunday )
	{
		e.Cancel = true;
		return;
	}

	//	Get the name of the day of the week
	string dayOfWeek = e.Day.DayOfWeek.LongDescriptionResolved;

	//	Determine whether there is activity for the day; if there isn't,
	//	we will set the ToolTip property of the event arguments to
	//	"No activity", and return.
	if ( ! e.Day.HasActivity )
	{
		e.ToolTip = dayOfWeek + ": No activity";
		return;
	}
	else
	{
		//	The day has activity, determine what kind(s) and how many
		string tipText = string.Empty;
		if ( e.Day.Appointments.Count > 0 )
			tipText += e.Day.Appointments.Count.ToString() + " Appointment(s)" + "\n";
		if ( e.Day.Holidays.Count > 0 )
			tipText += e.Day.Holidays.Count.ToString() + " Holiday(s)" + "\n";
		if ( e.Day.Notes.Count > 0 )
			tipText += e.Day.Notes.Count.ToString() + " Note(s)" + "\n";

		//	Set the ToolTip property to the custom string we built
		e.ToolTip = dayOfWeek + ":" + "\n" + tipText;
	}

}