/**
 * BBjCalendarWidget
 * @author ndecker
 *
 * The <code>BBjCalendarWidget</code> is a BBj Interface that serves as a plug-in to the
 * <a href = 'https://fullcalendar.io/' target = '_blank'>FullCalendar</a> JavaScript-based calendar control.
 *
 * For the full copyright and license information, please see the LICENSE.txt files distributed with this source code in the appropriate lib directory.
 *
 * @see <a href = 'https://fullcalendar.io' target = '_blank'>FullCalendar</a> for further information on the underlying JavaScript-based calendar.
 *
 * @since BBj 21.00
*/
package BBjCalendarWidget;
import java.util.HashSet;
import java.util.HashMap;
import java.util.TreeMap;
import java.io.File;
import java.util.Vector;
import com.google.gson.Gson;
import com.google.gson.JsonParser;
import com.google.gson.JsonObject;
import com.google.gson.JsonArray;
import com.google.gson.JsonPrimitive;
import com.google.gson.JsonElement;
import com.google.gson.GsonBuilder;
/**
 * <code>BBjCalendarWidget</code> is a BBj Interface that serves as a plug-in to the
 * <a href = 'https://fullcalendar.io/' target = '_blank'>FullCalendar</a> JavaScript-based calendar control.
 * <p>
 * For the full copyright and license information, please view the LICENSE file that was distributed with this source code.
 *
 * <code>THROW</code>n Error Codes:
 * <ul>
 * <li><b><code>500</code></b>: The calendar is not ready for interaction. Setting a callback for the
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_READY' target = '_blank'>CalendarAPI.ON_CALENDAR_READY</a></code> event
 * will result in your application getting a <code><a href = 'CalendarReadyEvent.html' target = '_blank'>CalendarReadyEvent</a></code>
 * event signaling that the calendar is ready for interaction.</li>
 * <li><b><code>510</code></b>: Invalid theme specified. The specified theme file does not exist.
 * See the <code><a href = 'BBjCalendarWidget.html#getThemes' target = '_blank'>getThemes()</a></code> method for more
 * information on installing and getting valid theme names.</li>
 * <li><b><code>512</code></b>: Invalid parameter. The parameter provided to a method is null() or invalid. The error message may indicate which method call failed.</li>
 * <li><b><code>514</code></b>: Invalid configuration. The specified object has not been configured correctly or is missing required properties.</li>
 * <li><b><code>530</code></b>: Invalid date or time specified. The specified date or time string is not valid or cannot be parsed.</li>
 * <li><b><code>700</code></b>: Missing file. The specified file does not exist. This may occur when the library attempts to read in an HTML, CSS, JavaScript, or theme file.</li>
 * </ul>
 *
 * @see <a href = 'https://fullcalendar.io/' target = '_blank'>FullCalendar</a> for information on the FullCalendar JavaScript-based calendar control.
 *
 * @since BBj 21.00
*/
public interface BBjCalendarWidget {
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the <code>BBjCalendarWidget</code> is ready.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarReadyEvent.html' target = '_blank'>CalendarReadyEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_READY() { }
/**
 * <p>
 * <b>Note</b>: This <b>only</b> fires when the type of view changes, not when the user changes the view from one subtype to another. For example,
 * the event <b>will</b> be triggered when the user switches from the
 * <code><a href = 'CalendarAPI.html#CALENDAR_VIEW_DAY_GRID_MONTH' target = '_blank'>CalendarAPI.CALENDAR_VIEW_DAY_GRID_MONTH()</a></code> to the
 * <code><a href = 'CalendarAPI.html#CALENDAR_VIEW_LIST_MONTH' target = '_blank'>CalendarAPI.CALENDAR_VIEW_LIST_MONTH()</a></code> view. But it <b>won't</b> be triggerd when the user changes from
 * <code><a href = 'CalendarAPI.html#CALENDAR_VIEW_DAY_GRID_MONTH' target = '_blank'>CalendarAPI.CALENDAR_VIEW_DAY_GRID_MONTH()</a></code> to
 * <code><a href = 'CalendarAPI.html#CALENDAR_VIEW_DAY_GRID_WEEK' target = '_blank'>CalendarAPI.CALENDAR_VIEW_DAY_GRID_WEEK()</a></code> since both views are
 * the same type (dayGrid) and just the subtype (week vs. month) changes.
*/
public static BBjNumber ON_CALENDAR_VIEW_CHANGE() { }
/**
 * If you set a callback for this event, then add several entries to the calendar, your callback routine may be flooded because the event will fire for every entry that you add.
 * <p>
 * When responding to this event, the <code><a href = 'https://documentation.basis.com/BASISHelp/WebHelp/bbjobjects/bbjapi/bbjapi_getlastevent.htm' target = '_blank'>BBjAPI().getLastEvent()</a></code> call
 * will return a <code><a href = 'CalendarEntriesSetEvent.html' target = '_blank'>CalendarEntriesSetEvent</a></code> object.
 * You can call the <code><a href = 'CalendarEntriesSetEvent.html#getEntries' target = '_blank'>CalendarEntriesSetEvent::getEntries()</a></code> method to return a BBjVector of
 * <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects that corresponds to all the known entries in the calendar at that instant in time.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntriesSetEvent.html' target = '_blank'>CalendarEntriesSetEvent</a></code> object.
 *
 * @see <a href = 'https://documentation.basis.com/BASISHelp/WebHelp/index.htm#gridctrl/bbjvector_bbj.htm' target = '_blank'>BBjVector</a>.
*/
public static BBjNumber ON_CALENDAR_ENTRIES_SET() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user has clicked on a calendar's event.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryClickEvent.html' target = '_blank'>CalendarEntryClickEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_CLICK() { }
/**
 * <p>
 * <b>Note</b>: If you set a callback for this event, then add several events to the calendar, your callback routine may be flooded.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryAddEvent.html' target = '_blank'>CalendarEntryAddEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_ADD() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the calendar's event data has changed in any way.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryChangeEvent.html' target = '_blank'>CalendarEntryChangeEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_CHANGE() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that an entry has been removed from the calendar.
 * If you set a callback for this event, then remove several entries from the calendar, your callback routine may be flooded because
 * the event will fire for every entry that was removed.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryRemoveEvent.html' target = '_blank'>CalendarEntryRemoveEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_REMOVE() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user moved the mouse into the bounds of a calendar event.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryMouseEnterEvent.html' target = '_blank'>CalendarEntryMouseEnterEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_MOUSE_ENTER() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user moved the mouse out of the bounds of a calendar event.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarEntryMouseLeaveEvent.html' target = '_blank'>CalendarEntryMouseLeaveEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_ENTRY_MOUSE_LEAVE() { }
/** A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user has started dragging an event. */

public static BBjNumber ON_CALENDAR_ENTRY_DRAG_START() { }
/** A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user has stopped dragging an event. */

public static BBjNumber ON_CALENDAR_ENTRY_DRAG_STOP() { }
/** A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user has started resizing an event. */

public static BBjNumber ON_CALENDAR_ENTRY_RESIZE_START() { }
/** A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user has stopped resizing an event. */

public static BBjNumber ON_CALENDAR_ENTRY_RESIZE_STOP() { }
/** A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user has stopped resizing an event and the event has a different duration. */

public static BBjNumber ON_CALENDAR_ENTRY_RESIZE() { }
/** A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user has dropped the event to a different day/time. */

public static BBjNumber ON_CALENDAR_ENTRY_DROP() { }
/** A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the calendar has received an external draggable element with event data from another source or another calendar. */

public static BBjNumber ON_CALENDAR_ENTRY_RECEIVE() { }
/** A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user is about to drop one of the calendar events on to another calendar. */

public static BBjNumber ON_CALENDAR_ENTRY_LEAVE() { }
/** A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that fetching a <code>CalendarEntrySource</code> succeeded. */

public static BBjNumber ON_CALENDAR_ENTRY_SOURCE_SUCCESS() { }
/** A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that fetching a <code>CalendarEntrySource</code> failed. */

public static BBjNumber ON_CALENDAR_ENTRY_SOURCE_FAILURE() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the calendar's date range has changed in any way.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarDatesSetEvent.html' target = '_blank'>CalendarDatesSetEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_DATES_SET() { }
/**
 * <p>
 * Note that <code>ON_CALENDAR_DATE_CLICK</code> event is not fired when the user clicks a day heading in a list view.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarDateClickEvent.html' target = '_blank'>CalendarDateClickEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_DATE_CLICK() { }
/**
 * <p>
 * <b>Note</b>: You must configure the calendar to enable user selections via the <code>CalendarOptions:setEnableSelectable()</code> method
 * if you intend to set a callback for the <code>BBjCalendarWidget:ON_CALENDAR_SELECT</code> or <code>BBjCalendarWidget:ON_CALENDAR_UNSELECT</code> events.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarSelectEvent.html' target = '_blank'>CalendarSelectEvent</a></code> object.
*/
public static BBjNumber ON_CALENDAR_SELECT() { }
/**
 * <p>
 * <b>Note</b>: You must configure the calendar to enable user selections via the <code>CalendarOptions:setEnableSelectable()</code> method
 * if you intend to set a callback for the <code>BBjCalendarWidget:ON_CALENDAR_SELECT</code> or <code>BBjCalendarWidget:ON_CALENDAR_UNSELECT</code> events.
 * <p>
 * A selection might be cleared for a number of reasons:
 * <ul>
 * <li>The user clicks away from the current selection (doesn't happen when EnableUnselectAuto is false).</li>
 * <li>The user makes a new selection. The unselect callback will be fired before the new selection occurs.</li>
 * <li>The user moves forward or backward in the current view, or switches to a new view.</li>
 * <li>The unselect method is called through the API.</li>
 * </ul>
 * <p>
 * The <code>CalendarOptions::setEnableUnselectAuto()</code> impacts what causes the <code>BBjCalendarWidget.ON_CALENDAR_UNSELECT</code> event to be fired.
 * If automatic unselection is enabled, then the unselection event will typically be fired after the user releases their selection mouse button.
 * <p>
 * Setting a callback for this event type will result in your application getting a <code><a href = 'CalendarUnselectEvent.html' target = '_blank'>CalendarUnselectEvent</a></code>.
*/
public static BBjNumber ON_CALENDAR_UNSELECT() { }
/**
 * A constant value that's used with the <code><a href = 'BBjCalendarWidget.html#setCallback' target = '_blank'>BBjCalendarWidget::setCallback()</a></code> method that signals that the user dropped an external draggable element or an event from another calendar onto this calendar.
*/
public static BBjNumber ON_CALENDAR_DROP() { }
/**
 * Returns a unique auto-generated ID for the calendar instance that may be used to distinguish between instances of the class.
 *
 * @return BBjString The calendar's unique ID.
*/
public BBjString getUuid() { }
/**
 * Returns the underlying BBjHtmlView control that contains the JavaScript FullCalendar.
 *
 * @return BBjHtmlView The underlying BBjHtmlView control that contains the JavaScript FullCalendar.
 *
 * @see <a href = 'https://documentation.basis.com/BASISHelp/WebHelp/gridctrl2/bbjhtmlview.htm' target = '_blank'>BBjHtmlView</a> for more information on the BBjHtmlView control.
*/
public BBjHtmlView getHtmlView() { }
/**
 * Returns a BBjNumber acting as a boolean that indicates whether the widget is ready to be interacted with (1) or not (0).
 *
 * @return BBjNumber A BBjNumber acting as a boolean that indicates whether the widget is ready to be interacted with (1) or not (0).
*/
public BBjNumber getIsReady() { }
/**
 * Sets whether the <code>BBjCalendarWidget</code> should run in debug mode (1) or not (0), where the default is 0.
 * <p>
 * When this is set to true (1), the <code>BBjCalendarWidget</code> will:
 * <ul>
 * <li>use unminified JavaScript and CSS when possible</li>
 * <li>display the debugger console in a browser when run in GUI if your <code>!CHROMIUM_SWITCHES</code> global string entry is properly set before instantiating the <code>BBjCalendarWidget</code>, as in: <code>chromium_switches$ = stbl("!CHROMIUM_SWITCHES", "--remote-debugging-port = 9223")</code></li>
 * <li>log messages to the console from both the BBj programs and the JavaScript code</li>
 * </ul>
 *
 * @param BBjNumber enableDebug A BBjNumber acting as a boolean that determines whether the <code>BBjCalendarWidget</code> should run in debug mode (1) or not (0).
*/
public void setEnableDebug(BBjNumber enableDebug) { }
/**
 * Returns whether the <code>BBjCalendarWidget</code> should run in debug mode (1) or not (0).
 *
 * @return BBjNumber A BBjNumber acting as a boolean that indicates whether the <code>BBjCalendarWidget</code> is running in debug mode.
*/
public BBjNumber getEnableDebug() { }
/**
 * Sets the calendar's options given an instance of the <code><a href = 'CalendarOptions.html' target = '_blank'>CalendarOptions</a></code> class.
 * <p>
 * <b>Note</b>: After setting the calendar's options inline (see example #1 below), you will need to call the calendar's <code>render()</code> method to apply the changes to the calendar in order for them to take effect.
 * <p>
 * There are a couple of ways to set options for the calendar:
 *
 * 1) Get and then set the desired options inline dynamically, calling the render() method afterwards to force the calendar to update with the new configuration:
 * <blockquote><pre><code><div style = 'background:#E1E6EA; border:1px solid #000; border-radius:1em; padding:0 1em;'>
 *
 * <i><span style = 'color:#080;'>rem Get and then set the desired options inline dynamically, calling the render() method afterwards to force the calendar to update with the new configuration:</span></i>
 * myCal!.getOptions().setEnableEntryDurationEditable(1)
 * myCal!.getOptions().setEnableEntryResizableFromStart(1)
 * myCal!.getOptions().setEnableEntryStartEditable(1)
 * myCal!.getOptions().setEnableSlotEntryOverlap(0)
 * myCal!.render()
 * </div></code></pre></blockquote>
 *
 * 2) Get the options instance, call setter methods on it, then use it to set the calendar's options:
 * <blockquote><pre><code><div style = 'background:#E1E6EA; border:1px solid #000; border-radius:1em; padding:0 1em;'>
 *
 * <i><span style = 'color:#080;'>rem Get the calendar's options object, then call the desired set methods, then apply the updated options to the calendar:</span></i>
 * opts! = myCal!.getOptions()
 * opts!.setEnableEntryDurationEditable(1)
 * opts!.setEnableEntryResizableFromStart(1)
 * opts!.setEnableEntryStartEditable(1)
 * opts!.setEnableSlotEntryOverlap(0)
 * myCal!.setOptions(opts!)
 * </div></code></pre></blockquote>
 *
 * @param CalendarOptions options! An instance of the <code><a href = 'CalendarOptions.html' target = '_blank'>CalendarOptions</a></code> class that has been configured with the desired settings.
*/
public void setOptions(CalendarOptions options!) { }
/**
 * Returns the calendar's current options in an instance of the <code><a href = 'CalendarOptions.html' target = '_blank'>CalendarOptions</a></code> class.
 *
 * @return CalendarOptions
*/
public CalendarOptions getOptions() { }
/**
 * Injects the provided CSS string into the <code>&lt;head&gt;</code> element of the HTML document in the BBjHtmlView that contains the calendar.
 * <p>
 * This method provides a simple way to add custom CSS that affects the calendar. For more advanced use cases, see the
 * <code><a href = 'BBjCalendarWidget.html#injectCss' target = '_blank'>injectCss()</a></code> method that takes several
 * parameters to provide greater control over the injection.
 *
 * @param BBjString css! The CSS to inject into the BBjHtmlView's DOM.
*/
public void injectCss(BBjString css!) { }
/**
 * Injects the provided CSS string into the <code>head</code> or <code>body</code> of the HTML DOM (as specified by the location! parameter)
 * in the BBjHtmlView that contains the calendar, as well as providing the ability to tag the CSS and replace it in subsequent calls.
 *
 * @param BBjString css! The CSS to inject into the BBjHtmlView's DOM.
 * @param BBjString location! The target for injection which can be 'head' or 'body'. If it's an empty string, it will default to 'body'.
 * @param BBjString description! The description of the CSS, which is used to replace it in subsequent calls.
 * @param BBjNumber removePrevious! A BBjNumber acting as a boolean that determines whether the CSS should replace existing CSS with the same description.
*/
public void injectCss(BBjString css!, BBjString location!, BBjString description!, BBjNumber removePrevious!) { }
/**
 * Injects the CSS contained in the specified file into the <code>&lt;head&gt;</code> element of the HTML document in the BBjHtmlView that contains the calendar.
 * This is a convenience method that reads in the contents of the provided CSS file and injects it into the HtmlView control that contains the calendar.
 *
 * @param BBjString cssPath! A string representing the full path and filename of the file that contains the CSS to be injected.
*/
public void injectCssFile(BBjString cssPath!) { }
/**
 * Injects the provided JavaScript string at the top-level window.
 *
 * @param BBjString script! The JavaScript to inject into the BBjHtmlView.
 * @see <a href = 'https://documentation.basis.com/BASISHelp/WebHelp/index.htm#sysguicontmethods/bbjhtmlview/bbjhtmlview_injectscript.htm' target = '_blank'>BBjHtmlView::injectScript</a>.
*/
public void injectScript(BBjString script!) { }
/**
 * Injects the JavaScript contained in the specified script file into the top-level window. This is a convenience method
 * that reads in the contents of the provided JavaScript file and injects it into the HtmlView control that contains the calendar.
 *
 * @param BBjString scriptPath! A string representing the full path and filename of the file that contains the JavaScript to be injected.
 * @see <a href = 'https://documentation.basis.com/BASISHelp/WebHelp/index.htm#sysguicontmethods/bbjhtmlview/bbjhtmlview_injectscript.htm' target = '_blank'>BBjHtmlView::injectScript</a>.
*/
public void injectScriptFile(BBjString scriptPath!) { }
/**
 * Injects the specified JavaScript URL into the HTML DOM, making it available for subsequent use by client-side JavaScript.
 *
 * @param BBjString url! The URL string containing JavaScript to be injected into the HTML DOM.
*/
public void injectUrl(BBjString url!) { }
/**
 * Executes the provided JavaScript via the BBjJavaScriptExecutor class which results in a debounced execution, which
 * is useful when you don't need the return value from the script and the script can be batched with other scripts. If you
 * need the return value from the script, then you need to call the
 * <code><a href = 'BBjCalendarWidget.html#executeScriptImmediately' target = '_blank'>executeScriptImmediately()</a></code> method instead.
 * <p>
 * <b>Note</b>: The executor handles JSNI automatically so you don't have to check for BUI and adjust the window and document JavaScript objects.
 *
 * If the BBjHtmlView is not ready yet then the script will be queued. After the BBjHtmlView control is ready then the executor will execute it on the client.
 *
 * @param BBjString script$ The JavaScript code to execute.
 *
 * @return Object The result of the JavaScript code execution if the script returns a value.
*/
public Object executeScript(BBjString script!) { }
/**
 * Executes the provided JavaScript immediately via the BBjJavaScriptExecutor class without debouncing, which
 * is necessary when you need the return value from the script.
 * <p>
 * <b>Note</b>: The executor handles JSNI automatically so you don't have to check for BUI and adjust the window and document JavaScript objects.
 *
 * If the BBjHtmlView is not ready then this method will throw an error 500. Setting a callback for the
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_READY' target = '_blank'>CalendarAPI.ON_CALENDAR_READY</a></code>
 * will result in your application getting a <code><a href = 'CalendarReadyEvent.html' target = '_blank'>CalendarReadyEvent</a></code>
 * event signaling that the calendar is ready for interaction.
 *
 * @param BBjString script$ The JavaScript code to execute.
 *
 * @return Object The result of the JavaScript code execution if the script returns a value.
*/
public Object executeScriptImmediately(BBjString script!) { }
/**
 * Supresses JavaScript debouncing for BUI.
 * <p>
 * Setting this to "0" may help to improve the communication performance between BBj and the calendar in the BBjHtmlViewControl when running in BUI.
 *
 * @param BBjNumber suppress! A BBjNumber acting as a boolean that determines whether the BBjJavaScriptExecutor should disable debouncing or not where 1 = suppressDebouncing and 0 = doNotSuppressDebouncing (default).
 *
 * @see <a href = '#render'>#suppressDebouncing()</a>.
 * @see <a href = '#render'>#suppressGuiDebouncing()</a>.
*/
public void suppressBuiDebouncing(BBjNumber suppress!) { }
/**
 * Supresses JavaScript debouncing when running in GUI.
 * <p>
 * Setting this to "0" may help to improve the communication performance between BBj and the calendar in the BBjHtmlViewControl when running in GUI.
 *
 * @param BBjNumber suppress! A BBjNumber acting as a boolean that determines whether the BBjJavaScriptExecutor should disable debouncing or not where 1 = suppressDebouncing and 0 = doNotSuppressDebouncing (default).
 *
 * @see <a href = '#render'>#suppressDebouncing()</a>.
 * @see <a href = '#render'>#suppressBuiDebouncing()</a>.
*/
public void suppressGuiDebouncing(BBjNumber suppress!) { }
/**
 * Supressesss JavaScript debouncing for both GUI and BUI.
 *
 * @param BBjNumber suppress! A BBjNumber acting as a boolean that determines whether the BBjJavaScriptExecutor should disable debouncing or not where 1 = suppressDebouncing and 0 = doNotSuppressDebouncing (default).
 *
 * @see <a href = '#render'>#suppressBuiDebouncing()</a>.
 * @see <a href = '#render'>#suppressGuiDebouncing()</a>.
*/
public void suppressDebouncing(BBjNumber suppress!) { }
/**
 * Renders the calendar inside the HtmlView and applies the current calendar options.
 * <p>
 * This composes the calendar configuration and sends it to the client for a full rerendering. This is the
 * difference between the <code>render()</code> and the <code>redraw()</code> method - the <code>redraw()</code> method
 * only instructs the calendar to repaint itself; it doesn't change or apply any configuration options.
 * <p>
 * You can call this method to force the calendar to be updated after you modify its setup configuration, as in:
 *
 * <blockquote><pre><code><div style = 'background:#E1E6EA; border:1px solid #000; border-radius:1em; padding:0 1em;'>
 *
 * <i><span style = 'color:#080;'>rem Get and then set the desired options inline dynamically, calling the render() method afterwards to force the calendar to update with the new configuration:</span></i>
 * myCal!.getOptions().setEnableEntryDurationEditable(1)
 * myCal!.getOptions().setEnableEntryResizableFromStart(1)
 * myCal!.getOptions().setEnableEntryStartEditable(1)
 * myCal!.getOptions().setEnableSlotEntryOverlap(0)
 * myCal!.render()
 * </div></code></pre></blockquote>
 *
 * <b>Note</b>: You don't have to call the <code>render()</code> method if you update the calendar's configuration via the <code>setOptions()</code> method.
*/
public void render() { }
/**
 * Causes the calendar to refetch entries from all sources and rerender.
 * <p>
 * If you've previously added events to the calendar from a remote source, such
 * as a web service or Google Calendar, then the calendar will requery those sources
 * for an updated entry set. If the entries on the backend have changed, such as
 * some entries have been added and others deleted, then those changes will be
 * reflected on the calendar after calling this method.
*/
public void refetchAllEntries() { }
/**
 * Logs a debug string to the browser's console for debugging purposes if the EnableDebug option has been set. This method is used
 * internally by the BBjCalendarWidget and may also be used in your applications. To <b><i>always</i></b> log information to the console
 * regardless of whether the EnableDebug option has been set, use the <code><a href = '#consoleLog'>consoleLog()</a></code> method instead.
 * <p>
 * If you provide a simple string, like
 * <p>"<code>Got Here!</code>"
 * <p>then you'll see an entry in the console that looks like
 * <p>"<code><span style = 'background: hsl(40, 90%, 95%); color: hsl(40, 100%, 25%); 'background: hsl(40, 90%, 95%); color: hsl(40, 100%, 25%);'><b>BBjCalendarWidget Debug: </b>Got Here!</span></code>"
 * <p>
 * <b>Note</b>: If you provide a static string with single quotes, then you can print out JavaScript objects
 * if they're not enclosed in the single quotes. For example, calling the method with the string
 * <p>"<code><span style = 'background: yellow;'>'</span>Calendar View: <span style = 'background: yellow;'>'</span>, window.calendar.view.type</code>"
 * <p>(note the single quotes) results in the following message being printed in the console:
 * <p>"<code><span style = 'background: hsl(40, 90%, 95%); color: hsl(40, 100%, 25%); 'background: hsl(40, 90%, 95%); color: hsl(40, 100%, 25%);'><b>BBjCalendarWidget Debug: </b>Calendar View: timeGridWeek</code>".
 * <p>In other words, if you supply single quotes then the entire parameter is applied to the <code>console.log()</code> JavaScript function without any modifications.
*/
public void debugLog(BBjString msg!) { }
/**
 * Logs the provided string to the browser's console for debugging purposes <b><i>regardless</i></b> of whether the EnableDebug option has been set.
 * <p>
 * If you provide a simple string, like
 * <p>"<code>Got Here!</code>"
 * <p>then you'll see an entry in the console that looks like
 * <p>"<code><span style = 'background: hsl(60, 100%, 65%); color: hsl(350, 100%, 25%);'><b>BBjCalendarWidget Debug: </b>Got Here!</span></code>"
 * <p>
 * <b>Note</b>: If you provide a static string with single quotes, then you can print out JavaScript objects
 * if they're not enclosed in the single quotes. For example, calling the method with the string
 * <p>"<code><span style = 'background: yellow;'>'</span>Calendar View: <span style = 'background: yellow;'>'</span>, window.calendar.view.type</code>"
 * <p>(note the single quotes) results in the following message being printed in the console:
 * <p>"<code><span style = 'background: hsl(60, 100%, 65%); color: hsl(350, 100%, 25%);'><b>BBjCalendarWidget Debug: </b>Calendar View: timeGridWeek</code>".
 * <p>In other words, if you supply single quotes then the entire parameter is applied to the <code>console.log()</code> JavaScript function without any modifications.
 * @since BBj 21.12
*/
public void consoleLog(BBjString msg!) { }
/**
 * An internal event handler for native JavaScript events from the BBjHtmlView control that converts a JavaScript calendar event to a BBj callback event.
 *
 * @param BBjNativeJavaScriptEvent ev! The Javascript event from the client.
*/
public void onNativeEvent(BBjNativeJavaScriptEvent ev!) { }
/**
 * Initially draws or redraws the widget whenever it needs to be rendered.
 * <p>
 * Your application code won't ever have to call this method under normal conditions. It's typically only used internally
 * to redraw the calendar after the the <code>setSize()</code> method has been called. However, if you may want to call
 * the <code><a href = '#render'>render()</a></code> method if you modified the calendar's options inline (as opposed to using the <code>setOptions()</code> method.
 *
 * @param BBjNumber shouldCreate! A BBjNumber acting as a boolean that indicates if the control should be (re)created (1) or just redrawn (0).
 * @see <a href = '#render'>render()</a>
*/
public void redraw(BBjNumber shouldCreate!) { }
/**
 * Returns the calendar's options as a JsonObject.
 *
 * @return JsonObject The calendar's options as a JsonObject.
 * @see <a href = 'https://www.javadoc.io/doc/com.google.code.gson/gson/2.8.5/com/google/gson/JsonObject.html' target = '_blank'>JsonObject</a> for information about an object in JSON format.
*/
public JsonObject getOptionsAsJsonObject() { }
/**
 * Forces the calendar to resize itself based on the available space in the container DIV.
 * <p>
 * Using the default index.html template, the calendar is contained within the DIV that has the class 'BBjCalendarWidgetContainer'.
 * Whenever you modify the container DIV in such a way that it affects the calendar's size, such as dynamically changing
 * its margin CSS, you may want to call this method afterwards to cause the calendar to adjust to the new container size.
 * <p>
 * <b>Note</b>: If you call one of the setPadding() methods then this will be executed automatically after
 * the padding has been added to the container DIV, so this method isn't likely to be needed very often.
 *
*/
public void updateSize() { }
/**
 * Sets the padding, or spacing around the calendar control, to the same number of pixels for all four sides.
 * <p>
 * Using the default index.html template, the calendar is contained within the DIV that has the class 'BBjCalendarWidgetContainer'.
 * This method modifies the CSS for the container DIV by setting its padding to the provided padding size in pixels.
 *
 * @param BBjNumber padding! The numeric value of the desired padding in pixels, e.g. '5' for a 5-pixel padding on all sides.
*/
public void setPadding(BBjNumber padding!) { }
/**
 * Sets the padding, or spacing around the calendar control, to the specified number of pixels for the top, right, bottom, and left sides.
 * <p>
 * Using the default index.html template, the calendar is contained within the DIV that has the class 'BBjCalendarWidgetContainer'.
 * This method modifies the CSS for the container DIV by setting its padding to the provided padding size in pixels.
 *
 * @param BBjNumber paddingTop! The numeric value of the desired top padding in pixels, e.g. '5' for a 5-pixel padding on the top of the container.
 * @param BBjNumber paddingRight! The numeric value of the desired right padding in pixels, e.g. '5' for a 5-pixel padding on the right side of the container.
 * @param BBjNumber paddingBottom! The numeric value of the desired bottom padding in pixels, e.g. '5' for a 5-pixel padding on the bottom of the container.
 * @param BBjNumber paddingLeft! The numeric value of the desired left in pixels, e.g. '5' for a 5-pixel padding on the left side of the container.
*/
public void setPadding(BBjNumber paddingTop!, BBjNumber paddingRight!, BBjNumber paddingBottom!, BBjNumber paddingLeft!) { }
/**
 * Returns the unique control type for the <code>BBjCalendarWidget</code>, which is 65050.
 *
 * @return int controlType = 65050
*/
public int getControlType() { }
/**
 * Returns a BBjImage screenshot of the <code>BBjCalendarWidget</code>.
 *
 * @return BBjImage A screenshot of the calendar in BBjImage format.
 *
 * @see <a href = 'https://documentation.basis.com/BASISHelp/WebHelp/gridctrl/bbjimage.htm' target = '_blank'>BBjImage</a>
*/
public BBjImage getImage() { }
/**
 * Saves a BBjImage screenshot of the <code>BBjCalendarWidget</code> to the specified file path.
 *
 * @param BBjString path! A string representing the full path and filename for the saved screenshot of the calendar.
*/
public void saveAsPngImage(BBjString path!) { }
/**
 * Returns a BBjVector filled with optional custom tags that were previously set with the setVisibleTags() method and determine which calendar entries should be displayed.
 * <p>
 * When dealing with entry tags, there are three sets to be aware of:
 * <ol>
 * <li> The <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> custom class offers setTags() methods that give you the opportunity to add custom tags to any entry.</li>
 * <li> The <code><a href = 'BBjCalendarWidget.html#setVisibleTags' target = '_blank'>BBjCalendarWidget::setVisibleTags()</a></code> methods allow you to set which entries will be visible in the calendar, as any entries that share a tag with the visible tag set will be displayed normally.</li>
 * <li> The <code><a href = 'BBjCalendarWidget.html#setHiddenTags' target = '_blank'>BBjCalendarWidget::setHiddenTags()</a></code> methods allow you to set which entries will be hidden in the calendar, as any entries that share a tag with the hidden tag set will be be hidden from view.</li>
 * </ol>
 * <p>
 * <b>Note</b>: If the <code>BBjCalendarWidget</code>'s set of visible tags is empty then all calendar entries will be visible.
 * If the <code>BBjCalendarWidget</code>'s set of hidden tags is empty then all calendar entries will be visible.
 * <p>
 * <b>Note</b>: You will typically affect the calendar's entry visibility by calling either the setVisibleTags() or setHiddenTags() methods, but not both.
 *
 * @return BBjVector A vector filled with tags such as "work", "programming", "meeting", etc. that has been previously filled via one of the <code><a href = 'BBjCalendarWidget.html#setVisibleTags' target = '_blank'>BBjCalendarWidget::setVisibleTags()</a></code> methods.
 *
 * @see <a href = 'https://documentation.basis.com/BASISHelp/WebHelp/gridctrl/bbjvector_bbj.htm' target = '_blank'>BBjVector</a>
*/
public BBjVector getVisibleTags() { }
/**
 * Sets one or more optional, custom tags that determine which calendar
 * entries should be displayed. The <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> custom class offers
 * setTags() methods that give you the opportunity to add custom tags to any entry. After
 * adding tags to one or more entries, you can call methods on the calendar to show or
 * hide entries based on their tags by calling the <code><a href = 'BBjCalendarWidget.html#setVisibleTags' target = '_blank'>BBjCalendarWidget::setVisibleTags()</a></code> and
 * <code><a href = 'BBjCalendarWidget.html#setHiddenTags' target = '_blank'>BBjCalendarWidget::setHiddenTags()</a></code> methods.
 * <p>
 * This is similar to the <code>setVisibleTags()</code> method that takes a BBjVector except that it takes a comma-delimted string of tags for succinctness.
 *
 * @param BBjString tags! A comma-delimted string of tags such as "work, programming".
*/
public void setVisibleTags(BBjString tags!) { }
/**
 * Sets one or more optional, custom tags that determine which calendar
 * entries should be displayed. The <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> custom class offers
 * setTags() methods that give you the opportunity to add custom tags to any entry. After
 * adding tags to one or more entries, you can call methods on the calendar to show or
 * hide entries based on their tags by calling the <code><a href = 'BBjCalendarWidget.html#setVisibleTags' target = '_blank'>BBjCalendarWidget::setVisibleTags()</a></code> and
 * <code><a href = 'BBjCalendarWidget.html#setHiddenTags' target = '_blank'>BBjCalendarWidget::setHiddenTags()</a></code> methods.
 *
 * @param BBjVector A vector filled with tags such as "work", "programming", "meeting", etc.
*/
public void setVisibleTags(BBjVector tags!) { }
/**
 * Returns a BBjVector filled with optional custom tags that were previously set with the setHiddenTags() method and determine which calendar entries should be hidden.
 * <p>
 * When dealing with entry tags, there are three sets to be aware of:
 * <ol>
 * <li> The <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> custom class offers setTags() methods that give you the opportunity to add custom tags to any entry.</li>
 * <li> The <code><a href = 'BBjCalendarWidget.html#setVisibleTags' target = '_blank'>BBjCalendarWidget::setVisibleTags()</a></code> methods allow you to set which entries will be visible in the calendar, as any entries that share a tag with the visible tag set will be displayed normally.</li>
 * <li> The <code><a href = 'BBjCalendarWidget.html#setHiddenTags' target = '_blank'>BBjCalendarWidget::setHiddenTags()</a></code> methods allow you to set which entries will be hidden in the calendar, as any entries that share a tag with the hidden tag set will be be hidden from view.</li>
 * </ol>
 * <p>
 * <b>Note</b>: If the <code>BBjCalendarWidget</code>'s set of visible tags is empty then all calendar entries will be visible.
 * If the <code>BBjCalendarWidget</code>'s set of hidden tags is empty then all calendar entries will be visible.
 * <p>
 * <b>Note</b>: You will typically affect the calendar's entry visibility by calling either the setVisibleTags() or setHiddenTags() methods, but not both.
 *
 * @return BBjVector A vector filled with tags such as "work", "programming", "meeting", etc. that has been previously filled via one of the <code><a href = 'BBjCalendarWidget.html#setVisibleTags' target = '_blank'>BBjCalendarWidget::setVisibleTags()</a></code> methods.
 *
 * @see <a href = 'https://documentation.basis.com/BASISHelp/WebHelp/gridctrl/bbjvector_bbj.htm' target = '_blank'>BBjVector</a>
*/
public BBjVector getHiddenTags() { }
/**
 * Sets one or more optional, custom tags that determine which calendar
 * entries should be hidden. The <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> custom class offers
 * setTags() methods that give you the opportunity to add custom tags to any entry. After
 * adding tags to one or more entries, you can call methods on the calendar to show or
 * hide entries based on their tags by calling the <code><a href = 'BBjCalendarWidget.html#setVisibleTags' target = '_blank'>BBjCalendarWidget::setVisibleTags()</a></code> and
 * <code><a href = 'BBjCalendarWidget.html#setHiddenTags' target = '_blank'>BBjCalendarWidget::setHiddenTags()</a></code> methods.
 * <p>
 * This is similar to the <code>setHiddenTags()</code> method that takes a BBjVector except that it takes a comma-delimted string of tags for succinctness.
 *
 * @param BBjString A comma-delimted string of tags such as "work, programming, personal".
*/
public void setHiddenTags(BBjString tags!) { }
/**
 * Sets one or more optional, custom tags that determine which calendar
 * entries should be hidden. The <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> custom class offers
 * setTags() methods that give you the opportunity to add custom tags to any entry. After
 * adding tags to one or more entries, you can call methods on the calendar to show or
 * hide entries based on their tags by calling the <code><a href = 'BBjCalendarWidget.html#setVisibleTags' target = '_blank'>BBjCalendarWidget::setVisibleTags()</a></code> and
 * <code><a href = 'BBjCalendarWidget.html#setHiddenTags' target = '_blank'>BBjCalendarWidget::setHiddenTags()</a></code> methods.
 *
 * @param BBjVector A vector filled with tags such as "work", "programming", "meeting", etc.
*/
public void setHiddenTags(BBjVector tags!) { }
/**
 * Returns the calendar's view type which will be one of the following constants:
 * <ul>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_DAY_GRID_WEEK' target = '_blank'>CalendarAPI.CALENDAR_VIEW_DAY_GRID_WEEK()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_DAY_GRID_MONTH' target = '_blank'>CalendarAPI.CALENDAR_VIEW_DAY_GRID_MONTH()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_TIME_GRID_DAY' target = '_blank'>CalendarAPI.CALENDAR_VIEW_TIME_GRID_DAY()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_TIME_GRID_WEEK' target = '_blank'>CalendarAPI.CALENDAR_VIEW_TIME_GRID_WEEK()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_LIST_DAY' target = '_blank'>CalendarAPI.CALENDAR_VIEW_LIST_DAY()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_LIST_WEEK' target = '_blank'>CalendarAPI.CALENDAR_VIEW_LIST_WEEK()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_LIST_MONTH' target = '_blank'>CalendarAPI.CALENDAR_VIEW_LIST_MONTH()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_LIST_YEAR' target = '_blank'>CalendarAPI.CALENDAR_VIEW_LIST_YEAR()</a></code>.</li>
 * </ul>
 *
 * @return BBjString The calendar's current view type, such as <code>CalendarAPI.CALENDAR_VIEW_DAY_GRID_WEEK()</code>.
*/
public BBjString getViewType() { }
/**
 * Sets the calendar's view type.
 * <p>
 * <b>Note</b>: Calling this method causes the calendar to change its view, which then results in a
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_VIEW_CHANGE' target = '_blank'>CalendarAPI.ON_CALENDAR_VIEW_CHANGE</a></code> event.
 * <p>
 * The provided view type should be one of the following constants:
 * <ul>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_DAY_GRID_WEEK' target = '_blank'>CalendarAPI.CALENDAR_VIEW_DAY_GRID_WEEK()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_DAY_GRID_MONTH' target = '_blank'>CalendarAPI.CALENDAR_VIEW_DAY_GRID_MONTH()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_TIME_GRID_DAY' target = '_blank'>CalendarAPI.CALENDAR_VIEW_TIME_GRID_DAY()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_TIME_GRID_WEEK' target = '_blank'>CalendarAPI.CALENDAR_VIEW_TIME_GRID_WEEK()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_LIST_DAY' target = '_blank'>CalendarAPI.CALENDAR_VIEW_LIST_DAY()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_LIST_WEEK' target = '_blank'>CalendarAPI.CALENDAR_VIEW_LIST_WEEK()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_LIST_MONTH' target = '_blank'>CalendarAPI.CALENDAR_VIEW_LIST_MONTH()</a></code>.</li>
 * <li><code><a href = 'CalendarAPI.html#CALENDAR_VIEW_LIST_YEAR' target = '_blank'>CalendarAPI.CALENDAR_VIEW_LIST_YEAR()</a></code>.</li>
 * </ul>
 *
 * @param BBjString viewType! The desired calendar view type, such as <code><a href = 'CalendarAPI.html#CALENDAR_VIEW_TIME_GRID_WEEK' target = '_blank'>CalendarAPI.CALENDAR_VIEW_TIME_GRID_WEEK()</a></code>.
*/
public void setViewType(BBjString viewType!) { }
/**
 * Returns all of the calendar's available themes as an alphabetized list in a BBjVector filled with the theme names.
 * <p>
 * After determining which themes are available, you can call the <code><a href = 'BBjCalendarWidget.html#setTheme' target = '_blank'>setTheme()</a></code>
 * method specifying any of the theme names in the return vector to change the calendar's theme.
 * <p>
 * Note that the installed themes are located in the BBjCalendarWidget's <code>lib/bootstrap/themes/</code> directory. The installed themes
 * are free Bootstrap themes from <code><a href = 'https://bootswatch.com/' target = '_blank'>https://bootswatch.com/</a></code>, although free
 * Bootstrap themes are available from many other sites such as
 * <code><a href = 'https://startbootstrap.com/themes?showPro = false&showVue = false&showAngular = false' target = '_blank'>https://startbootstrap.com/themes</a></code>.
 * If you would like to add more themes, create a subdirectory under the calendar's themes directory and copy the <code>bootstrap.css</code> and
 * <code>bootstrap.min.css</code> files in the newly-created subdirectory. The calendar will attempt to find and use the
 * <code>bootstrap.min.css</code> first due to its reduced size.
 *
 * @return BBjVector A BBjVector filled with the alphabetized list of available theme names.
*/
public static BBjVector getThemes() { }
/**
 * Sets the calendar's theme to one of the installed Boostrap themes, which modifies the calendar's fonts and color scheme.
 * <p>
 * To determine which themes are available, you can call the <code><a href = 'BBjCalendarWidget.html#getThemes' target = '_blank'>getThemes()</a></code>
 * method which returns a BBjVector filled with the installed theme names.
 * <p>
 * Note that the installed themes are located in the BBjCalendarWidget's <code>lib/bootstrap/themes/</code> directory. The installed themes
 * are free Bootstrap themes from <code><a href = 'https://bootswatch.com/' target = '_blank'>https://bootswatch.com/</a></code>, although free
 * Bootstrap themes are available from many other sites such as
 * <code><a href = 'https://startbootstrap.com/themes?showPro = false&showVue = false&showAngular = false' target = '_blank'>https://startbootstrap.com/themes</a></code>.
 * If you would like to add more themes, create a subdirectory under the calendar's themes directory and copy the <code>bootstrap.css</code> and
 * <code>bootstrap.min.css</code> files in the newly-created subdirectory. The calendar will attempt to find and use the
 * <code>bootstrap.min.css</code> first due to its reduced size.
 *
 * @param BBjString theme!
*/
public void setTheme(BBjString theme!) { }
/**
 * Registers a callback in a procedural program for the provided event type.
 * <p>
 * These are the valid callback event type options:
 * <ul>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_READY' target = '_blank'>CalendarAPI.ON_CALENDAR_READY</a></code> - the calendar is ready for interaction</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_VIEW_CHANGE' target = '_blank'>CalendarAPI.ON_CALENDAR_VIEW_CHANGE</a></code> - the calendar's view has changed</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRIES_SET' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRIES_SET</a></code> - entries have been changed or initialized in any way</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_CLICK' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_CLICK</a></code> - the user clicked on an entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_ADD' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_ADD</a></code> - an entry was added to the calendar</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_CHANGE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_CHANGE</a></code> - the entry has been modified</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_REMOVE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_REMOVE</a></code> - the entry has been removed from the calendar</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_MOUSE_ENTER' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_MOUSE_ENTER</a></code> - the user moved the mouse on an entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_MOUSE_LEAVE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_MOUSE_LEAVE</a></code> - the user moved the mouse off an entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_DRAG_START' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_DRAG_START</a></code> - the user began dragging an entire entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_DRAG_STOP' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_DRAG_STOP</a></code> - the user stopped dragging the entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_DROP' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_DROP</a></code> - the user has completed dragging and dropping the entire entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_RESIZE_START' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_RESIZE_START</a></code> - the user began to resize the entry to change its duration</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_RESIZE_STOP' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_RESIZE_STOP</a></code> - the user stopped resizing the entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_RESIZE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_RESIZE</a></code> - the user completed resizing the entry resulting in a changed duration</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_RECEIVE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_RECEIVE</a></code> - <b>Not Yet Implemented</b>, deals with dragging and dropping entries from an external source</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_LEAVE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_LEAVE</a></code> - <b>Not Yet Implemented</b>, deals with dragging and dropping entries from an external source</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_DROP' target = '_blank'>CalendarAPI.ON_CALENDAR_DROP</a></code> - <b>Not Yet Implemented</b>, deals with dragging and dropping entries from an external source</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_DATES_SET' target = '_blank'>CalendarAPI.ON_CALENDAR_DATES_SET</a></code> - the calendar's range has been initially set or changed in some way</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_DATE_CLICK' target = '_blank'>CalendarAPI.ON_CALENDAR_DATE_CLICK</a></code> - the user clicked on a date or time in the calendar</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_SELECT' target = '_blank'>CalendarAPI.ON_CALENDAR_SELECT</a></code> - the user selected a date or time in the calendar (not an entry)</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_UNSELECT' target = '_blank'>CalendarAPI.ON_CALENDAR_UNSELECT</a></code> - the date/time selection has been cleared</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_SOURCE_SUCCESS' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_SOURCE_SUCCESS</a></code> - fetching a CalendarEntrySource has succeded</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_SOURCE_FAILURE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_SOURCE_FAILURE</a></code> - fetching a CalendarEntrySource has failed</li>
 * </ul>
 * <p>
 * <b>Note</b>: Callbacks associated with dragging/dropping calendar entries between two different calendars has not yet been implemented.
 *
 * @param BBjNumber event! The event number which is one of the <code>CalendarAPI.ON_CALENDAR_*</code> constants.
 * @param BBjString callback! The program's callback subroutine label.
*/
public void setCallback(BBjNumber event!, BBjString callback!) { }
/**
 * Registers a callback in an object-oriented program for the provided event type.
 * <p>
 * These are the valid callback event type options:
 * <ul>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_READY' target = '_blank'>CalendarAPI.ON_CALENDAR_READY</a></code> - the calendar is ready for interaction</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_VIEW_CHANGE' target = '_blank'>CalendarAPI.ON_CALENDAR_VIEW_CHANGE</a></code> - the calendar's view has changed</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRIES_SET' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRIES_SET</a></code> - entries have been changed or initialized in any way</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_CLICK' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_CLICK</a></code> - the user clicked on an entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_ADD' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_ADD</a></code> - an entry was added to the calendar</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_CHANGE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_CHANGE</a></code> - the entry has been modified</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_REMOVE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_REMOVE</a></code> - the entry has been removed from the calendar</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_MOUSE_ENTER' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_MOUSE_ENTER</a></code> - the user moved the mouse on an entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_MOUSE_LEAVE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_MOUSE_LEAVE</a></code> - the user moved the mouse off an entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_DRAG_START' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_DRAG_START</a></code> - the user began dragging an entire entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_DRAG_STOP' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_DRAG_STOP</a></code> - the user stopped dragging the entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_DROP' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_DROP</a></code> - the user has completed dragging and dropping the entire entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_RESIZE_START' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_RESIZE_START</a></code> - the user began to resize the entry to change its duration</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_RESIZE_STOP' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_RESIZE_STOP</a></code> - the user stopped resizing the entry</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_RESIZE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_RESIZE</a></code> - the user completed resizing the entry resulting in a changed duration</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_RECEIVE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_RECEIVE</a></code> - <b>Not Yet Implemented</b>, deals with dragging and dropping entries from an external source</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_LEAVE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_LEAVE</a></code> - <b>Not Yet Implemented</b>, deals with dragging and dropping entries from an external source</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_DROP' target = '_blank'>CalendarAPI.ON_CALENDAR_DROP</a></code> - <b>Not Yet Implemented</b>, deals with dragging and dropping entries from an external source</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_DATES_SET' target = '_blank'>CalendarAPI.ON_CALENDAR_DATES_SET</a></code> - the calendar's range has been initially set or changed in some way</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_DATE_CLICK' target = '_blank'>CalendarAPI.ON_CALENDAR_DATE_CLICK</a></code> - the user clicked on a date or time in the calendar</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_SELECT' target = '_blank'>CalendarAPI.ON_CALENDAR_SELECT</a></code> - the user selected a date or time in the calendar (not an entry)</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_UNSELECT' target = '_blank'>CalendarAPI.ON_CALENDAR_UNSELECT</a></code> - the date/time selection has been cleared</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_SOURCE_SUCCESS' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_SOURCE_SUCCESS</a></code> - fetching a CalendarEntrySource has succeded</li>
 * <li><code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_SOURCE_FAILURE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_SOURCE_FAILURE</a></code> - fetching a CalendarEntrySource has failed</li>
 * </ul>
 * <p>
 * <b>Note</b>: Callbacks associated with dragging/dropping calendar entries between two different calendars has not yet been implemented.
 *
 * @param BBjNumber event! The event number which is one of the <code>CalendarAPI.ON_CALENDAR_*</code> constants.
 * @param CustomObject instance! The program's custom class instance, usually #this!
 * @param BBjString method! The program's custom class's method name.
*/
public void setCallback(BBjNumber event!, CustomObject instance!, BBjString method!) { }
/**
 * Removes the callback given the callback number.
 *
 * @param BBjNumber event! The event number which is one of the <code>CalendarAPI.ON_CALENDAR_*</code> constants.
*/
public void clearCallback(BBjNumber event!) { }
/**
 * Sets the background color of the calendar's containing window.
 *
 * @param BBjColor backColor! A BBjColor that defines the containing window's background color.
*/
public void setBackColor(BBjColor backColor!) { }
/**
 * Returns the background color of the calendar's containing window.
 *
 * @return BBjColor The containing window's background color as a BBjColor.
*/
public BBjColor getBackColor() { }
/**
 * Sets a custom, arbitrary object to be associated with the widget which can be retrieved later via the <code>getUserData()</code> method.
 *
 * @param Object userData! The object to associate with the widget.
*/
public void setUserData(Object userData!) { }
/**
 * Returns the custom object that was previously associated with the widget by calling the <code>setUserData()</code> method.
 *
 * @return Object The custom object associated with the widget.
*/
public Object getUserData() { }
/**
 * Sets whether the widget should be enabled.
 *
 * @param boolean enabled! A boolean that indicates whether the widget should be enabled (1) or not (0).
*/
public void setEnabled(boolean enabled!) { }
/**
 * Returns whether the widget is enabled or disabled.
 *
 * @return boolean A boolean that indicates whether the widget is enabled (1) or not (0).
*/
public boolean isEnabled() { }
/**
 * Sets whether the widget should be visible or hidden.
 *
 * @param boolean visible! A boolean that indicates whether the widget should be visible (1) or not (0).
*/
public void setVisible(boolean visible!) { }
/**
 * Returns whether the widget is visible or hidden.
 *
 * @return boolean A boolean that indicates whether the widget is visible (1) or not (0).
*/
public boolean isVisible() { }
/**
 * Returns the widget's width.
 *
 * @return BBjNumber The widget's width.
*/
public BBjNumber getWidth() { }
/**
 * Returns the widget's height.
 *
 * @return BBjNumber The widget's height.
*/
public BBjNumber getHeight() { }
/**
 * Sets the size of the calendar widget given the provided width and height.
 *
 * @param BBjNumber width! The widget's width.
 * @param BBjNumber height! The widget's height.
*/
public void setSize(BBjNumber width!, BBjNumber height!) { }
/**
 * Returns the widget's X coordinate, or horizontal position.
 *
 * @return BBjNumber The widget's X coordinate.
*/
public BBjNumber getX() { }
/**
 * Returns the widget's Y coordinate, or vertical position.
 *
 * @return BBjNumber The widget's Y coordinate.
*/
public BBjNumber getY() { }
/**
 * Sets the location of the calendar widget given the provided X and Y coordinates.
 *
 * @param BBjNumber x! The widget's X coordinate.
 * @param BBjNumber y! The widget's Y coordinate.
*/
public void setLocation(BBjNumber x!, BBjNumber y!) { }
/**
 * Returns the widget's name as previously-set via the <code>setName()</code> method.
 *
 * @return String The widget's name.
*/
public String getName() { }
/**
 * Sets the widget's name, which can later be retrieved via the <code>getName()</code> method.
 * This value is propagated to the CSS class attribute of the HTML element representing the control in BUI.
 *
 * @param BBjString name! The widget's name.
*/
public void setName(BBjString name!) { }
/**
 * Adds the provided CSS style name to the widget.
 *
 * @param BBjString style! The CSS style name to add to the widget.
 * @return boolean A boolean that indicates whether the style name was added to the widget (1) or not (0).
*/
public boolean addStyle(BBjString style!) { }
/**
 * Removes the provided CSS style name from the widget.
 *
 * @param BBjString style! The CSS style name to remove from the widget.
 * @return boolean A boolean that indicates whether the style name was removed from the widget (1) or not (0).
*/
public boolean removeStyle(BBjString style!) { }
/**
 * Clears all the CSS styles from the widget.
*/
public void clearStyles() { }
/**
 * Sets a CSS property on the widget.
 *
 * @param BBjString property! The CSS property name to set.
 * @param BBjString style! The CSS value to be assigned to the provided CSS property.
*/
public void setStyle(BBjString property!, BBjString style!) { }
/**
 * Returns the widget's name as previously-set via the <code>setName()</code> method.
 *
 * @return BBjVector A BBjVector filled with a list of all the CSS style names that have been added to the widget.
*/
public BBjVector getStyles() { }
/**
 * Returns the value of the specified CSS property.
 *
 * @param BBjString property! The CSS property name to get the value of.
 *
 * @return BBjString The value of the specified CSS property.
*/
public BBjString getStyle(BBjString property!) { }
/**
 * Navigates the calendar programmatically one step back (by a month or week for example),
 * and is the same as the user clicking on the 'prev' toolbar button. The amount of time
 * moved depends on the current view type.
*/
public void navigatePrev() { }
/**
 * Navigates the calendar programmatically one step forward (by a month or week for example),
 * and is the same as the user clicking on the 'next' toolbar button. The amount of time
 * moved depends on the current view type.
*/
public void navigateNext() { }
/**
 * Navigates the calendar programmatically back one year, and is the same as the user clicking on the 'prevYear' toolbar button.
*/
public void navigatePrevYear() { }
/**
 * Navigates the calendar programmatically forward one year, and is the same as the user clicking on the 'nextYear' toolbar button.
*/
public void navigateNextYear() { }
/**
 * Navigates the calendar programmatically to the current date, and is the same as the user clicking on the 'today' toolbar button.
*/
public void navigateToday() { }
/**
 * Navigates the calendar programmatically to the specified date. To ensure the calendar navigates to the correct date, the provided
 * date should be in the ISO 8601 format. However, this method attempts to parse ambiguous dates and is often able to construct
 * a date in the format <code>"YYYY-MM-DD"</code> given a date string in another format.
 * <p>
 * If the provided string is ambiguous, there are no guarantees that the method will be able to resolve the date/time string correctly.
 * The success of this method depends on the format of the supplied date/time string and the client's browser. For example, a date of
 * <code>"1-2-3"</code> is very ambiguous and while the method may be able to return a valid date string, it may not be the particular
 * date that you had in mind. That's because there is no good way to know which number corresponds to the year, month, and day. However,
 * a string like <code>"Jan 1, 2000"</code> is far less ambiguous and will likely be parsed correctly in to <code>"2000-01-01"</code>.
 * <p>
 * Additionally, since the method uses JavaScript when parsing dates and time, the success is dependant on the browser's JavaScript implementation.
 * For example, at the time of this writing, Chrome can parse ambiguous dates like <code>"May 2020"</code> and <code>"May 15"</code>.
 * However, Firefox returns an "Invalid Date" for those values.
 * <p>
 * The date string should ideally be in the <code>"YYYY-MM-DD"</code> format at a minimum, but the parser should be able to interpret various formats.
 *
 * @param BBjString date! The date string that will be parsed and then passed to the FullCalendar's gotoDate() method.
 *
 * @see <a href = 'https://www.w3.org/TR/NOTE-datetime' target = '_blank'>Date and Time Formats</a> for information on ISO 8601 date/time formats.
 * @see <a href = 'https://fullcalendar.io/docs/Calendar-gotoDate' target = '_blank'>Calendar::gotoDate</a> for information on the FullCalendar's gotoDate() method.
*/
public void navigateDate(BBjString date!) { }
/**
 * Navigates the calendar programmatically to the specified time. To ensure the calendar navigates to the correct time, the provided
 * time should be in the ISO 8601 format or <code>"hh:mm"</code> format at a minimum.. However, this method attempts to parse ambiguous
 * times and is often able to construct a time in the format <code>"hh:mm:ss"</code> given a time string in another format.
 * <p>
 * If the provided string is ambiguous, there are no guarantees that the method will be able to resolve the date/time string correctly.
 * The success of this method depends on the format of the supplied date/time string and the client's browser. For example, a date of
 * <code>"1-2-3"</code> is very ambiguous and while the method may be able to return a valid date string, it may not be the particular
 * date that you had in mind. That's because there is no good way to know which number corresponds to the year, month, and day. However,
 * a string like <code>"Jan 1, 2000"</code> is far less ambiguous and will likely be parsed correctly in to <code>"2000-01-01"</code>.
 * <p>
 * Additionally, since the method uses JavaScript when parsing dates and time, the success is dependant on the browser's JavaScript implementation.
 * For example, at the time of this writing, Chrome can parse ambiguous dates like <code>"May 2020"</code> and <code>"May 15"</code>.
 * However, Firefox returns an "Invalid Date" for those values.
 * <p>
 * The time string should ideally be in one of the following formats.
 * <ul>
 * <li>"hh:mm:ss.sss"</li>
 * <li>"hh:mm:ss"</li>
 * <li>"hh:mm"</li>
 * </ul>
 * but the parser should be able to interpret various formats.
 *
 * @param BBjString time! The time string that will be parsed and then passed to the FullCalendar's scrollToTime() method.
 *
 * @see <a href = 'https://www.w3.org/TR/NOTE-datetime' target = '_blank'>Date and Time Formats</a> for information on ISO 8601 date/time formats.
 * @see <a href = 'https://fullcalendar.io/docs/scrollToTime' target = '_blank'>Calendar::scrollToTime</a> for information on the FullCalendar's scrollToTime() method.
 *
 * @since BBj 22.00
*/
public void navigateTime(BBjString time!) { }
/**
 * Returns the calendar's currently selected date.
 *
 * @return BBjString The calendar's current date as a string.
*/
public BBjString getDate() { }
/**
 * Returns the calendar's currently selected date in ISO format.
 *
 * @return BBjString The calendar's current date as a string in 8601 format (YYYY-MM-DD), such as "2020-12-31"
 *
 * @see <a href = 'https://www.w3.org/TR/NOTE-datetime' target = '_blank'>Date and Time Formats</a> for information on ISO 8601 date/time formats.
*/
public BBjString getDateAsISOString() { }
/**
 * A utility method that returns a formatted, or pretty-printed version of the supplied JSON object sorted alphabetically by key.
 *
 * @param JsonObject json! The JSON object to be formatted.
 * @return BBjString A BBjString that is a string representation of the supplied JSON object after it has been formatted, or an empty string if the provided JsonObject was null().
*/
public static BBjString getJsonObjectAsFormattedString(JsonObject json!) { }
/**
 * A utility method that returns a JSON array version of the supplied BBjVector.
 *
 * @param BBjVector vector! The BBjVector to be converted to a JSON array.
 * @return JsonArray A JSON array version of the supplied BBjVector.
*/
public static JsonArray getBBjVectorAsJsonArray(BBjVector vector!) { }
/**
 * A utility method that returns a BBjVector version of the supplied JSON array.
 *
 * @param JsonArray array! The JSON array to be converted to a BBjVector.
 * @return BBjVector A BBjVector version of the supplied JSON array.
*/
public static BBjVector getJsonArrayAsBBjVector(JsonArray array!) { }
/**
 * A utility method that converts a BBjVector filled with <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> object to a JSON array of calendar entries.
 *
 * @param BBjVector entries! A BBjVector filled with <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects.
 * @return JsonArray A JsonArray filled with Json entry objects.
*/
public static JsonArray convertEntriesBBjVectorToJsonArray(BBjVector entries!) { }
/**
 * A utility method that converts a JSON array of calendar entries, such as what's received from
 * the JavaScript code, into a BBjVector filled with CalendarEntry objects.
 *
 * @param JsonArray entries! A JsonArray of calendar entries.
 * @return BBjVector A BBjVector filled with <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects.
*/
public static BBjVector convertEntriesArrayToBBjVector(JsonArray entries!) { }
/**
 * A utility method that converts a stringified JSON array of calendar entries, such as what's received
 * from the JavaScript code, into a BBjVector filled with <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects.
 *
 * @param BBjString entries! A stringified JSON array of calendar entries.
 * @return BBjVector A BBjVector filled with <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects.
*/
public static BBjVector convertEntriesArrayToBBjVector(BBjString entries!) { }
/**
 * A utility method that returns a descriptive string given an event number based on the <code>CalendarAPI.ON_CALENDAR_*</code> callback constants.
 *
 * @param BBjNumber eventNumber! The event number that is one of the <code>CalendarAPI.ON_CALENDAR_*</code> callback constants.
 *
 * @return BBjString A string description of the event number.
*/
public BBjString getEventDescription(BBjNumber eventNumber!) { }
/**
 * Returns a date string formatted as YYYY-MM-DD if the provided date string can be parsed into a valid date, or null() if the date string is invalid.
 * <p>
 * <b>Note</b>: An ISO 8601 formatted date/time string (<code>YYYY-MM-DDTHH:mm:ss.sssZ</code>) is never ambiguous, but this method exists to attempt to parse an ambiguous
 * date/time string into an ISO 8601 formatted date/time string. If the provided string is ambiguous, there are no guarantees that the method will be able to
 * resolve the date/time string correctly. The success of this method depends on the format of the supplied date/time string and the client's browser. For example,
 * a date of <code>"1-2-3"</code> is very ambiguous and while the method may be able to return a valid date string, it may not be the particular date that you had in mind.
 * That's because there is no good way to know which number corresponds to the year, month, and day. However, a string like <code>"Jan 1, 2000"</code> is far less
 * ambiguous and will likely be parsed correctly in to <code>"2000-01-01"</code>.
 * <p>
 * Additionally, since the method uses JavaScript when parsing dates, the success is dependant on the browser's JavaScript implementation. For example, at the time of
 * this writing, Chrome can parse ambiguous dates like <code>"May 2020"</code> and <code>"May 15"</code>. However, Firefox returns an "Invalid Date" for those values.
 *
 * @param BBjString dateString! A string that contains a date representation. If you provide a ISO formatted date, such as 2022-12-25, then
 *
 * @return BBjString A YYYY-MM-DD formatted date representation of the provided date string, or null() if the date string cannot be parsed into an ISO formatted date.
 *
 * @since BBj 22.00
*/
public BBjString getValidDateString(BBjString dateString!) { }
/**
 * Returns a time string formatted as HH:MM:SS using 24-hour format if the provided time string can be parsed into a valid time, or null() if the time string is invalid.
 * <p>
 * <b>Note</b>: An ISO 8601 formatted date/time string (<code>YYYY-MM-DDTHH:mm:ss.sssZ</code>) is never ambiguous, but this method exists to attempt to parse an ambiguous
 * date/time string into an ISO 8601 formatted date/time string. If the provided string is ambiguous, there are no guarantees that the method will be able to
 * resolve the date/time string correctly. The success of this method depends on the format of the supplied date/time string and the client's browser. For example,
 * a date of <code>"1-2-3"</code> is very ambiguous and while the method may be able to return a valid date string, it may not be the particular date that you had in mind.
 * That's because there is no good way to know which number corresponds to the year, month, and day. However, a string like <code>"Jan 1, 2000"</code> is far less
 * ambiguous and will likely be parsed correctly in to <code>"2000-01-01"</code>.
 * <p>
 * Additionally, since the method uses JavaScript when parsing dates, the success is dependant on the browser's JavaScript implementation. For example, at the time of
 * this writing, Chrome can parse ambiguous dates like <code>"May 2020"</code> and <code>"May 15"</code>. However, Firefox returns an "Invalid Date" for those values.
 *
 * @param BBjString timeString! A string that contains a time representation.
 *
 * @return BBjString A 24-hour HH:MM:SS formatted time representation of the provided time string, or null() if the time string cannot be parsed into an ISO formatted time.
 *
 * @since BBj 22.00
*/
public BBjString getValidTimeString(BBjString timeString!) { }
/**
 * Returns an ISO 8601 formatted date/time string if the provided date/time string can be parsed into a valid date, or null() if it can't be parsed.
 * <p>
 * <b>Note</b>: An ISO 8601 formatted date/time string (<code>YYYY-MM-DDTHH:mm:ss.sssZ</code>) is never ambiguous, but this method exists to attempt to parse an ambiguous
 * date/time string into an ISO 8601 formatted date/time string. If the provided string is ambiguous, there are no guarantees that the method will be able to
 * resolve the date/time string correctly. The success of this method depends on the format of the supplied date/time string and the client's browser. For example,
 * a date of <code>"1-2-3"</code> is very ambiguous and while the method may be able to return a valid date string, it may not be the particular date that you had in mind.
 * That's because there is no good way to know which number corresponds to the year, month, and day. However, a string like <code>"Jan 1, 2000"</code> is far less
 * ambiguous and will likely be parsed correctly in to <code>"2000-01-01"</code>.
 * <p>
 * Additionally, since the method uses JavaScript when parsing dates, the success is dependant on the browser's JavaScript implementation. For example, at the time of
 * this writing, Chrome can parse ambiguous dates like <code>"May 2020"</code> and <code>"May 15"</code>. However, Firefox returns an "Invalid Date" for those values.
 *
 * @param BBjString dateTimeString! A string that contains a date/time representation.
 *
 * @return BBjString An ISO 8601 formatted date representation of the provided date string, or null() if the date string cannot be parsed into an ISO formatted date/time string.
 *
 * @since BBj 22.00
*/
public BBjString getValidDateTimeString(BBjString dateTimeString!) { }
/**
 * Returns the difference between the client's local time and UTC in minutes. For example, if your time zone is
 * UTC+10, then -600 will be returned because UTC is 600 minutes behind the local time zone. Another way to view
 * it is that the return value is the number of minutes that should be added to the local time in order to find
 * UTC. Note that daylight savings time prevents this value from being a constant.
 *
 * @return BBjNumber The number of minutes needed to add to the local time to result in UTC.
 *
 * @since BBj 22.00
*/
public BBjNumber getLocalTimeZoneOffsetFromUtc() { }
/**
 * Adds an entry to the calendar given a JsonObject representation of the calendar entry.
 * <p>
 * <b>Note</b>: Adding entries to the calendar via this method will trigger the
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_ADD' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_ADD()</a></code> event.
 *
 * @param JsonObject entry! The entry to be added to the calendar.
*/
public void addEntry(JsonObject entry!) { }
/**
 * Adds an entry to the calendar given a <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> object.
 * <p>
 * <b>Note</b>: Adding entries to the calendar via this method will trigger the
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_ADD' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_ADD()</a></code> event.
 *
 * @param CalendarEntry entry! The <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> to be added to the calendar.
*/
public void addEntry(CalendarEntry entry!) { }
/**
 * Adds several JsonObject entries in a JsonArray to the calendar at once for improved performance.
 * <p>
 * <b>Note</b>: Adding multiple entries to the calendar via this method will <b>not</b> trigger the
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_ADD' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_ADD()</a></code> event.
 *
 * @param JsonArray entries! A JsonArray filled with JSON objects to be added to the calendar.
*/
public void addEntries(JsonArray entries!) { }
/**
 * Adds several entries of type <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> to the calendar at once for improved performance.
 * <p>
 * <b>Note</b>: Adding multiple entries to the calendar via this method will <b>not</b> trigger the
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_ADD' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_ADD()</a></code> event.
 *
 * @param BBjVector entries! A BBjVector filled with <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects to be added to the calendar.
*/
public void addEntries(BBjVector entries!) { }
/**
 * Adds entries to the calendar from a <code>CalendarEntrySource</code>.
 *
 * @param CalendarEntrySource entrySource! A previously-defined <code>CalendarEntrySource</code>.
*/
public void addEntrySource(CalendarEntrySource entrySource!) { }
/**
 * Returns a BBjVector filled with IDs for all the <code>CalendarEntrySource</code> objects that have previously been added to the calendar via the <code>addEntrySource()</code> method.
 *
 * @return BBjVector A BBjVector filled with the current <code>CalendarEntrySource</code> object IDs that have previously been added to the calendar, or null() if none have been added.
*/
public BBjVector getEntrySourceIds() { }
/**
 * Removes a <code>CalendarEntrySource<code> and its entries from the calendar given its unique ID.
 *
 * @param BBjString id! A BBjString filled with the unique ID for the <code>CalendarEntrySource<code> to remove.
*/
public void removeEntrySource(BBjString id!) { }
/**
 * Refetches the <code>CalendarEntrySource<code> object in the calendar given its unique ID, causing it to retrieve its entries again.
 *
 * @param BBjString id! A BBjString filled with the unique ID for the <code>CalendarEntrySource<code> to remove.
*/
public void refetchEntrySource(BBjString id!) { }
/**
 * Removes all <code>CalendarEntrySource<code> objects from the calendar.
 *
 * @return BBjNumber A BBjNumber indicating the number of entries that were removed from the calendar.
*/
public BBjNumber removeAllEntrySources() { }
/**
 * Refetches all <code>CalendarEntrySource<code> objects in the calendar, causing them to retrieve their entries again.
*/
public void refetchAllEntrySources() { }
/**
 * Returns all of the calendar's entries as a BBjVector of <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects.
 *
 * @return BBjVector A BBjVector filled with <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects for all the events in the calendar.
 *
 * @see <a href = 'https://documentation.basis.com/BASISHelp/WebHelp/gridctrl/bbjvector_bbj.htm' target = '_blank'>BBjVector</a>
*/
public BBjVector getEntries() { }
/**
 * Returns all of the calendar's entries as a JsonArray of JsonObject events.
 *
 * @return JsonArray A JsonArray filled with JsonObjects for all the events in the calendar.
*/
public JsonArray getEntriesAsJsonArray() { }
/**
 * Returns all of the calendar's entries as a BBjVector of <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects.
 *
 * @return BBjVector A BBjVector filled with <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects for all the events in the calendar.
 *
 * @see <a href = 'https://documentation.basis.com/BASISHelp/WebHelp/gridctrl/bbjvector_bbj.htm' target = '_blank'>BBjVector</a>
*/
public BBjVector getEntriesWithTag(BBjString tag!) { }
/**
 * Returns all of the calendar's entries as a BBjVector of <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects.
 *
 * @return BBjVector A BBjVector filled with <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects for all the events in the calendar.
 *
 * @see <a href = 'https://documentation.basis.com/BASISHelp/WebHelp/gridctrl/bbjvector_bbj.htm' target = '_blank'>BBjVector</a>
*/
public BBjVector getEntriesWithTags(BBjVector tags!) { }
/**
 * Removes an entry from the calendar given its optional unique ID which must have previously been set.
 *
 * @param BBjString id! A BBjString containing the entry's unique ID.
 *
 * @return BBjNumber A BBjNumber acting as a boolean that indicates whether the event was removed (1) or not (0).
*/
public BBjNumber removeEntryById(BBjString id!) { }
/**
 * Removes an entry from the calendar.
 *
 * @param CalendarEntry entry! The <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> to remove from the calendar.
 *
 * @return BBjNumber A BBjNumber acting as a boolean that indicates whether the event was removed (1) or not (0).
*/
public BBjNumber removeEntry(CalendarEntry entry!) { }
/**
 * Removes all the entries contained in the BBjVector from the calendar.
 * <p>
 * <b>Note</b>: Removing entries from the calendar via this method will trigger the
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_REMOVE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_REMOVE()</a></code> event for each entry that was removed.
 *
 * @param BBjVector entries! A BBjVector filled with the <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects to remove from the the calendar.
 *
 * @return BBjNumber A BBjNumber indicating the number of entries that were removed from the calendar.
*/
public BBjNumber removeEntries(BBjVector entries!) { }
/**
 * Removes all the entries in the calendar.
 * <p>
 * <b>Note</b>: Removing entries from the calendar via this method will trigger the
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_REMOVE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_REMOVE()</a></code> event for each entry that was removed.
 *
 * @return BBjNumber A BBjNumber indicating the number of entries that were removed from the calendar.
*/
public BBjNumber removeAllEntries() { }
/**
 * Updates an entry in the calendar.
 * <p>
 * This method uses the <code>CalendarEntry</code>'s ID (if set) or UUID (if the ID isn't set) to find the entry in the calendar. If found, it removes the
 * old version of the entry from the calendar, then adds the new version of the entry to the calendar. Because of that, if you've registered for the
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_ADD' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_ADD</a></code> or
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_REMOVE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_REMOVE</a></code> events then your callback
 * code will executed as a result of calling this method.
 *
 * @param CalendarEntry entry! The updated <code>CalendarEntry</code> object
 *
 * @return BBjNumber A BBjNumber acting as a boolean that indicates whether the event was updated (1) or not (0). If the entry could not be found in the calendar, the method will return a 0.
 * @since BBj 21.12
*/
public void updateEntry(CalendarEntry entry!) { }
/**
 * Updates several JsonObject entries in a JsonArray to the calendar at once for improved performance.
 * <p>
 * This method iterates through the <code>CalendarEntry</code> objects and calls the same code as the <code>updateEntry()</code> method does. Therefore, it
 * uses the <code>CalendarEntry</code>'s ID (if set) or UUID (if the ID isn't set) to find the entry in the calendar. If found, it removes the
 * old version of the entry from the calendar, then adds the new version of the entry to the calendar. Because of that, if you've registered for the
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_ADD' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_ADD</a></code> or
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_REMOVE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_REMOVE</a></code> events then your callback
 * code will executed once for each entry in the array as a result of calling this method.
 *
 * @param JsonArray entries! A JsonArray filled with JSON objects to be added to the calendar.
 * @since BBj 21.12
*/
public void updateEntries(JsonArray entries!) { }
/**
 * Updates several entries of type <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> to the calendar at once for improved performance.
 * <p>
 * This method iterates through the <code>CalendarEntry</code> objects and calls the same code as the <code>updateEntry()</code> method does. Therefore, it
 * uses the <code>CalendarEntry</code>'s ID (if set) or UUID (if the ID isn't set) to find the entry in the calendar. If found, it removes the
 * old version of the entry from the calendar, then adds the new version of the entry to the calendar. Because of that, if you've registered for the
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_ADD' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_ADD</a></code> or
 * <code><a href = 'CalendarAPI.html#ON_CALENDAR_ENTRY_REMOVE' target = '_blank'>CalendarAPI.ON_CALENDAR_ENTRY_REMOVE</a></code> events then your callback
 * code will executed once for each <code>CalendarEntry</code> in the BBjVector as a result of calling this method.
 *
 * @param BBjVector entries! A BBjVector filled with <code><a href = 'CalendarEntry.html' target = '_blank'>CalendarEntry</a></code> objects to be updated in the calendar.
 * @since BBj 21.12
*/
public void updateEntries(BBjVector entries!) { }
}