• manipulated programmatically.
• linked to a data file.
• bound to a variable.

Adding a resource

Example:

// Adds resources into a Scheduler control 
SCH_Schedule1.AddResource("Florence" + gStoredValue("FL"))
SCH_Schedule1.AddResource("Emma" + gStoredValue("EM"))
SCH_Schedule1.AddResource("Fred" + gStoredValue("FR"))

In this example, gStoredValue is used to propose a displayed resource ("Florence", for example) and a resource handled through programming ("FL", for example).

Note: Use <Scheduler>.AddResource to insert an image in the resource title.

Adding an appointment

• syntax for specifying appointment features: title, description, ...
  Example:
  

  // Adds a 1-hour appointment for tonight 
  MyResource is string
  MyTitle is string
  StartAPT is DateTime
  
  MyResource = "Vince"
  MyTitle = "Sales meeting"
  StartAPT = DateSys() + "17000000"
  
  SCH_Scheduler.AddAppointment(MyResource, MyTitle, StartAPT)

• syntax that handles a variable of type Appointment.
  Example:
  

  // Declares an Appointment variable 
  MyAppointment is Appointment
  
  // Fills the appointment
  MyAppointment.Title = "Sales meeting"
  MyAppointment.Content = "Meeting to discuss the weekly objectives."
  MyAppointment.StartDate = "201003220845"
  MyAppointment.EndDate = "201003221230"
  MyAppointment.Category = "Sales"
  MyAppointment.ID = 1
  
  // Adds the appointment into the control
  SCH_Scheduler.AddAppointment(MyAppointment)

Populating a Scheduler control with the data from an HFSQL data file

// Appointment variable 
MyAppointment is Appointment

// Browse the appointments stored in database
FOR EACH APT 
	// Fills the information of the variable
	MyAppointment.Title = APT.Title
	MyAppointment.Content = APT.Content
	MyAppointment.StartDate = APT.StartDate
	MyAppointment.EndDate = APT.EndDate
	MyAppointment.Category = APT.Category
	MyAppointment.ID = APT.APTID

	// Adds the appointment into the Scheduler control
	SCH_MyScheduler.Appointment(MyAppointment)
END

Retrieving a list of appointments

• the list of all the appointments found in the Scheduler control.
  For example:
  

  // Array containing a list of Appointment
  arrAppointmentList is array of Appointment
  
  // Lists of appointments
  arrAppointmentList = SCH_MyScheduler.ListAppointment()

• the list of appointments for a resource included between two dates.
  For example:
  

  // List of appointments for January 2020
  arrAppointmentList is array of Appointment
  
  // Lists of appointments
  arrAppointmentList = SCH_MyScheduler.ListAppointment(MyResource, ...
  			"20200101", "20200131")

• the appointment currently selected or hovered.
  For example:
  

  // Selected appointment
  arrAppointmentList is array of Appointment
  
  arrAppointmentList = SCH_MyScheduler.ListAppointment(schAptSelected)

Deleting an appointment

• the appointment selected in the control.
• a specific appointment.

// Deletes the first appointment
SCH_MyScheduler.DeleteAppointment(1)

Deleting a resource

// Deletes one of the resources
ResDel is boolean
ResDel = SCH_Scheduler1.DeleteResource("Flo") 
IF ResDel = True THEN
	Info("Resource deleted")
END

Modifying the control display options

• <Scheduler>.DisplayPreviousPeriod and <Scheduler>.DisplayNextPeriod: These two functions modify the display period (identical to the spin button at the top of the Scheduler control)..
• <Scheduler>.ChangeMode: Use this function to change the field display mode: day, week, month.
• <Scheduler>.TimeDisplayed: This function is used to define the time period displayed.

• by using the index of the appointment to modify.
• by pointing by reference on the appointment to modify.

APTNum is int
APTNum = 5

// Change the title displayed on the appointment #5
SCH_ROOM[APTNum].Title = "Blue room"

TO is Appointment
TO <- SCH_Room[APTNum]
TO.Title = "New title"

Advanced use of events with procedures

In the code, simply open the window or the page in the "Entry in edit in an appointment" event. To lock the direct input, the event must return False.

This principle can be applied to all the events called by the context menu of the Scheduler control.

Example: Opening an appointment entry window.

PROCEDURE Edit(aptEdited is Appointment)

// Opens the window for entering an appointment 
// with the selected appointment (in Creation or Modification mode)
WIN_EditAPT_HFSQL.Open(aptEdited)

// Returns False to lock the direct input in the Scheduler control
RETURN False