OnBeforeNoteAdded メソッド

Note が Notes コレクションに追加される前に、BeforeNoteAdded イベントを発生させます。

シンタックス

Visual Basic

'宣言
 
Protected Overridable Sub OnBeforeNoteAdded( _
   ByVal e As CancelableNoteEventArgs _
) 

C#

protected virtual void OnBeforeNoteAdded( 
   CancelableNoteEventArgs e
)

パラメータ

e

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

解説

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

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

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

使用例

Visual Basic

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

    Private Sub ultraCalendarInfo1_BeforeNoteAdded(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinSchedule.CancelableNoteEventArgs) Handles ultraCalendarInfo1.BeforeNoteAdded

        '----------------------------------------------------------------------------------------------------
        '	説明
        '	BeforeNoteAdded
        '
        '	新しいメモがコンポーネントの Notes コレクションに追加される前に発生します
        '	キャンセルされる場合、Note が追加されずに、AfterNoteAdded イベントも発生しません
        '
        '----------------------------------------------------------------------------------------------------

        If (e.Note.Day.Notes.Count > 0) Then
            '	Note の追加を回避するには、Cancel プロパティを
            '	True に設定します
            e.Cancel = True

            '	ユーザーに状態を出力します
            Dim info As String = String.Empty
            info += "There is already a Note for " + e.Note.Day.Date.ToLongDateString() + vbCrLf
            info += "Please edit the existing note rather than create a new one."

            MessageBox.Show(info, "BeforeNoteAdded", MessageBoxButtons.OK)
        End If

    End Sub

C#

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

		private void ultraCalendarInfo1_BeforeNoteAdded(object sender, Infragistics.Win.UltraWinSchedule.CancelableNoteEventArgs e)
		{		

			//----------------------------------------------------------------------------------------------------
			//	説明
			//	BeforeNoteAdded
			//
			//	新しいメモがコンポーネントの Notes コレクションに追加される前に発生します
			//	キャンセルされる場合、Note が追加されずに、AfterNoteAdded イベントも発生しません
			//
			//----------------------------------------------------------------------------------------------------

			if ( e.Note.Day.Notes.Count > 0 )
			{
				//	Note の追加を回避するには、Cancel プロパティを
				//	True に設定します
				e.Cancel = true;

				//	ユーザーに状態を出力します
				string info = string.Empty;
				info += "There is already a Note for " + e.Note.Day.Date.ToLongDateString() + ".\n";
				info += "Please edit the existing note rather than create a new one.";

				MessageBox.Show( info, "BeforeNoteAdded", MessageBoxButtons.OK );
			}

		}