Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

OnBeforeDisplayDayToolTip Method (UltraMonthViewMulti)

Raises the BeforeDisplayDayToolTip event before a tooltip for a Day is displayed.
Syntax
'Declaration
 
Protected Overrides Sub OnBeforeDisplayDayToolTip( _
   ByVal e As DayToolTipEventArgs _
) 
protected override void OnBeforeDisplayDayToolTip( 
   DayToolTipEventArgs e
)

Parameters

e
A DayToolTipEventArgs that provides data for the event.
Remarks

Raising an event invokes the event handler through a delegate.

The OnBeforeDisplayDayToolTip method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors: When overriding OnBeforeDisplayDayToolTip in a derived class, be sure to call the base class's OnBeforeDisplayDayToolTip method so that registered delegates receive the event.

Example
NOTE: This example requires that the control's TipStyle property be set to 'Custom', like so:
Me.ultraMonthViewMulti1.TipStyle = Infragistics.Win.UltraWinSchedule.TipStyleDay.Custom
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;
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;
	}

}
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also