OnBeforeInvokeAppointmentAction Method

Raises the BeforeInvokeAppointmentAction event before the AppointmentAction for an Appointment has been invoked.

Syntax

Visual Basic

'Declaration
 
Protected Overridable Sub OnBeforeInvokeAppointmentAction( _
   ByVal e As CancelableAppointmentEventArgs _
) 

C#

protected virtual void OnBeforeInvokeAppointmentAction( 
   CancelableAppointmentEventArgs e
)

Parameters

e

A CancelableAppointmentEventArgs that provides data for the event.

Remarks

Raising an event invokes the event handler through a delegate.

The OnBeforeInvokeAppointmentAction 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 OnBeforeInvokeAppointmentAction in a derived class, be sure to call the base class's OnBeforeInvokeAppointmentAction method so that registered delegates receive the event.

Example

This example checks the AppointmentAction's Type property to see if the action is set to execute a program if it is, the action's invocation is canceled, and the end user is notified.

For an overview of how to handle events in Visual Basic or Visual C#, see Event Handlers in Visual Basic and Visual C#. For specific information and code examples illustrating how to consume events in your application, see Consuming Events in the .NET Framework Developer's Guide.

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinSchedule
Imports System.Diagnostics

    Private Sub ultraCalendarInfo1_BeforeInvokeAppointmentAction(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinSchedule.CancelableAppointmentEventArgs) Handles ultraCalendarInfo1.BeforeInvokeAppointmentAction

        '----------------------------------------------------------------------------------------------------
        '	Description
        '	BeforeInvokeAppointmentAction
        '
        '	Fires before an Appointment's action is invoked
        '
        '	An Appointment object can be assigned an AppointmentAction via its Action property.
        '	The AppointmentAction can, for example, launch an application when an appointment
        '	becomes due. In this scenario, the BeforeInvokeAppointmentAction would fire prior
        '	the application being launched.
        '
        '----------------------------------------------------------------------------------------------------

        If (e.Appointment.Action.Type = AppointmentActionType.ExecuteProgram) Then
            '	To prevent the removal of the Appointment, set the Cancel
            '	property to true
            e.Cancel = True

            '	Let the end user know what happened
            Dim info As String = String.Empty
            info += "You do not have sufficient permissions to execute programs." + vbCrLf

            MessageBox.Show(info, "BeforeInvokeAppointmentAction", MessageBoxButtons.OK, MessageBoxIcon.Error)
        End If

    End Sub

C#

using System.Diagnostics;
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinSchedule;

		private void ultraCalendarInfo1_BeforeInvokeAppointmentAction(object sender, Infragistics.Win.UltraWinSchedule.CancelableAppointmentEventArgs e)
		{		

			//----------------------------------------------------------------------------------------------------
			//	Description
			//	BeforeInvokeAppointmentAction
			//
			//	Fires before an Appointment's action is invoked
			//
			//	An Appointment object can be assigned an AppointmentAction via its Action property.
			//	The AppointmentAction can, for example, launch an application when an appointment
			//	becomes due. In this scenario, the BeforeInvokeAppointmentAction would fire prior
			//	the application being launched.
			//
			//----------------------------------------------------------------------------------------------------
		
			if ( e.Appointment.Action.Type == AppointmentActionType.ExecuteProgram )
			{
				//	To prevent the removal of the Appointment, set the Cancel
				//	property to true
				e.Cancel = true;

				//	Let the end user know what happened
				string info = string.Empty;
				info += "You do not have sufficient permissions to execute programs." + "\n";

				MessageBox.Show( info, "BeforeInvokeAppointmentAction", MessageBoxButtons.OK, MessageBoxIcon.Error );
			}

		}

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