UNPKG

typescript-closure-tools

Version:

Command-line tools to convert closure-style JSDoc annotations to typescript, and to convert typescript sources to closure externs files

1,604 lines (1,332 loc) 42.6 kB
// Type definitions for dhtmlxScheduler 4.0 // Project: http://dhtmlx.com/docs/products/dhtmlxScheduler // Definitions by: Maksim Kozhukh <http://github.com/mkozhukh> // Definitions: https://github.com/borisyankov/DefinitelyTyped interface SchedulerTemplates{ /** * specifies the date in the header of the view * @param start the start date of the view * @param end the end date of the view */ agenda_date(start : Date, end : Date): string; /** * specifies the text in the second column of the Agenda view * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ agenda_text(start: Date, end: Date, event: any): string; /** * specifies the date in the first column of the Agenda view * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ agenda_time(start: Date, end: Date, event: any): string; /** * specifies the format for dates that are set by means of API methods. Used to parse incoming dates * @param date the date which needs formatting */ api_date(date: Date): string; /** * specifies the format of the day in a cell * @param date the cell date */ calendar_date(date: Date): string; /** * specifies the date in the header of the calendar * @param date the date which needs formatting */ calendar_month(date: Date): string; /** * specifies the day name in the week sub-header of the view * @param date the date which needs formatting */ calendar_scale_date(date: Date): string; /** * specifies the date format of the lightbox start and end date inputs * @param date the date which needs formatting */ calendar_time(date: Date): string; /** * specifies the date in the header of the Day and Units views * @param date the date which needs formatting */ day_date(date: Date): string; /** * specifies the date in the sub-header of the Day view * @param date the date which needs formatting */ day_scale_date(date: Date): string; /** * specifies the date of an event. Applied to one-day events only * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ event_bar_date(start: Date, end: Date, event: any): string; /** * specifies the event text. Applied to all events * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ event_bar_text(start: Date, end: Date, event: any): string; /** * specifies the css style for the event container * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ event_class(start: Date, end: Date, event: any): string; /** * specifies the time part of the start and end dates of the event. Mostly used by other templates for presenting time periods * @param date the date which needs formatting */ event_date(date: Date): string; /** * specifies the event header * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ event_header(start: Date, end: Date, event: any): string; /** * specifies the event text * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ event_text(start: Date, end: Date, event: any): string; /** * specifies the items of the Y-Axis * @param date the date which needs formatting */ hour_scale(date: Date): string; /** * specifies the format of requests in the dynamic loading mode * @param date the date which needs formatting */ load_format(date: Date): string; /** * specified the date in the header of the view * @param start the start date of the view * @param end the end date of the view */ map_date(start : Date, end : Date): string; /** * specifies the text in the second column of the view * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ map_text(start: Date, end: Date, event: any): string; /** * specifies the date in the first column of the view * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ map_time(start: Date, end: Date, event: any): string; /** * specifies the date of the event in the Google Maps popup marker * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ marker_date(start: Date, end: Date, event: any): string; /** * specifies the text of the event in the Google Maps popup marker * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ marker_text(start: Date, end: Date, event: any): string; /** * specifies the date in the header of the view * @param date the date which needs formatting */ month_date(date: Date): string; /** * specifies the css class that will be applied to a day cell * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ month_date_class(start: Date, end: Date, event: any): string; /** * specifies the format of the day in a cell * @param date the date which needs formatting */ month_day(date: Date): string; /** * specifies the presentation of the 'View more' link in the cell of the Month view * @param date the date of a month cell * @param count the number of events in the cell */ month_events_link(date: Date, count: number): string; /** * specifies the date format of the X-Axis of the view * @param date the date which needs formatting */ month_scale_date(date: Date): string; /** * specifies the content of the pop-up edit form * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ quick_info_content(start: Date, end: Date, event: any): string; /** * specifies the date of the pop-up edit form * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ quick_info_date(start: Date, end: Date, event: any): string; /** * specifies the title of the pop-up edit form * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ quick_info_title(start: Date, end: Date, event: any): string; /** * specifies the drop-down time selector in the lightbox */ time_picker(): string; /** * specifies the format of start and end dates displayed in the tooltip * @param date the date which needs formatting */ tooltip_date_format(date: Date): string; /** * specifies the text of tooltips * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ tooltip_text(start: Date, end: Date, event: any): string; /** * specifies the event text * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object * @param cellDate the date of a day cell that an one-day event or a single occurrence of the recurring event displayes in * @param pos the position a single occurrence in the recurring event: 'start' - the first occurrence, 'end' - the last occurrence, 'middle' - for remaining occurrences */ week_agenda_event_text(start: Date, end: Date, event: any, cellDate: Date, pos: string): string; /** * the date of a day cell of the view * @param date the date which needs formatting */ week_agenda_scale_date(date: Date): string; /** * specified the date in the header of the view * @param start the start date of the view * @param end the end date of the view */ week_date(start : Date, end : Date): string; /** * specifies the css class that will be applied to a day cell * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ week_date_class(start: Date, end: Date, event: any): string; /** * specifies the date in the sub-header of the view * @param date the date which needs formatting */ week_scale_date(date: Date): string; /** * a string from an XML file is converted into a date object in conformity with this template * @param date the string which need to be parsed */ xml_date(date: Date): Date; /** * a date object is converted into a string in conformity with this template. Used to send data back to the server * @param date the date which needs formatting */ xml_format(date: Date): string; /** * specifies the date in the header of the view * @param date the date which needs formatting */ year_date(date: Date): string; /** * specifies the month name in the header of a month block of the view. * @param date the date which needs formatting */ year_month(date: Date): string; /** * specifies the day name in the sub-header of a month block of the view * @param date the date which needs formatting */ year_scale_date(date: Date): string; /** * specifies the tooltip over a day cell containing some scheduled event(s) * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ year_tooltip(start: Date, end: Date, event: any): string; /** * specifies the lightbox header * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ lightbox_header(start: Date, end: Date, event: any): string; /** * specifies the date in the header of the view * @param start the start date of the view * @param end the end date of the view */ grid_date(start : Date, end : Date): string; /** * specifies the format of dates in columns with id='date' * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param ev the event object */ grid_full_date(start: Date, end: Date, ev: any): string; /** * specifies the format of dates in columns with id='start_date' or id='end_date' * @param date the date which needs formatting */ grid_single_date(date: Date): string; /** * specifies the text in the columns * @param field_name the column id * @param event the event object */ grid_field(field_name: string, event: any): string; /** * specifies the number of scheduled events in a cell of the view * @param evs an array of objects of events contained in a cell */ timeline_cell_value(evs: any): string; /** * specifies the css style for a cell of the view * @param evs an array of objects of events contained in a cell (defined only in the 'cell' mode) * @param date the date of a column * @param section the section object */ timeline_cell_class(evs: any, date : Date, section: any): string; /** * specifies the name of a CSS class that will be applied to items of the X-Axis * @param date the date which needs formatting */ timeline_scalex_class(date: Date): string; /** * specifies the name of a CSS class that will be applied to items of the second X-Axis * @param date the date which needs formatting */ timeline_second_scalex_class(date: Date): string; /** * specifies the name of a CSS class that will be applied to items of the Y-Axis * @param key the section id * @param label the section label * @param section the section object that contains the key and label properties */ timeline_scaley_class(key: string, label : string, section: any): string; /** * specifies items of the Y-Axis * @param key the section id (key) * @param label the section label * @param section the section object containing the key and label properties */ timeline_scale_label(key : string, label : string, section : any): string; /** * specifies the tooltip over a day cell containing some scheduled event(s) * @param start the date when an event is scheduled to begin * @param end the date when an event is scheduled to be completed * @param event the event object */ timeline_tooltip(start: Date, end: Date, event: any): string; /** * specifies the date in the header of the view * @param date1 the date when an event is scheduled to begin * @param date2 the date when an event is scheduled to be completed */ timeline_date(date1 : Date, date2 : Date): string; /** * specifies items of the X-Axis * @param date the date which needs formatting */ timeline_scale_date(date: Date): string; /** * specifies items of the second X-Axis * @param date the date which needs formatting */ timeline_second_scale_date(date: Date): string; /** * specifies the date in the header of the view * @param date the date which needs formatting */ units_date(date: Date): string; /** * specifies items of the X-Axis * @param key the unit id (key) * @param label the unit label * @param unit the unit object containing the key and label properties */ units_scale_text(key : string, label : string, unit : any): string; } interface SchedulerConfigOptions{ /** * 'says' to present the numbers of days in the Month view as clickable links that open the related day in the specified view */ active_link_view: string; /** * sets the date to display events until */ agenda_end: Date; /** * sets the date to start displaying events from */ agenda_start: Date; /** * 'says' to show multi-day events in the regular way (as one-day events are displayed) */ all_timed: any; /** * sets the date format that will be used by the addEvent() method to parse the start_date, end_date properties in case they are specified as strings */ api_date: string; /** * enables automatic changing of the end event date after changing the start date */ auto_end_date: boolean; /** * stores a collection of buttons resided in the left bottom corner of the lightbox */ buttons_left: any; /** * stores a collection of buttons resided in the right bottom corner of the lightbox */ buttons_right: any; /** * sets the maximum number of events in a cascade */ cascade_event_count: number; /** * sets the 'cascade' display mode */ cascade_event_display: boolean; /** * sets the left margin for a cascade of events */ cascade_event_margin: number; /** * activates/disables checking of limits */ check_limits: boolean; /** * sets the maximum allowable number of events per time slot */ collision_limit: number; /** * forces the scheduler container to automatically change its size to show the whole content without scrolling */ container_autoresize: boolean; /** * sets the format for the date in the header of the Week and Units views */ day_date: string; /** * enables the possibility to create events by double click */ dblclick_create: boolean; /** * sets the date format used by the templates 'day_date', 'week_date', 'day_scale_date' for setting date in the views' headers */ default_date: string; /** * 'says' to use the extended form while creating new events by drag or double click */ details_on_create: boolean; /** * 'says' to open the extended form after double clicking on an event */ details_on_dblclick: boolean; /** * defines whether the marked(blocked) time spans should be highlighted in the scheduler */ display_marked_timespans: boolean; /** * sets the default background color for the events retrieved by the showEvent() method */ displayed_event_color: string; /** * sets the default font color for the events retrieved by the showEvent() method */ displayed_event_text_color: string; /** * enables the possibility to create new events by drag-and-drop */ drag_create: boolean; /** * enables the possibility to drag the lightbox by the header */ drag_lightbox: boolean; /** * enables the possibility to move events by drag-and-drop */ drag_move: boolean; /** * enables the possibility to resize events by drag-and-drop */ drag_resize: boolean; /** * 'says' to open the lightbox while creating new events */ edit_on_create: boolean; /** * sets the initial duration of events in minutes */ event_duration: number; /** * sets the minimum value for the hour scale (Y-Axis) */ first_hour: number; /** * moves views' tabs from the left to the right side */ fix_tab_position: boolean; /** * enables setting of the event duration to the full day */ full_day: boolean; /** * specifies whether events retrieved by the showEvent method should be highlighted while displaying */ highlight_displayed_event: boolean; /** * sets the format of Y-Axis items */ hour_date: string; /** * sets the height of an hour unit in pixels */ hour_size_px: number; /** * stores a collection of icons visible in the side edit menu of the event box */ icons_edit: any; /** * stores a collection of icons visible in the side selection menu of the event box */ icons_select: any; /** * defines whether the date specified in the 'End by' field should be exclusive or inclusive */ include_end_by: boolean; /** * sets the maximum value of the hour scale (Y-Axis) */ last_hour: number; /** * adds the dotted left border to the scheduler */ left_border: boolean; /** * specifies the lightbox object */ lightbox: any; /** * defines the lightbox behavior while opening in the edit mode */ lightbox_recurring: string; /** * sets the right border of the allowable date range */ limit_end: Date; /** * sets the left border of the allowable date range */ limit_start: Date; /** * sets the max and min values of the time selector in the lightbox to the values of the 'last_hour' and 'first_hour' options */ limit_time_select: boolean; /** * limits viewing events */ limit_view: boolean; /** * sets the format of server request parameters 'from', 'to' in case of dynamic loading */ load_date: string; /** * sets the date to display events until */ map_end: Date; /** * sets the position that will be displayed on the map in case the event location can't be identified */ map_error_position: any; /** * the maximum width of the Google Maps's popup marker in the Map view */ map_infowindow_max_width: number; /** * sets the initial position of the map */ map_initial_position: any; /** * sets the initial zoom of Google Maps in the Map view */ map_initial_zoom: number; /** * activates attempts to resolve the event location if the database doesn't have the event's coordinates stored */ map_resolve_event_location: boolean; /** * enables/disables prompts asking the user to share his location for displaying on the map */ map_resolve_user_location: boolean; /** * sets the date to start displaying events from */ map_start: Date; /** * sets the type of Google Maps */ map_type: any; /** * sets the zoom that will be used to show the user's location if he agrees to the browser offer to show it */ map_zoom_after_resolve: number; /** * enables/disables the marker displaying the current time */ mark_now: boolean; /** * sets the maximum number of displayable in a cell events */ max_month_events: number; /** * specifies the minicalendar object */ minicalendar: any; /** * sets the format for the header of the Month view */ month_date: string; /** * sets the format for the day in a cell of the Month and Year views */ month_day: string; /** * sets the minimum height of cells in the Month view */ month_day_min_height: number; /** * enables rendering of multi-day events */ multi_day: boolean; /** * sets the height of the area that displays multi-day events */ multi_day_height_limit: any; /** * allows working with recurring events independently of time zones */ occurrence_timestamp_in_utc: boolean; /** * defines the 'saving' behaviour for the case when the user edits the event text directly in the event box */ positive_closing: boolean; /** * fixes dnd in case of non-linear time scale */ preserve_length: boolean; /** * cancels preserving of the current scroll position while navigating between dates of the same view */ preserve_scroll: boolean; /** * enables/disables caching of GET requests in the browser */ prevent_cache: boolean; /** * defines whether the event form will appear from the left/right side of the screen or near the selected event */ quick_info_detached: boolean; /** * activates the read-only mode for the scheduler */ readonly: boolean; /** * activates the read-only mode for the lightbox */ readonly_form: boolean; /** * sets the date format of the 'End by' field in the 'recurring' lighbox */ repeat_date: string; /** * prevents including past days to events with the 'weekly' recurrence */ repeat_precise: boolean; /** * sets the initial position of the vertical scroll in the scheduler (an hour in the 24h format) */ scroll_hour: number; /** * shows/hides the select bar in the event box */ select: boolean; /** * allows preventing short events from overlapping */ separate_short_events: boolean; /** * enables converting server-side dates from UTC to a local time zone (and backward) during sending data to the server */ server_utc: boolean; /** * enables showing a progress/spinner while data is loading (useful for dynamic loading) */ show_loading: boolean; /** * sets the start day of weeks */ start_on_monday: boolean; /** * sets the minimum step (in minutes) for event's time values */ time_step: number; /** * enables/disables the touch support in the scheduler */ touch: any; /** * defines the time period in milliseconds that is used to differ the long touch gesture from the scroll gesture */ touch_drag: any; /** * enables/disables prompting messages in the right up corner of the screen */ touch_tip: boolean; /** * 'says' events to occupy the whole width of the cell */ use_select_menu_space: boolean; /** * sets the format for the date in the sub-header of the Month view */ week_date: string; /** * enables/disables displaying the standard (wide) lightbox instead of the short one */ wide_form: boolean; /** * sets the date format that is used to parse data from the data set */ xml_date: string; /** * sets the number of rows in the Year view */ year_x: number; /** * sets the number of columns in the Year view */ year_y: number; } interface SchedulerDateHelpers{ add(origin: Date, count: number, unit: string): Date; copy(origin: Date): Date; date_part(origin: Date): Date; time_part(origin: Date): Date; day_start(origin: Date): Date; month_start(origin: Date): Date; week_start(origin: Date): Date; year_start(origin: Date): Date; getISOWeek(origin: Date): number; getUTCISOWeek(origin: Date): number; date_to_str(format: string): any; str_to_date(format: string): any; convert_to_utc(origin: Date): Date; to_fixed(value: number): string; } interface SchedulerHotkeys{ edit_save: number; edit_cancel: number; } //scheduler.locale interface SchedulerLocaleDate{ month_full: string[]; month_short: string[]; day_full: string[]; day_short: string[]; } interface SchedulerLocaleLabels{ dhx_cal_today_button: string; day_tab: string; week_tab: string; month_tab: string; new_event: string; icon_save: string; icon_cancel: string; icon_details: string; icon_edit: string; icon_delete: string; confirm_closing: string; confirm_deleting: string; section_description: string; section_time: string; } interface SchedulerLocale{ date: SchedulerLocaleDate; labels: SchedulerLocaleLabels; } interface SchedulerSizes{ /** * the height of day cells in the month view */ bar_height: number; /** * the width of the event text input 140 day */ editor_width: number; /** * increases the length of the lightbox */ lightbox_additional_height: number; /** * the width of the date column in the Map view */ map_date_width: number; /** * the width of the description column in the Map view */ map_description_width: number; /** * the left margin of the main scheduler area */ margin_left: number; /** * the bottom margin of the main scheduler area */ margin_top: number; /** * the width of the selection menu */ menu_width: number; /** * the minimal height of the event box */ min_event_height: number; /** * the top offset of an event in a cell in the month view */ month_scale_height: number; /** * the height of the navigation bar */ nav_height: number; /** * the height of the X-Axis */ scale_height: number; /** * the width of the Y-Axis */ scale_width: number; /** * the width of the scrollbar area */ scroll_width: number; } interface SchedulerStatic{ templates: SchedulerTemplates; config: SchedulerConfigOptions; date: SchedulerDateHelpers; keys: SchedulerHotkeys; skin: String; version: String; xy: SchedulerSizes; locale: SchedulerLocale; /** * adds a new event * @param event the event object */ addEvent(event: any): string; /** * adds a new event and opens the lightbox to confirm * @param event the event object */ addEventNow(event: any): string; /** * marks dates but with certain settings makes blocking (unlike blockTime() allows setting custom styling for the limit) * @param config the configuration object of the timespan to mark/block */ addMarkedTimespan(config: any); /** * adds a section to the currently active view (if the opened view isn't Timeline in the 'Tree' mode - the method will be ignored) * @param section the object of the section to add * @param parent_id the id of the parent section. Pass 'null' if you are adding a section to the root */ addSection(section: any, parent_id: string): boolean; /** * attaches the handler to an inner event of dhtmlxScheduler * @param name the event name, case-insensitive * @param handler the handler function */ attachEvent(name: string, handler: (...args: any[])=>any): string; /** * makes the scheduler reflect all data changes in the Backbone model and vice versa * @param events the Backbone data collection */ backbone(events: any); /** * blocks the specified date and applies the default 'dimmed' style to it. * @param date a date to block ( if a number is provided, the parameter will be treated as a week day: '0' index refers to Sunday, '6' - to Saturday) * @param time_points an array <b>[start_minute,end_minute,..,start_minute_N,end_minute_N]</b> where each pair sets a certain limit range. The array can have any number of such pairs * @param items defines specific items of view(s) to block */ blockTime(date: any, time_points: any, items?: any); /** * calls an inner event * @param name the event name, case-insensitive * @param params an array of the event related data */ callEvent(name: string, params: any): boolean; /** * changes the event id * @param id the current event id * @param new_id the new event id */ changeEventId(id: string, new_id: string); /** * checks whether the specified event occurs at the time that has been already occupied with another event(s) * @param event the event object */ checkCollision(event: any): boolean; /** * checks whether an event has some handler(s) specified * @param name the event name */ checkEvent(name: string): boolean; /** * checks whether an event resides in a specific timespan * @param event the event object * @param timespan the timespan type */ checkInMarkedTimespan(event: any, timespan: string): boolean; /** * checks whether the specified event takes place at the blocked time period * @param event the event object */ checkLimitViolation(event: any): boolean; /** * removes all events from the scheduler */ clearAll(); /** * closes all sections in the currently active view (if the opened view isn't Timeline in the 'Tree' mode - the method will be ignored) */ closeAllSections(); /** * closes the specified section in the currently active view (if the opened view isn't Timeline in the 'Tree' mode - the method will be ignored) * @param section_id the section id */ closeSection(section_id: string); /** * collapses the expanded scheduler back to the normal size */ collapse(); /** * creates the Grid view in the scheduler * @param config the configuration object of the Grid view */ createGridView(config: any); /** * creates the Timeline view in the scheduler * @param config the configuration object of the Timeline view */ createTimelineView(config: any); /** * creates the Units view in the scheduler * @param config the configuration object of the Units view */ createUnitsView(config: any); /** * deletes all sections from the currently active view (if the opened view isn't Timeline in the 'Tree' mode - the method will be ignored) */ deleteAllSections(); /** * deletes the specified event * @param id the event id */ deleteEvent(id: any); /** * removes marking/blocking set by the addMarkedTimespan() and blockTime() methods * @param id the timespan id */ deleteMarkedTimespan(id: string); /** * deletes a section from the currently active view (if the opened view isn't Timeline in the 'Tree' mode - the method will be ignored) * @param section_id the section id */ deleteSection(section_id: string): boolean; /** * destroys previously created mini-calendar * @param name the mini-calendar's object (if not specified, the scheduler attempts to destroy the last created mini calendar) */ destroyCalendar(name?: any); /** * detaches a handler from an event (which was attached before by the attachEvent method) * @param id the event id */ detachEvent(id: string); /** * opens the inline editor to alter the event text (the editor in the event box) * @param id the event id */ edit(id: string); /** * closes the inline event edotor if it's currently open * @param id the event id */ editStop(id: string); /** * closes the lightbox * @param mode if set to <i>true</i>, the changes made in the lightbox will be saved before closing. If - <i>false</i>, the changes will be cancelled. * @param box the HTML container for the lightbox */ endLightbox(mode: boolean, box: HTMLElement); /** * expands the scheduler to the full screen view */ expand(); /** * gives access to the objects of lightbox's sections * @param name the name of a lightbox section */ formSection(name: string): any; /** * returns the current cursor-pointed date and section (if defined) * @param e a native event object */ getActionData(e: Event): any; /** * return the event object by its id * @param event_id event_id */ getEvent(event_id: any); /** * gets the event's end date * @param id the event id */ getEventEndDate(id: string): Date; /** * gets the event's start date * @param id the event id */ getEventStartDate(id: string): Date; /** * gets the event's text * @param id the event id */ getEventText(id: string): string; /** * returns a collection of events which occur during the specified period * @param from the start date of the period * @param to the end date of the period */ getEvents(from?: Date, to?: Date); /** * gets the label of a select control in the lighbox * @param property the name of a data property that the control is mapped to * @param key the option id. This parameter is compared with the event data property to assign the select's option to an event */ getLabel(property: string, key: any); /** * gets the lightbox's HTML object element */ getLightbox(): HTMLElement; /** * returns all occurrences of a recurring event * @param id the id of a recurring event * @param number the maximum number of occurrences to return (by default, 100) */ getRecDates(id: string, number: number): any; /** * gets the object of the currently displayable event * @param id the event id */ getRenderedEvent(id: string): HTMLElement; /** * gets the object of the specified section in the currently active view (if the opened view isn't Timeline in the 'Tree' mode - the method will be ignored) * @param section_id the section id */ getSection(section_id: string): any; /** * gets the current state of the scheduler */ getState(): any; /** * gets the user data associated with the specified event * @param id the event id * @param name the user data name */ getUserData(id: string, name: string): any; /** * hides the lightbox modal overlay that blocks interactions with the remaining screen * @param box an element to hide */ hideCover(box?: HTMLElement); /** * hides the pop-up event form (if it's currently active) */ hideQuickInfo(); /** * initializes an instance of dhtmlxScheduler * @param container the id or object of the HTML container that the scheduler will be created inside * @param date the initial date of the scheduler (by default, the current date) * @param view the name of the initial view (by default, "week") */ init(container: any, date?: Date, view?: string); /** * inverts the specified time zones * @param zones an array <b>[start_minute,end_minute,..,start_minute_N,end_minute_N]</b> where each pair sets a certain limit range (in minutes). The array can have any number of such pairs */ invertZones(zones: any); /** * checks whether the calendar is currently open in the scheduler */ isCalendarVisible(): any; /** * checks whether the specified event one-day or multi-day * @param event the event object */ isOneDayEvent(event: any): boolean; /** * 'says' to change the active date in the mini calendar each time the active date in the scheduler is changed * @param calendar the mini calendar object * @param shift a function that defines the difference between active dates in the mini-calendar and the scheduler. The function takes the scheduler's date as a parameter and returns the date that should be displayed in the mini calendar */ linkCalendar(calendar: any, shift: (...args: any[])=>any); /** * loads data to the scheduler from an external data source * @param url the server side url (may be a static file or a server side script which outputs data as XML) * @param type <i>('json', 'xml', 'ical')</i> the data type. The default value - <i>'xml'</i> * @param callback the callback function */ load(url: string, type?: string, callback?: (...args: any[])=>any); /** * applies a css class to the specified date * @param calendar the calendar object * @param date the date to mark * @param css the name of a css class */ markCalendar(calendar: any, date: Date, css: string); /** * marks and/or blocks date(s) by applying the default or a custom style to them. Marking is cancelled right after any internal update in the app. Can be used for highlighting * @param config the configuration object of the timespan to mark/block */ markTimespan(config: any); /** * opens all sections in the currently active view (if the opened view isn't Timeline in the 'Tree' mode - the method will be ignored) */ openAllSections(); /** * opens the specified section in the currently active view (if the opened view isn't Timeline in the 'Tree' mode - the method will be ignored) * @param section_id the section id */ openSection(section_id: string); /** * loads data from a client-side resource * @param data a string or object which represents data * @param type (<i>'json', 'xml', 'ical'</i>) the data type. The default value - <i>'xml'</i> */ parse(data: any, type?: string); /** * creates a mini calendar * @param config the calendar configuration object */ renderCalendar(config: any); /** * generates the HTML content for a custom event box * @param container the event container * @param event the event object */ renderEvent(container: HTMLElement, event: any): boolean; /** * removes the current lightbox's HTML object element */ resetLightbox(); /** * scrolls the specified number of units in the Units view * @param step the number of units to scroll (<i>set the positive value to scroll units in the right direction, the negative value - in the left direction</i>). */ scrollUnit(step: number); /** * selects the specified event * @param id the event id */ select(id: string); /** * returns a list of options * @param list_name the name of a list * @param options an array of options */ serverList(list_name: string, options?: any); /** * displays the specified view and date * @param date the date to display * @param view the name of a view to display */ setCurrentView(date?: Date, view?: string); /** * adds a new event to the scheduler's data pool * @param id the event id * @param event the event object */ setEvent(id: any, event: any); /** * sets the event's end date * @param id the event id * @param date the new end date of the event */ setEventEndDate(id: string, date: Date); /** * set the event's start date * @param id the event id * @param date the new start date of the event */ setEventStartDate(id: string, date: Date); /** * set the event's text * @param id the event id * @param text the new text of the event */ setEventText(id: string, text: string); /** * forces the lightbox to resize */ setLightboxSize(); /** * sets the mode that allows loading data by parts (enables the dynamic loading) * @param mode the loading mode */ setLoadMode(mode: string); /** * sets the user data associated with the specified event * @param id the event id * @param name the user data name * @param value the user data value */ setUserData(id: string, name: string, value: any); /** * shows the lightbox modal overlay that blocks interactions with the remaining screen * @param box an element to hide */ showCover(box?: HTMLElement); /** * shows and highlights the specified event in the current or specified view * @param id the event id * @param view the view name */ showEvent(id: string, view?: string); /** * opens the lightbox for the specified event * @param id the event id */ showLightbox(id: string); /** * displays the pop-up event form for the specified event * @param id the event id */ showQuickInfo(id: string); /** * shows a custom lightbox in the specified HTML container centered on the screen * @param id the event id * @param box the lightbox's HTML container */ startLightbox(id : string, box: HTMLElement); /** * convers scheduler's data to the ICal format * @param header sets the value for the content header field */ toICal(header?: string): string; /** * converts scheduler's data into the JSON format */ toJSON(): string; /** * exports the current view to a PDF document (can be used for printing) * @param url the path to the server-side PDF converter * @param mode the color map of the resulting PDF document */ toPDF(url: string, mode?: string); /** * exports several scheduler's views to a PDF document (can be used for printing) * @param from the date to start export events from * @param to the date to export events until * @param view the name of a view that the export should be applied to * @param path the path to the php file which generates a PDF file (<a href="pdf.md#configuringservice">details</a>) * @param color the color map in use */ toPDFRange(from: Date, to: Date, view: string, path: string, color: string); /** * converts scheduler's data into the XML format */ toXML(): string; /** * generates an unique ID (unique inside the current scheduler, not GUID) */ uid(); /** * removes blocking set by the blockTime() method * @param days (<i>Date, number,array, string</i>) days that should be limited * @param zones the period in minutes that should be limited. Can be set to 'fullday' value to limit the entire day * @param sections allows blocking date(s) just for specific items of specific views. BTW, the specified date(s) will be blocked just in the related view(s) */ unblockTime(days: any, zones?: any, sections?: any); /** * removes a css class from the specified date * @param calendar the mini calendar object * @param date the date to unmark * @param css the name of a css class to remove */ unmarkCalendar(calendar: any, date: Date, css: string); /** * removes marking/blocking set by the markTimespan() method * @param divs a timespan to remove marking/blocking from (or an array of timespans) */ unmarkTimespan(divs: any); /** * unselects the specified event * @param id the event id (if not specified, the currently selected event will be unselected) */ unselect(id?: string); /** * displays the specified date in the mini calendar * @param calendar the mini calendar object * @param new_date a new date to display in the mini calendar */ updateCalendar(calendar: any, new_date: Date); /** * updates tht specified collection with new options * @param collection the name of the collection to update * @param options the new values of the collection */ updateCollection(collection: string, options: any): boolean; /** * updates the specified event * @param id the event id */ updateEvent(id: string); /** * displays the specified view and date (doesn't invokes any events) * @param date the date to set * @param view the view name */ updateView(date: Date, view: string); } declare var scheduler: SchedulerStatic;