AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Controles, páginas y ventanas / Funciones del planificador
  • Using the Appointment type
  • Properties specific to Organizer and Scheduler controls
  • Properties specific to the management of Appointment functions
  • Functions that use Appointment variables
WINDEV
WindowsLinuxJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac Catalyst
Otros
Procedimientos almacenados
The type Appointment type lets you define all the advanced features of an appointment: times, location, etc.
This type of variable can be used:
  • WINDEVWEBDEV - Código ServidorWEBDEV - Código NavegadorAndroidWidget Android iPhone/iPadIOS WidgetMac CatalystPHP in an Organizer control or in a Scheduler control. The Appointment type will be handled by the WLanguage functions for managing Organizer controls or the Scheduler controls.
  • AndroidWidget Android iPhone/iPadIOS WidgetMac Catalyst by the functions for appointment management on an Android or iOS device.
You can define and change the characteristics of this appointment using different WLanguage properties.
Note: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
Ejemplo
// Build an Appointment variable
MyAppointment is Appointment

// The appointment starts now and it lasts two hours
MyAppointment.StartDate = DateSys() + TimeSys()
MyAppointment.EndDate = MyAppointment.StartDate
MyAppointment.EndDate.Time = MyAppointment.EndDate.Time + 2

MyAppointment.Title = "Appointment with the sales director"
MyAppointment.Importance = 1
MyAppointment.Guest = "Tommy, Vince, Sandra"
MyAppointment.Content = "Establishing the new price list"
MyAppointment.Note = "Remember to bring the blue folder."
MyAppointment.ToolTip = MyAppointment.Title + CR + MyAppointment.Note

// Add the appointment into the organizer
OrganizerAddAppointment(ORG_MyOrganizer, MyAppointment)
// Adds an appointment by using the Appointment type and with repetition
// Every first Monday of the month 
// a Monday found in days from 1 to 7 of the month = 1st of month.

x is Appointment
x.StartDate = Today() + "1200"
x.EndDate = Today() + "1400"
x.WithRepetition = True
y is Repetition
y.Type = schEveryDay
y.DayOfWeek = 1 
y.DayOfMonth = "1-7" 
y.DayOfMonthOrDayOfWeek = False
x.Repetition = y
OrganizerAddAppointment(ORG_Organizer, x)
AndroidWidget Android iPhone/iPadIOS WidgetMac Catalyst
gAPT is Appointment
gCal is Calendar
arrCalendar is array of Calendar 
// Retrieves the list of calendars
arrCalendar = AppointmentListCalendar()
gCal = arrCalendar[1]

// Add a new appointment into the first calendar
gAPT.Title = EDT_Title
gAPT.StartDate = EDT_StartDate + EDT_StartTime
gAPT.EndDate = EDT_EndDate + EDT_EndTime
gAPT.Location = EDT_Location
gAPT.Content = EDT_Desc
IF EDT_TimeZone <> "" THEN
	gAPT.TimeZone = EDT_TimeZone
END
gAPT.Author = EDT_Author
gAPT.Guest = EDT_Guests
gAPT.WholeDay = CBOX_WholeDay[1]

IF AppointmentAdd(gCal, gAPT) THEN
	ToastDisplay("APT added")
ELSE
	Error(ErrorInfo())
END
Observaciones

Using the Appointment type

The Appointment type can be used to manage the Organizer and Scheduler controls and to manage the contacts via the Appointment functions.
This help page presents:

Properties specific to Organizer and Scheduler controls

The following properties can be used to handle an appointment:
Property nameType usedEffect
AuthorCharacter stringName of appointment author. If this property is not specified, the appointment has no author.
WEBDEV - Código Navegador This property is not available.
BackgroundColorIntegerBackground color used to display the appointment in the Organizer control or in the Scheduler control.
This color can correspond to:If this property is not specified, a color will be automatically calculated. The appointments found in the same category will have the same color.
CategoryCharacter stringCategory of appointment. If this property is not specified, the appointment is associated with no category.
ContentCharacter stringDetailed description of the appointment.
For a Scheduler control (or for an Organizer control), the content is displayed in the control.
If this property is not specified, the appointment has no description.
EndDateCharacter string or DateTime variableEnd date and time of the appointment. A valid date must be assigned to this property before using the variable.
This property must be specified.
Novedad versión 2025
Extra
VariantPermite almacenar información avanzada sin afectar la ejecución de la aplicación. Puede almacenar valores de cualquier tipo (array, etc.). También es posible agregar miembros a la propiedad Extra.
Ejemplo:
MyVariable.Extra.Info1 = Value
MyVariable.Extra[Info2] = Value2
MyVariable.Extra.Date = DateSys()
IDCharacter stringIdentifier associated with the appointment. Allows you to store the identifier of an element that must be associated with the appointment in order to use it later in programming.
For example, this identifier can correspond to the identifier of a record in a database.
ImageCharacter stringImage associated with the appointment. This image is displayed in the Organizer control or in the Scheduler control (in addition to the logo that represents an important appointment if necessary).
This property can correspond to:
  • the path to an image accessible from the current computer,
  • an image file found in the application library,
  • an Image control containing an image,
  • a drawing performed in an Image control with the drawing functions and saved in memory.
If this property is not specified, the appointment has no associated image.
WEBDEV - Código Servidor The image file must be found in the <Project_Name>_WEB directory. The specified path must be relative to this directory.
WEBDEV - Código Navegador This property is not available.
ImportanceIntegerImportance of appointment.
If this property is greater than or equal to 1, an icon (Icon of the important appointment.) will be displayed in the Organizer or Scheduler control to indicate an important event.
If this property is not specified, its value is set to 0.
WEBDEV - Código Navegador This property is not available.
LocationCharacter stringLocation of the appointment.
If this property is not specified, the appointment has no location.
WEBDEV - Código Navegador This property is not available.
NoteCharacter stringNote associated with the appointment.
If this property is not specified, no note is associated with the appointment.
WEBDEV - Código Navegador This property is not available.
OrderIntegerOrder of appointments (for overlapping appointments).
WEBDEV - Código ServidorWEBDEV - Código NavegadorPHP This property is not available.
RepetitionRepetition variableAdvanced parameters of repetition. This property is taken into account only if the WithRepetition property is set to True.
WEBDEV - Código Navegador This property is not available.
ResourceCharacter stringResource associated with the appointment. This property is taken into account only when the appointment is used by a Scheduler control.
StartDateCharacter string or DateTime variableStart date and time of the appointment. A valid date must be assigned to this property before using the variable.
This property must be specified.
TitleCharacter stringAppointment title. The title is displayed in the Organizer control or in the Scheduler control.
If this property is not specified, the appointment has no title.
ToolTipCharacter stringTooltip displayed when the appointment is hovered. By default, this value includes the start time and the end time of appointment as well as the appointment title.
AndroidWidget Android iPhone/iPadIOS WidgetMac Catalyst This property is not available.
WholeDayBoolean
  • True if the appointment is an appointment for the entire day.
  • False otherwise (default value).
WINDEVWEBDEV - Código ServidorWEBDEV - Código NavegadorPHP Attention: For full-day appointments to be correctly displayed in the field, the "Display and allow full-day appointments" option must be checked in the "Detail" tab of the field description..
WithRepetitionBoolean
  • True if the appointment must be repeated,
  • False if the appointment takes place once only.
If the appointment is repeated, the Repetition property allows you to specify the frequency of the repetition.
This property is set to False by default.
WEBDEV - Código Navegador This property is not available.
AndroidWidget Android iPhone/iPadIOS WidgetMac Catalyst

Properties specific to the management of Appointment functions

The following properties can be used to handle an appointment:
Property nameType usedEffect
AuthorCharacter stringName of appointment author. If this property is not specified, the appointment has no author.
iPhone/iPadIOS WidgetMac Catalyst This property is not supported.
CalendarCalendar variable
  • Calendar to which the appointment belongs.
  • Null if the appointment belongs to no calendar.
  • Calendar to which the appointment belongs.
  • Null if the appointment belongs to no calendar.
To add an appointment to a given calendar, use AppointmentAdd.
ContentCharacter stringDetailed description of the appointment.
If this property is not specified, the appointment has no description.
EndDateCharacter string or DateTime variableEnd date and time of the appointment. A valid date must be assigned to this property before using the variable.
The end time of the appointment is always expressed in the time zone associated with the appointment. The name of the time zone is returned by the TimeZone property
GuestCharacter stringList of persons invited to the appointment.
If this property is not specified, the appointment has no guest.
The value of this property has the following format:
<Name guest 1> + TAB + <Email guest 1> + CR + ...
+ CR + <Name guest N> + TAB + <Email guest N>
iPhone/iPadIOS WidgetMac Catalyst This property is read-only.
IDCharacter stringIdentifier associated with the appointment. Allows you to store the identifier of an element that must be associated with the appointment in order to use it later in programming.
This property is read-only. This property is automatically filled when reading the appointment in the corresponding calendar. We do not advise you to store this identifier beyond the lifetime of the application because this identifier can be modified when synchronizing the calendars.
LocationCharacter stringLocation of the appointment.
If this property is not specified, the appointment has no location.
ReminderArray of Reminder variablesArray containing the list of reminders associated with the appointment. If no reminder is associated with the appointment, the array is empty.
StartDateCharacter string or DateTime variableStart date and time of the appointment. A valid date must be assigned to this property before using the variable.
The start time of the appointment is always expressed in the time zone associated with the appointment. The name of the time zone is returned by the TimeZone property
TimeZoneCharacter stringName of time zone for the start and end times of appointment. This name must correspond to the full name of the time zone defined by the IANA Time Zone Database. For example: "Europe/Paris", "Europe/London", "America/New_York", ...
This property is initialized by default with the current time zone. To reinitialize this property with the current time zone, use "" (empty string).
TitleCharacter stringAppointment title.
If this property is not specified, the appointment has no title.
WholeDayBoolean
  • True if the appointment is an appointment for the entire day.
  • False otherwise (default value).
If this property is set to True:
  • the time zone associated with the appointment must correspond to "UTC",
  • the start and end times of the appointments must be set to midnight.
Example: Appointments for July 17, 2012:
Apt is Appointment
Apt.StartDate = "201201170000"
Apt.EndDate = "201201180000"
Apt.WholeDay = True

Functions that use Appointment variables

  • Appointment functions:
    AppointmentAddAgrega una cita:
    • en un calendario Lotus Notes o Outlook.
    • en el calendario de un dispositivo móvil (Android o iOS).
    AppointmentCreateAbre una nueva ventana para crear una cita en la aplicación de calendario nativa del dispositivo.
    AppointmentDeleteDeletes:
    • the current appointment from the calendar of a Lotus Notes or Outlook messaging.
    • an appointment from the calendar found on a mobile device (Android/iOS).
    AppointmentDisplayMuestra una cita en la aplicación nativa de gestión de citas que se encuentra en el dispositivo móvil (Android o iOS).
    AppointmentModifyModifies the current appointment:
    • in a Lotus Notes or Outlook calendar.
    • in the calendar found on a mobile device (Android/iOS).
    AppointmentResetReinitializes:
Versión mínima requerida
  • Versión 16
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/03/2025

Señalar un error o enviar una sugerencia | Ayuda local