Gets or sets a value that determines the insert key action.

Syntax

Visual Basic (Declaration)
<CategoryAttribute("Common Properties")> Public Property InsertKeyMode As InsertKeyMode

Visual Basic (Usage)	Copy Code
Dim instance As UXScheduleView Dim value As InsertKeyMode instance.InsertKeyMode = value value = instance.InsertKeyMode

C#
[CategoryAttribute("Common Properties")] public InsertKeyMode InsertKeyMode {get; set;}

Delphi
public read-write property InsertKeyMode: InsertKeyMode;

JScript
CategoryAttribute("Common Properties") public function get,set InsertKeyMode : InsertKeyMode

Managed Extensions for C++
[CategoryAttribute("Common Properties")] public: __property InsertKeyMode get_InsertKeyMode(); public: __property void set_InsertKeyMode( InsertKeyMode value );

C++/CLI
[CategoryAttribute("Common Properties")] public: property InsertKeyMode InsertKeyMode { InsertKeyMode get(); void set ( InsertKeyMode value); }

Remarks

Data editing in UXScheduleView involves three fundamental processes, Create, Update and Delete (CUD). You can enable each editing feature by setting the property CanUserAddItems, CanUserDeleteItems, CanUserEditItems, CanUserMoveItems, CanUserResizeItems.

Enable Editing	Copy Code
<Intersoft:UXScheduleView DisplayDate="1/2/2012" EventsSource="{Binding Events}" CategoriesSource="{Binding Categories}" ResourcesSource="{Binding Resources}" CanUserAddItems="True" CanUserDeleteItems="True" CanUserEditItems="True" CanUserMoveItems="True" CanUserResizeItems="True"> <Intersoft:UXScheduleDayView/> <Intersoft:UXScheduleWorkWeekView/> <Intersoft:UXScheduleWeekView IsActive="True"/> <Intersoft:UXScheduleMonthView/> </Intersoft:UXScheduleView>

Enable Editing

Copy Code

<Intersoft:UXScheduleView DisplayDate="1/2/2012"
            EventsSource="{Binding Events}" CategoriesSource="{Binding Categories}" ResourcesSource="{Binding Resources}"
            CanUserAddItems="True" CanUserDeleteItems="True" CanUserEditItems="True" CanUserMoveItems="True" CanUserResizeItems="True">
    <Intersoft:UXScheduleDayView/>
    <Intersoft:UXScheduleWorkWeekView/>
    <Intersoft:UXScheduleWeekView IsActive="True"/>
    <Intersoft:UXScheduleMonthView/>
</Intersoft:UXScheduleView>

Inserting an Event

When the CanUserAddItems property is set to true, you will see the Add button in the header area of UXScheduleView. When clicked, a fluid call out that has built-in editing form will appear such as shown in the figure below.

If you prefer to use a custom Add Button, you need to set the AddButtonElement to the desired Add Button element. This allows the editing form's call out to point correctly to your custom Add Button element.

Keyboard Gestures to Add a New Event

Depending on the value of InsertKeyMode property, you can select a single cell or multiple cells and directly type in any characters to insert a new event for that particular date range.

The InsertKeyMode has the following value:

AnyKeys
You can use any alpha numeric key to insert an event.
EnterKey
You need to use enter key to insert an event.
None
Inline inserting is disabled.

When inserting an event using inline editing feature, the event will not be saved until you press the Enter key or focus to another element. To cancel the insertion, simple press Escape key using keyboard. When you press Escape key to cancel the insertion, the control will automatically reselect previously selected cells.

When inserting a new event using inline editing, it requires a predetermined ResourceID that you can customize in PrepareNewItemCommand. Please see Handling the Create, Update and Delete operation for detailed information.

Context Menu

All schedule view controls provide a built-in context menu allowing users to easily add a new event by right clicking on the selected cells.

Notice that you have several insertion options that you can choose, whether you want to create an event or recurring event from the selected date range, or a new all-day event.

Inserting Event Behavior in UXScheduleMonthView

When you inserted an item that overlapped with other events in UXScheduleMonthView, it will try to insert the item in the available space which follow the rendering logic of the events. In the case that it cannot be placed in the available space, it will be placed at the bottom of the event cell until the insertion is committed such as shown in the following figure.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family