終日イベントの予定を作成する

  • [アーティクル]

この例では、AllDayEvent プロパティを使用して終日イベントである予定を作成する方法を説明します。

例

注:

次のコード サンプルは、『Programming Applications for Microsoft Office Outlook 2007』からの抜粋です。

イベントは、24 時間以上継続するアクティビティである点が定期的な予定とは異なります。 イベントの例としては、展示会、セミナー、休暇などがあります。 イベントおよび例年のイベントは、ユーザーの予定表では時間のブロックを占めるアイテムとしては表示されません。 代わりに、バナーとして表示されます。 バナーは、予定表の日ビューまたは週ビューの最上部に表示されます。 終日の予定の場合、既定では、そのユーザーの時間は他のユーザーに対しては "予定あり" として表示されますが、イベントまたは例年のイベントの場合はユーザーの時間は "空き" として表示されます。

終日イベントをプログラムで作成する場合は、AppointmentItem オブジェクトの AllDayEvent プロパティを true に設定します。 その後で、AppointmentItem の Start プロパティと End プロパティを設定します。 AllDayEvent プロパティを true に設定し、 Start および End プロパティを設定しないと、イベントはその日に発生し、予定として扱われ、予定表には予定あり状態が表示されます。 将来の日付でイベントが発生するようにする場合は、Start プロパティと End プロパティを設定する必要があります。

注:

予定を終日イベントにするには、Start プロパティをイベントが開始する日の 12:00 A.M. (午前 0 時) に設定し、End プロパティをイベントが終了する日の翌日の 12:00 A.M. に設定します。 Start または End の時刻を午前 12 時 00 分以外の日時値に設定すると、その予定は終日イベントではなく、複数日のイベントになります。

たとえば、イベントの期間が 1 日だけの場合は、Start プロパティをイベント当日の 12:00 A.M. に設定し、End プロパティをイベントの翌日の 12:00 A.M. に設定します。 End プロパティは、常に、開始日より 1 日以上後の 12:00 A.M. に設定する必要があります。

次のコード例の AllDayEventExample では、2007 年 6 月 11 日に開始し、2007 年 6 月 15 日に終了する終日イベントを作成しています。 End プロパティが 2007 年 6 月 16 日の 12:00 A.M. に設定されていることに注意してください。

Visual Studio を使用してこのコード例をテストする場合、Microsoft.Office.Interop.Outlook 名前空間をインポートするときに、まず Microsoft Outlook 15.0 オブジェクト ライブラリ コンポーネントへの参照を追加し、Outlook 変数を指定します。 using ステートメントは、コード例の関数の前に直接置くことはできません。パブリッククラス宣言の前に追加する必要があります。 次のコード行は、C# でインポートおよび割り当てを行う方法を示しています。

using Outlook = Microsoft.Office.Interop.Outlook;

private void AllDayEventExample()
{
    Outlook.AppointmentItem appt = Application.CreateItem(
        Outlook.OlItemType.olAppointmentItem)
        as Outlook.AppointmentItem;
    appt.Subject = "Developer's Conference";
    appt.AllDayEvent = true;
    appt.Start = DateTime.Parse("6/11/2007 12:00 AM");
    appt.End = DateTime.Parse("6/16/2007 12:00 AM");
    appt.Display(false);
}

関連項目