Class CalendarComponent

  • All Implemented Interfaces:
    SelectableProvider, ImageObserver, MenuContainer, Serializable, Accessible

    public class CalendarComponent
    extends JPanel
    implements SelectableProvider

    Überschrift: CalendarComponent

    Beschreibung: Oberflächen-Komponente zur Anzeige von einem/mehreren Monaten mit Terminen. Diese Komponente ist für das Interne Scripting zum Zusammenbau von speziellen Lösungen (z.B. Sitzungsmanagement) vorgesehen.

    Copyright: Copyright (c) ELO Digital Office GmbH 2011-2014

    Since:
    8.01.000
    See Also:
    Serialized Form
    • Nested Class Summary

      • Nested classes/interfaces inherited from class JComponent

        JComponent.AccessibleJComponent
      • Nested classes/interfaces inherited from class Component

        Component.BaselineResizeBehavior
    • Field Summary

      • Fields inherited from class JComponent

        TOOL_TIP_TEXT_KEY, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
      • Fields inherited from class Component

        BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
      • Fields inherited from interface ImageObserver

        ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
    • Constructor Summary

      Constructors 
      Constructor Description
      CalendarComponent​(Workspace workspace)
      Normaler Konstruktor
    • Method Summary

      Modifier and Type Method Description
      Appointment addAppointment​(int year, int month, int day, String name, Color background, Color foreground, boolean selectable, int id, Sord sord)
      Fügt einen neuen Termin in den Kalender ein.
      Appointment addAppointment​(Date date, String name, Color background, Color foreground, boolean selectable, int id, Sord sord)
      Fügt einen neuen Termin in den Kalender ein.
      void clear()
      Entfernt alle Termine.
      void deleteAppointment​(int id)
      Entfernt alle Termine mit der angegebenen id.
      void deleteSelectedAppointments()
      Entfernt alle selektierten Termine.
      ArrayList<Appointment> getAppointments​(Date day)
      Liefert die Termine zu einem Tag.
      int getMonthCount()
      Gibt die Anzahl der Monate zurück, die im Kalender angezeigt werden.
      Selectable getSelectable()  
      Appointment getSelectedAppointment()
      Liefert den gerade selektierte Termin.
      Date getSelectedDay()
      Liefert das selektierte Datum des gerade selektierten Tages.
      Date getStart()
      Ermittelt das aktuelle Startdatum der Kalenderanzeige.
      void lastMonth()
      Schaltet den Kalender einen Monat zurück.
      void lastPage()
      Schaltet den Kalender eine Seite (x Monate) zurück.
      void nextMonth()
      Schaltet den Kalender einen Monat weiter.
      void nextPage()
      Schaltet den Kalender eine Seite (x Monate) weiter.
      void refresh()
      Aktualisiert die Kalenderdarstellung.
      void setMonthCount​(int monthCount)
      Setzt die Anzahl der Monate, welche im Kalender angezeigt werden sollen.
      void setSelectionCallback​(BaseFunction callbackFunction, ScriptableObject thisScope)
      Setzt ein Scripting-Event für Selektionsänderungen im Kalender.
      void setSelectionEvent​(String eventName)
      Setzt ein Scripting-Event für Selektionsänderungen im Kalender.
      void setStart​(int year, int month)
      Setzt den Start-Monat.
      void setStart​(Date date)
      Setzt den Start-Monat.
      void showCurrentHalfYear()
      Stellt den Kalender so ein, dass er genau das aktuelle Halbjahr (6 Monate, Januar bis Juni oder Juli bis Dezember) anzeigt.
      void showCurrentQuarterYear()
      Stellt den Kalender so ein, dass er genau das aktuelle Quartal (3 Monate, z.B.
      void showCurrentYear()
      Stellt den Kalender so ein, dass er genau das aktuelle Jahr (12 Monate, Januar bis Dezember) anzeigt.
      void showToday()
      Stellt den Kalender so ein, dass er mit dem aktuellen Monat beginnt.
      • Methods inherited from class JPanel

        getAccessibleContext, getUI, getUIClassID, setUI, updateUI
      • Methods inherited from class JComponent

        addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintImmediately, paintImmediately, print, printAll, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
      • Methods inherited from class Container

        add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate
      • Methods inherited from class Component

        action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, createImage, createImage, createVolatileImage, createVolatileImage, dispatchEvent, enable, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
      • Methods inherited from class Object

        equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
    • Constructor Detail

      • CalendarComponent

        public CalendarComponent​(Workspace workspace)
        Normaler Konstruktor
        Parameters:
        workspace - Aktueller Arbeitsbereich
    • Method Detail

      • showToday

        public void showToday()
        Stellt den Kalender so ein, dass er mit dem aktuellen Monat beginnt.
        Since:
        8.1.0
      • showCurrentYear

        public void showCurrentYear()
        Stellt den Kalender so ein, dass er genau das aktuelle Jahr (12 Monate, Januar bis Dezember) anzeigt.
        Since:
        8.1.0
      • showCurrentHalfYear

        public void showCurrentHalfYear()
        Stellt den Kalender so ein, dass er genau das aktuelle Halbjahr (6 Monate, Januar bis Juni oder Juli bis Dezember) anzeigt.
        Since:
        8.01.000
      • showCurrentQuarterYear

        public void showCurrentQuarterYear()
        Stellt den Kalender so ein, dass er genau das aktuelle Quartal (3 Monate, z.B. Jan, Feb, Mar) anzeigt.
        Since:
        8.01.000
      • setMonthCount

        public void setMonthCount​(int monthCount)
        Setzt die Anzahl der Monate, welche im Kalender angezeigt werden sollen. Ein Aufruf von refresh() ist notwendig, damit die Änderungen sichtbar werden.
        Parameters:
        monthCount - Anzahl der Monate
        Since:
        8.01.000
      • getMonthCount

        public int getMonthCount()
        Gibt die Anzahl der Monate zurück, die im Kalender angezeigt werden.
        Returns:
        Anzahl der angezeigten Monate
        Since:
        8.01.000
      • setStart

        public void setStart​(int year,
                             int month)
        Setzt den Start-Monat. Ein Aufruf von refresh() ist notwendig, damit die Änderungen sichtbar werden.
        Parameters:
        year - Jahr
        month - Monat
        Since:
        8.01.000
      • setStart

        public void setStart​(Date date)
        Setzt den Start-Monat. Ein Aufruf von refresh() ist notwendig, damit die Änderungen sichtbar werden.
        Parameters:
        date - Datum. Nur Jahr und Monat werden verwendet.
        Since:
        8.01.000
      • getStart

        public Date getStart()
        Ermittelt das aktuelle Startdatum der Kalenderanzeige.
        Returns:
        Startdatum der Kalenderanzeige
        Since:
        8.01.000
      • nextMonth

        public void nextMonth()
        Schaltet den Kalender einen Monat weiter.
        Since:
        8.01.000
      • lastMonth

        public void lastMonth()
        Schaltet den Kalender einen Monat zurück.
        Since:
        8.01.000
      • nextPage

        public void nextPage()
        Schaltet den Kalender eine Seite (x Monate) weiter.
        Since:
        8.01.000
      • lastPage

        public void lastPage()
        Schaltet den Kalender eine Seite (x Monate) zurück.
        Since:
        8.01.000
      • addAppointment

        public Appointment addAppointment​(int year,
                                          int month,
                                          int day,
                                          String name,
                                          Color background,
                                          Color foreground,
                                          boolean selectable,
                                          int id,
                                          Sord sord)
        Fügt einen neuen Termin in den Kalender ein. Damit die Änderungen sichtbar werden, ist ein "refresh" notwendig.
        Parameters:
        year - Jahreszahl (1000-6000)
        month - Monat (1-12)
        day - Tag des Monats (1-31)
        name - Die Bezeichnung des Termins
        background - Hintergrundfarbe
        foreground - Vordergrundfarbe
        selectable - True wenn der Termin im Kalender selektierbar sein soll, False wenn der Termin nur informativ angezeigt werden soll.
        id - Frei belegbare ID für diesen Termin
        sord - Das Sord-Objekt zu diesem Termin oder null.
        Returns:
        Der angelegte Termin
        Since:
        8.01.000
      • addAppointment

        public Appointment addAppointment​(Date date,
                                          String name,
                                          Color background,
                                          Color foreground,
                                          boolean selectable,
                                          int id,
                                          Sord sord)
        Fügt einen neuen Termin in den Kalender ein. Damit die Änderungen sichtbar werden, ist ein "refresh" notwendig.
        Parameters:
        date - Datum des Termins
        name - Die Bezeichnung des Termins
        background - Hintergrundfarbe
        foreground - Vordergrundfarbe
        selectable - True wenn der Termin im Kalender selektierbar sein soll, False wenn der Termin nur informativ angezeigt werden soll.
        id - Frei belegbare ID für diesen Termin
        sord - Das Sord-Objekt zu diesem Termin oder null.
        Returns:
        Der angelegte Termin
        Since:
        8.01.000
      • refresh

        public void refresh()
        Aktualisiert die Kalenderdarstellung.
        Since:
        8.01.000
      • deleteAppointment

        public void deleteAppointment​(int id)
        Entfernt alle Termine mit der angegebenen id. Damit die Änderungen sichtbar werden, ist ein "refresh" notwendig.
        Parameters:
        id - Termin Id
        Since:
        8.01.000
      • deleteSelectedAppointments

        public void deleteSelectedAppointments()
        Entfernt alle selektierten Termine. Damit die Änderungen sichtbar werden, ist ein "refresh" notwendig.
        Since:
        8.01.000
      • clear

        public void clear()
        Entfernt alle Termine. Damit die Änderungen sichtbar werden, ist ein "refresh" notwendig.
        Since:
        8.01.000
      • getSelectedDay

        public Date getSelectedDay()
        Liefert das selektierte Datum des gerade selektierten Tages.
        Returns:
        Selektiertes Datum oder null, falls kein Tag selektiert ist.
        Since:
        8.01.000
      • getSelectedAppointment

        public Appointment getSelectedAppointment()
        Liefert den gerade selektierte Termin.
        Returns:
        Selektierter Termin oder null, falls kein Termin selektiert ist.
        Since:
        8.01.000
      • getAppointments

        public ArrayList<Appointment> getAppointments​(Date day)
        Liefert die Termine zu einem Tag.
        Parameters:
        day - Tag
        Returns:
        Lister derTermine
        Since:
        8.01.000
      • setSelectionEvent

        public void setSelectionEvent​(String eventName)
        Setzt ein Scripting-Event für Selektionsänderungen im Kalender.
        Parameters:
        eventName - Name des Events
        Since:
        8.01.000
      • setSelectionCallback

        public void setSelectionCallback​(BaseFunction callbackFunction,
                                         ScriptableObject thisScope)
        Setzt ein Scripting-Event für Selektionsänderungen im Kalender.
        Parameters:
        callbackFunction - JavaScript Funktion, welche bei Selektionsänderungen aufgerufen wird.
        thisScope - "this" Scope der Funktion
        Since:
        10.00.000
      • getSelectable

        public Selectable getSelectable()
        Specified by:
        getSelectable in interface SelectableProvider