PC SOFT

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.
  • Presentación
  • Manejo de la control Agenda mediante programación
  • Añadir una cita
  • Rellenar un control Agenda con los datos encontrados en un archivo de datos HFSQL
  • Recuperación de una lista de citas
  • Visualización de un control Agenda a partir de una fecha específica
  • Borrar una cita
  • Modificar la visualización del control
  • Usando el menú contextual (AAF)
  • Posibilidades de el menú contextual
  • Uso avanzado de eventos con procedimiento
  • Gestión de los días festivos
  • Propiedades específicas de los controles del Organizador
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadApple WatchUniversal Windows 10 App
Otros
Procedimientos almacenados
Presentación
Una control Agenda puede ser:
Para manipular y control Agenda por programación, WINDEV y WEBDEV proponen las funciones OrganizadorXXX.
Esta página de ayuda explica cómo manipular un control Agenda encontrado en una ventana o en una página mediante programación. El ejemplo utilizado en la ilustración permite almacenar las citas en una base de datos HFSQL.
Versiones 24 y posteriores
Android Los controles Agenda ahora están disponibles para aplicaciones Android.
iPhone/iPad Los controles Agenda ahora están disponibles para aplicaciones iPhone/iPad.
Nueva funcionalidad versión 24
Android Los controles Agenda ahora están disponibles para aplicaciones Android.
iPhone/iPad Los controles Agenda ahora están disponibles para aplicaciones iPhone/iPad.
Android Los controles Agenda ahora están disponibles para aplicaciones Android.
iPhone/iPad Los controles Agenda ahora están disponibles para aplicaciones iPhone/iPad.
Observación: A partir de la versión 19, HFSQL es el nuevo nombre de HyperFileSQL.
Versiones 18 y posteriores
WEBDEV - Código Servidor Los controles Agenda ahora están disponibles para sitios WEBDEV (en Windows y Linux).
PHP Los controles Agenda ahora están disponibles para sitios PHP.
Nueva funcionalidad versión 18
WEBDEV - Código Servidor Los controles Agenda ahora están disponibles para sitios WEBDEV (en Windows y Linux).
PHP Los controles Agenda ahora están disponibles para sitios PHP.
WEBDEV - Código Servidor Los controles Agenda ahora están disponibles para sitios WEBDEV (en Windows y Linux).
PHP Los controles Agenda ahora están disponibles para sitios PHP.
Manejo de la control Agenda mediante programación

Añadir una cita

La adición de una cita en una control Agenda la realiza OrganizerAddAppointment. Esta función acepta dos sintaxis:
  • sintaxis utilizada para especificar las características de la cita: título, descripción, ...
    // Adds an appointment to the Organizer control
    OrganizerAddAppointment(ORG_MyOrganizer, "Sales meeting", "201003220845", ...
    "201003221230", "Sales")
  • sintaxis que maneja una variable Cita.
    // 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
    OrganizerAddAppointment(ORG_Organizer, MyAppointment)
La propiedad BackgroundColor de la variable Cita se utiliza para definir un color de visualización para una cita. Si no se define ningún color de fondo, control Agenda utilizará automáticamente el color asociado a la categoría de la cita..

Rellenar un control Agenda con los datos encontrados en un archivo de datos HFSQL

Los registros se almacenan en un archivo de datos HFSQL. El control Agenda se puede rellenar inicialmente navegando por el el archivo de datos mediante la sintaxis FOR EACH y añadiendo cada cita mediante el OrganizerAddAppointment.
// Appointment variable
MyAppointment is Appointment
 
// Browse through the appointments stored in the 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 to the Organizer control
OrganizerAddAppointment(ORG_MyOrganizer, MyAppointment)
 
END
Versiones 16 y posteriores
Recordatorio: También tiene la posibilidad de utilizar un control Agenda relacionado a un archivo de datos. Para obtener más información, consulte control Agenda relacionado a un archivo de datos.
Nueva funcionalidad versión 16
Recordatorio: También tiene la posibilidad de utilizar un control Agenda relacionado a un archivo de datos. Para obtener más información, consulte control Agenda relacionado a un archivo de datos.
Recordatorio: También tiene la posibilidad de utilizar un control Agenda relacionado a un archivo de datos. Para obtener más información, consulte control Agenda relacionado a un archivo de datos.

Recuperación de una lista de citas

OrganizerListAppointment se utiliza para obtener:
  • la lista de todos los nombramientos en la control Agenda:
    // Array containing a list of Appointment
    arrAppointmentList is array of Appointment
     
    // Lists of appointments
    arrAppointmentList = OrganizerListAppointment(ORG_MyOrganizer)
  • la lista de citas incluidas entre dos fechas:
    // List of appointments for January 2010
    arrAppointmentList is array of Appointment
     
    // Lists of appointments
    arrAppointmentList = OrganizerListAppointment(ORG_MyOrganizer, "20100101", "20100131")
  • el nombramiento actualmente seleccionado o en curso de ejecución:
    // Selected appointment
    arrAppointmentList is array of Appointment
     
    arrAppointmentList = OrganizerListAppointment(ORG_MyOrganizer, orgAptSelected)

Visualización de un control Agenda a partir de una fecha específica

Para visualizar la control Agenda a partir de una fecha determinada, utilice OrganizadorPosición.
// Position the Organizer control on today's date
OrganizerPosition(ORG_Organizer1, Today())
 
// Position the Organizer control on December 20, 2012
OrganizerPosition(ORG_Organizer1, "20121220")

Borrar una cita

OrganizadorBorrarCita se utiliza para eliminar:
  • la cita seleccionada en el control.
  • un nombramiento específico.
    // Deletes the first appointment
    OrganizerDeleteAppointment(ORG_MyOrganizer, 1)
OrganizadorBorrarTodo se utiliza para borrar todas las citas que se encuentran en la control Agenda.

Modificar la visualización del control

La visualización actual de una control Agenda se puede modificar mediante las siguientes funciones:
Usando el menú contextual (AAF)
WINDEV

Posibilidades de el menú contextual

El menú desplegable de control Agenda se utiliza para:
  • modificar el modo de visualización del control,
  • añadir, modificar o borrar una cita.
Para grabar las operaciones realizadas, debe utilizar los eventos de control Agenda.
En el evento correspondiente, simplemente recupere la cita actualmente utilizada y realice el proceso correspondiente..
Ejemplo: Para almacenar una cita añadida por el usuario a través de el menú contextual en un archivo de datos APT, simplemente escriba lo siguiente en el caso "Entrada en edición en una cita":
PROCEDURE Edit(aptEdited is Appointment)
 
// Store the data
APT.Title = aptEdited.Title
APT.StartDate = aptEdited.StartDate
APT.EndDate = aptEdited.EndDate
...
HAdd(APT)
El mismo tipo de código puede ser utilizado para los diferentes eventos de la control Agenda. En efecto, un procedimiento ha sido declarado automáticamente por la control Agenda para cada evento en el control que maneja una cita..
Estos procedimientos toman como parámetro una variable Cita. Esta variable contiene las características del nombramiento utilizado por el evento.
WINDEVAndroidiPhone/iPad

Uso avanzado de eventos con procedimiento

También puede permitir que el usuario defina con mayor precisión las características de su cita durante una adición o una modificación.. Para ello, cree una ventana con la información a especificar.
En el código, simplemente abra la ventana en el evento "Entry in edit in an appointment".. Para bloquear la entrada directa mediante el menú contextual de la agenda, el evento debe devolver False.
Este principio puede aplicarse a todos los eventos llamados por la el menú contextual de la control Agenda.
Ejemplo:
PROCEDURE Edit(aptEdited is Appointment)
 
// Opens the window for entering an appointment
// with the selected appointment (in Creation or Modification mode)
Open(WIN_InputAPT_HFSQL, aptEdited)
 
// Returns False to lock the direct input in the Organizer control
RESULT False
Gestión de los días festivos
Los días festivos se gestionan mediante programación. Varias funciones de WLanguage (empezando por BankHolidayXXX) están disponibles.
Para definir los días festivos que aparecen en los controles del Organizador y en los controles del Calendario, debe utilizar BankHolidayAdd. Esta función permite definir la lista de días festivos que se utilizarán. Esta función permite personalizar los días festivos según el país y la normativa local.. Esta función debe utilizarse al principio de la aplicación porque tiene un efecto global sobre la aplicación.
Los días festivos se colorearán de verde en la control Agenda.
Ejemplo:
// Delete all public holidays
BankHolidayDeleteAll()
// Initialize the 11 public holidays common to the French regions and territories
BankHolidayAdd("0101") // 1st of January
BankHolidayAdd(bhEasterMonday) // Easter Monday
BankHolidayAdd("0501") // 1st of May
BankHolidayAdd("0508") // 8th of May
BankHolidayAdd(bhAscensionDay) // Ascension day
BankHolidayAdd(bhWhitMonday) // Whit Monday
BankHolidayAdd("0714") // 14th of July
BankHolidayAdd("0815") // 15th of August (Assumption)
BankHolidayAdd("1101") // All Saints' Day
BankHolidayAdd("1111") // 11th of November
BankHolidayAdd("1225") // Christmas
 
// Add 2 additional public holidays for the regions of Moselle and Alsace
BankHolidayAdd("1226" + CR + bhGoodFriday)
Propiedades específicas de los controles del Organizador
Las siguientes propiedades se utilizan para gestionar un control Agenda a través de la programación.
Versiones 17 y posteriores
DirectInputAPT
Nueva funcionalidad versión 17
DirectInputAPT
DirectInputAPT
La propiedad DirectInputAPT se utiliza para determinar y especificar si el usuario puede cambiar directamente el título de un Appointment en un Programador o control Agenda.
Versiones 15 y posteriores
WorkingHourEnd
Nueva funcionalidad versión 15
WorkingHourEnd
WorkingHourEnd
El WorkingHourEnd Property se utiliza para identificar y modificar la hora de finalización de las horas de trabajo utilizadas:
  • por un control Agenda.
  • por un control Planificador.
  • mediante una columna de diagrama de Gantt (en una tabla o control Tabla TreeView).
Versiones 16 y posteriores
GranularityDuration
Nueva funcionalidad versión 16
GranularityDuration
GranularityDuration
El GranularidadDuración Property se utiliza para get y cambiar el tamaño de la cuadrícula a redimensionar: Citas de * en un control Agenda. Citas de * en un control Planificador. Eventos * en una control Línea de tiempo. Tareas de * en una columna del diagrama de Gantt.
Versiones 16 y posteriores
GranularityMovement
Nueva funcionalidad versión 16
GranularityMovement
GranularityMovement
El GranularidadMovimiento Property se utiliza para get y cambiar el tamaño de la cuadrícula para moverse: Citas de * en un control Agenda. Citas de * en un control Planificador. Eventos * en una control Línea de tiempo. Tareas de * en una columna del diagrama de Gantt.
Versiones 15 y posteriores
GranularityAppointment
Nueva funcionalidad versión 15
GranularityAppointment
GranularityAppointment
El GranularityAppointment obtiene y cambia la precisión de la cuadrícula utilizada para definir las citas en los controles del Organizador o del Programador. Property conservada para compatibilidad con versiones anteriores.
Versiones 15 y posteriores
WorkingHourStart
Nueva funcionalidad versión 15
WorkingHourStart
WorkingHourStart
El WorkingHourStart Property se utiliza para get y cambiar la hora de inicio de las horas de trabajo utilizadas:
  • por un control Agenda.
  • por un control Planificador.
  • mediante una columna de diagrama de Gantt (en una tabla o control Tabla TreeView).
Versiones 16 y posteriores
MaskTitleDate
Nueva funcionalidad versión 16
MaskTitleDate
MaskTitleDate
La MaskTitleDate Property se utiliza para identificar y cambiar la máscara de entrada utilizada para las columnas de título del día en los controles del Organizador o del Programador
Versiones 15 y posteriores
ModificationDurationAPT
Nueva funcionalidad versión 15
ModificationDurationAPT
ModificationDurationAPT
La propiedad ModificationDurationAPT se utiliza para determinar y especificar si el usuario puede modificar la duración de un Appointment en un Programador o control Agenda.
Versiones 17 y posteriores
MovementAPT
Nueva funcionalidad versión 17
MovementAPT
MovementAPT
La propiedad MovementAPT permite saber y especificar si los usuarios pueden mover citas en un control Planificador o Agenda.
Versiones 15 y posteriores
Num1stDayOfTheWeek
Nueva funcionalidad versión 15
Num1stDayOfTheWeek
Num1stDayOfTheWeek
Num1stDayOfTheWeek se utiliza para averiguar y modificar el 1er día de la semana mostrado en:
  • a control Calendario.
  • un control Agenda.
  • un control Planificador.
  • y control Campo de entrada en formato Date con Calendar.
Versiones 17 y posteriores
PeriodSelection
Nueva funcionalidad versión 17
PeriodSelection
PeriodSelection
El PeriodSelection Property se utiliza para determinar y especificar si el usuario puede seleccionar un periodo de tiempo en un Programador o control Agenda.
Para obtener una lista completa de las propiedades de WLanguage que pueden utilizarse con una control Agenda, consulte Propiedades asociadas a la control Agenda.
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