JXMonthView UI.* * Note: The api changed considerably between releases 0.9.1 and 0.9.2. Most of * the old methods are still available but deprecated. It's strongly recommended to * update subclasses soon, because those methods will be removed before 0.9.3.
* * The general drift of the change was *
* * Note: this is a pure geometric mapping. The returned rectangle need not * necessarily map to a date in the month which contains the location, it * can represent a week-number/column header or a leading/trailing date. * * @param x the x position of the location in pixel * @param y the y position of the location in pixel * @return the bounds of the day which contains the location, or null if * outside */ protected Rectangle getDayBoundsAtLocation(int x, int y) { Rectangle days = getMonthDetailsBoundsAtLocation(x, y); if ((days == null) || (!days.contains(x, y))) return null; int calendarRow = (y - days.y) / fullBoxHeight; int calendarColumn = (x - days.x) / fullBoxWidth; return new Rectangle(days.x + calendarColumn * fullBoxWidth, days.y + calendarRow * fullBoxHeight, fullBoxWidth, fullBoxHeight); } /** * Returns the logical coordinates of the day which contains the given * location. The p.x of the returned value represents the day of week, the * p.y represents the week of the month. The transformation takes care of * ComponentOrientation. *
* * Note: this is a pure geometric mapping. The returned grid position need not * necessarily map to a date in the month which contains the location, it * can represent a week-number/column header or a leading/trailing date. * * @param x the x position of the location in pixel * @param y the y position of the location in pixel * @return the logical coordinates of the day in the grid of days in a month * or null if outside. */ protected Point getDayGridPositionAtLocation(int x, int y) { Rectangle days = getMonthDetailsBoundsAtLocation(x, y); if ((days == null) ||(!days.contains(x, y))) return null; int calendarRow = (y - days.y) / fullBoxHeight; int calendarColumn = (x - days.x) / fullBoxWidth; if (!isLeftToRight) { int start = days.x + days.width; calendarColumn = (start - x) / fullBoxWidth; } if (monthView.isShowingWeekNumber()) { calendarColumn -= 1; } return new Point(calendarColumn, calendarRow - 1); } /** * Returns the given date's position in the grid of the month it is contained in. * * @param date the Date to get the logical position for, must not be null. * @return the logical coordinates of the day in the grid of days in a * month or null if the Date is not visible. */ protected Point getDayGridPosition(Date date) { if (!isVisible(date)) return null; Calendar calendar = getCalendar(date); Date startOfDay = CalendarUtils.startOfDay(calendar, date); // there must be a less ugly way? // columns CalendarUtils.startOfWeek(calendar); int column = 0; while (calendar.getTime().before(startOfDay)) { column++; calendar.add(Calendar.DAY_OF_MONTH, 1); } Date startOfWeek = CalendarUtils.startOfWeek(calendar, date); calendar.setTime(date); CalendarUtils.startOfMonth(calendar); int row = 0; while (calendar.getTime().before(startOfWeek)) { row++; calendar.add(Calendar.WEEK_OF_YEAR, 1); } return new Point(column, row); } /** * Returns the Date at the given location. May be null if the * coordinates don't map to a day in the month which contains the * coordinates. Specifically: hitting leading/trailing dates returns null. * * Mapping pixel to calendar day. * * @param x the x position of the location in pixel * @param y the y position of the location in pixel * @return the day at the given location or null if the location * doesn't map to a day in the month which contains the coordinates. */ @Override public Date getDayAtLocation(int x, int y) { Point dayInGrid = getDayGridPositionAtLocation(x, y); if ((dayInGrid == null) || (dayInGrid.x < 0) || (dayInGrid.y < 0)) return null; Date month = getMonthAtLocation(x, y); return getDayInMonth(month, dayInGrid.y, dayInGrid.x); } /** * Returns the bounds of the given day. * The bounds are in monthView coordinate system.
* * PENDING JW: this most probably should be public as it is the logical * reverse of getDayAtLocation
* * @param date the Date to return the bounds for. Must not be null. * @return the bounds of the given date or null if not visible. */ protected Rectangle getDayBounds(Date date) { if (!isVisible(date)) return null; Point position = getDayGridPosition(date); Rectangle monthBounds = getMonthBounds(date); monthBounds.y += getMonthHeaderHeight() + (position.y + 1) * fullBoxHeight; if (monthView.isShowingWeekNumber()) { position.x++; } if (isLeftToRight) { monthBounds.x += position.x * fullBoxWidth; } else { int start = monthBounds.x + monthBounds.width - fullBoxWidth; monthBounds.x = start - position.x * fullBoxWidth; } monthBounds.width = fullBoxWidth; monthBounds.height = fullBoxHeight; return monthBounds; } /** * Returns a boolean indicating if the given Date is visible. Trailing/leading * dates of the last/first displayed month are considered to be invisible. * * @param date the Date to check for visibility. Must not be null. * @return true if the date is visible, false otherwise. */ private boolean isVisible(Date date) { if (getFirstDisplayedDay().after(date) || getLastDisplayedDay().before(date)) return false; return true; } /** * Returns the Date defined by the logical * grid coordinates relative to the given month. May be null if the * logical coordinates represent a header in the day grid or is outside of the * given month. * * Mapping logical day grid coordinates to Date.
* * PENDING JW: relax the startOfMonth pre? Why did I require it? * * @param month a calendar representing the first day of the month, must not * be null. * @param row the logical row index in the day grid of the month * @param column the logical column index in the day grid of the month * @return the day at the logical grid coordinates in the given month or null * if the coordinates * @throws IllegalStateException if the month is not the start of the month. */ protected Date getDayInMonth(Date month, int row, int column) { if ((row < 0) || (column < 0)) return null; Calendar calendar = getCalendar(month); int monthField = calendar.get(Calendar.MONTH); if (!CalendarUtils.isStartOfMonth(calendar)) throw new IllegalStateException("calendar must be start of month but was: " + month.getTime()); CalendarUtils.startOfWeek(calendar); calendar.add(Calendar.DAY_OF_MONTH, row * JXMonthView.DAYS_IN_WEEK + column); if (calendar.get(Calendar.MONTH) == monthField) { return calendar.getTime(); } return null; } // ------------------- mapping month parts /** * Mapping pixel to bounds.
* * PENDING JW: define the "action grid". Currently this replaces the old * version to remove all internal usage of deprecated methods. * * @param x the x position of the location in pixel * @param y the y position of the location in pixel * @return the bounds of the active header area in containing the location * or null if outside. */ protected int getTraversableGridPositionAtLocation(int x, int y) { Rectangle headerBounds = getMonthHeaderBoundsAtLocation(x, y); if (headerBounds == null) return -1; if (y < headerBounds.y + arrowPaddingY) return -1; if (y > headerBounds.y + headerBounds.height - arrowPaddingY) return -1; headerBounds.setBounds(headerBounds.x + arrowPaddingX, y, headerBounds.width - 2 * arrowPaddingX, headerBounds.height); if (!headerBounds.contains(x, y)) return -1; Rectangle hitArea = new Rectangle(headerBounds.x, headerBounds.y, monthUpImage.getIconWidth(), monthUpImage.getIconHeight()); if (hitArea.contains(x, y)) { return isLeftToRight ? MONTH_DOWN : MONTH_UP; } hitArea.translate(headerBounds.width - monthUpImage.getIconWidth(), 0); if (hitArea.contains(x, y)) { return isLeftToRight ? MONTH_UP : MONTH_DOWN; } return -1; } /** * Returns the bounds of the month header which contains the * given location. The bounds are in monthView coordinate system. * *
* * @param x the x position of the location in pixel * @param y the y position of the location in pixel * @return the bounds of the month which contains the location, * or null if outside */ protected Rectangle getMonthHeaderBoundsAtLocation(int x, int y) { Rectangle header = getMonthBoundsAtLocation(x, y); if (header == null) return null; header.height = getMonthHeaderHeight(); return header; } /** * Returns the bounds of the month details which contains the * given location. The bounds are in monthView coordinate system. * * @param x the x position of the location in pixel * @param y the y position of the location in pixel * @return the bounds of the details grid in the month at * location or null if outside. */ private Rectangle getMonthDetailsBoundsAtLocation(int x, int y) { Rectangle month = getMonthBoundsAtLocation(x, y); if (month == null) return null; int startOfDaysY = month.y + getMonthHeaderHeight(); if (y < startOfDaysY) return null; month.y = startOfDaysY; month.height = month.height - getMonthHeaderHeight(); return month; } // ---------------------- mapping month coordinates /** * Returns the bounds of the month which contains the * given location. The bounds are in monthView coordinate system. * *
* * Mapping pixel to bounds. * * @param x the x position of the location in pixel * @param y the y position of the location in pixel * @return the bounds of the month which contains the location, * or null if outside */ protected Rectangle getMonthBoundsAtLocation(int x, int y) { if (!calendarGrid.contains(x, y)) return null; int calendarRow = (y - calendarGrid.y) / fullCalendarHeight; int calendarColumn = (x - calendarGrid.x) / fullCalendarWidth; return new Rectangle( calendarGrid.x + calendarColumn * fullCalendarWidth, calendarGrid.y + calendarRow * fullCalendarHeight, calendarWidth, calendarHeight); } /** * * Returns the logical coordinates of the month which contains * the given location. The p.x of the returned value represents the column, the * p.y represents the row the month is shown in. The transformation takes * care of ComponentOrientation.
* * Mapping pixel to logical grid coordinates. * * @param x the x position of the location in pixel * @param y the y position of the location in pixel * @return the logical coordinates of the month in the grid of month shown by * this monthView or null if outside. */ protected Point getMonthGridPositionAtLocation(int x, int y) { if (!calendarGrid.contains(x, y)) return null; int calendarRow = (y - calendarGrid.y) / fullCalendarHeight; int calendarColumn = (x - calendarGrid.x) / fullCalendarWidth; if (!isLeftToRight) { int start = calendarGrid.x + calendarGrid.width; calendarColumn = (start - x) / fullCalendarWidth; } return new Point(calendarColumn, calendarRow); } /** * Returns the Date representing the start of the month which * contains the given location.
* * Mapping pixel to calendar day. * * @param x the x position of the location in pixel * @param y the y position of the location in pixel * @return the start of the month which contains the given location or * null if the location is outside the grid of months. */ protected Date getMonthAtLocation(int x, int y) { Point month = getMonthGridPositionAtLocation(x, y); if (month == null) return null; return getMonth(month.y, month.x); } /** * Returns the Date representing the start of the month at the given * logical position in the grid of months.
* * Mapping logical grid coordinates to Calendar. * * @param row the rowIndex in the grid of months. * @param column the columnIndex in the grid months. * @return a Date representing the start of the month at the given * logical coordinates. * * @see #getMonthGridPosition(Date) */ protected Date getMonth(int row, int column) { Calendar calendar = getCalendar(); calendar.add(Calendar.MONTH, row * calendarColumnCount + column); return calendar.getTime(); } /** * Returns the logical grid position of the month containing the given date. * The Point's x value is the column in the grid of months, the y value * is the row in the grid of months. * * Mapping Date to logical grid position, this is the reverse of getMonth(int, int). * * @param date the Date to return the bounds for. Must not be null. * @return the postion of the month that contains the given date or null if not visible. * * @see #getMonth(int, int) * @see #getMonthBounds(int, int) */ protected Point getMonthGridPosition(Date date) { if (!isVisible(date)) return null; // start of grid Calendar calendar = getCalendar(); int firstMonth = calendar.get(Calendar.MONTH); int firstYear = calendar.get(Calendar.YEAR); // calendar.setTime(date); int month = calendar.get(Calendar.MONTH); int year = calendar.get(Calendar.YEAR); int diffMonths = month - firstMonth + ((year - firstYear) * JXMonthView.MONTHS_IN_YEAR); int row = diffMonths / calendarColumnCount; int column = diffMonths % calendarColumnCount; return new Point(column, row); } /** * Returns the bounds of the month at the given logical coordinates * in the grid of visible months.
* * Mapping logical grip position to pixel. * * @param row the rowIndex in the grid of months. * @param column the columnIndex in the grid months. * @return the bounds of the month at the given logical logical position. * * @see #getMonthGridPositionAtLocation(int, int) * @see #getMonthBoundsAtLocation(int, int) */ protected Rectangle getMonthBounds(int row, int column) { int startY = calendarGrid.y + row * fullCalendarHeight; int startX = calendarGrid.x + column * fullCalendarWidth; if (!isLeftToRight) { startX = calendarGrid.x + (calendarColumnCount - 1 - column) * fullCalendarWidth; } return new Rectangle(startX, startY, calendarWidth, calendarHeight); } /** * Returns the bounds of the month containing the given date. * The bounds are in monthView coordinate system.
* * Mapping Date to pixel. * * @param date the Date to return the bounds for. Must not be null. * @return the bounds of the month that contains the given date or null if not visible. * * @see #getMonthAtLocation(int, int) */ protected Rectangle getMonthBounds(Date date) { Point position = getMonthGridPosition(date); return position != null ? getMonthBounds(position.y, position.x) : null; } //---------------- accessors for sizes /** * Returns the size of a month. * @return the size of a month. */ protected Dimension getMonthSize() { return new Dimension(calendarWidth, calendarHeight); } /** * Returns the size of a day including the padding. * @return the size of a month. */ protected Dimension getDaySize() { return new Dimension(fullBoxWidth, fullBoxHeight); } /** * Returns the height of the month header. * * @return the height of the month header. */ protected int getMonthHeaderHeight() { return fullMonthBoxHeight; } //------------------- layout /** * Called from layout: calculates properties * of grid of months. */ private void calculateMonthGridLayoutProperties() { calculateMonthGridRowColumnCount(); calculateMonthGridBounds(); } /** * Calculates the bounds of the grid of months. * * CalendarRow/ColumnCount and calendarWidth/Height must be * initialized before calling this. */ private void calculateMonthGridBounds() { // PENDING JW: this is the "old way" - keep until the deprecated // methods are removed. calculateStartPositionUnused(); calendarGrid.setBounds(calculateCalendarGridX(), calculateCalendarGridY(), calculateCalendarGridWidth(), calculateCalendarGridHeight()); } private int calculateCalendarGridY() { return (monthView.getHeight() - calculateCalendarGridHeight()) / 2; } private int calculateCalendarGridX() { return (monthView.getWidth() - calculateCalendarGridWidth()) / 2; } private int calculateCalendarGridHeight() { return ((calendarHeight * calendarRowCount) + (CALENDAR_SPACING * (calendarRowCount - 1 ))); } private int calculateCalendarGridWidth() { return ((calendarWidth * calendarColumnCount) + (CALENDAR_SPACING * (calendarColumnCount - 1))); } /** * Calculates and updates the numCalCols/numCalRows that determine the number of * calendars that can be displayed. Updates the last displayed date if * appropriate. * */ private void calculateMonthGridRowColumnCount() { int oldNumCalCols = calendarColumnCount; int oldNumCalRows = calendarRowCount; // Determine how many columns of calendars we want to paint. calendarColumnCount = 1; int addColumns = (monthView.getWidth() - calendarWidth) / (calendarWidth + CALENDAR_SPACING); // happens if used as renderer in a tree.. don't know yet why if (addColumns > 0) { calendarColumnCount += addColumns; } // Determine how many rows of calendars we want to paint. calendarRowCount = 1; int addRows = (monthView.getHeight() - calendarHeight) / (calendarHeight + CALENDAR_SPACING); if (addRows > 0) { calendarRowCount += addRows; } if (oldNumCalCols != calendarColumnCount || oldNumCalRows != calendarRowCount) { updateLastDisplayedDay(getFirstDisplayedDay()); } } //-------------------- painting /** * {@inheritDoc} */ @Override public void paint(Graphics g, JComponent c) { super.paint(g, c); Object oldAAValue = null; Graphics2D g2 = (g instanceof Graphics2D) ? (Graphics2D)g : null; if (g2 != null && monthView.isAntialiased()) { oldAAValue = g2.getRenderingHint( RenderingHints.KEY_TEXT_ANTIALIASING); g2.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, RenderingHints.VALUE_TEXT_ANTIALIAS_ON); } Rectangle clip = g.getClipBounds(); Graphics tmp = g.create(); paintBackground(clip, tmp); tmp.dispose(); g.setColor(monthView.getForeground()); // Get a calender set to the first displayed date Calendar cal = getCalendar(); // Center the calendars horizontally/vertically in the available space. for (int row = 0; row < calendarRowCount; row++) { // Check if this row falls in the clip region. for (int column = 0; column < calendarColumnCount; column++) { bounds = getMonthBounds(row, column); if (bounds.intersects(clip)) { paintMonth(g, bounds.x, bounds.y, bounds.width, bounds.height, cal); } // JW: clarified contract for all paint methods: // called methods must not change the calendar, its the responsibility cal.add(Calendar.MONTH, 1); } } if (g2 != null && monthView.isAntialiased()) { g2.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, oldAAValue); } } /** * Paints a month. It is assumed the given calendar is already set to the * first day of the month to be painted.
* * Note: the given calendar must not be changed. * * @param g Graphics object. * @param x x location of month * @param y y location of month * @param width width of month * @param height height of month * @param calendar the calendar specifying the the first day of the month to paint, * must not be null */ @SuppressWarnings({"UnusedDeclaration"}) protected void paintMonth(Graphics g, int x, int y, int width, int height, Calendar calendar) { // PEINDING JW: remove usage of deprecated api // use Date instead of millis // Paint month name background. paintMonthStringBackground(g, x, y, width, fullMonthBoxHeight, calendar); paintMonthStringForeground(g, x, y, width, fullMonthBoxHeight, calendar); // Paint arrow buttons for traversing months if enabled. if (monthView.isTraversable()) { //draw the icons monthDownImage.paintIcon(monthView, g, x + arrowPaddingX, y + ((fullMonthBoxHeight - monthDownImage.getIconHeight()) / 2)); monthUpImage.paintIcon(monthView, g, x + width - arrowPaddingX - monthUpImage.getIconWidth(), y + ((fullMonthBoxHeight - monthDownImage.getIconHeight()) / 2)); } // Paint background of the short names for the days of the week. boolean showingWeekNumber = monthView.isShowingWeekNumber(); int tmpX = isLeftToRight ? x + (showingWeekNumber ? fullBoxWidth : 0) : x; int tmpY = y + fullMonthBoxHeight; int tmpWidth = width - (showingWeekNumber ? fullBoxWidth : 0); paintDayOfTheWeekBackground(g, tmpX, tmpY, tmpWidth, fullBoxHeight, calendar); // Paint short representation of day of the week. int dayIndex = monthView.getFirstDayOfWeek() - 1; Font oldFont = monthView.getFont(); g.setFont(derivedFont); g.setColor(monthView.getDaysOfTheWeekForeground()); FontMetrics fm = monthView.getFontMetrics(derivedFont); String[] daysOfTheWeek = monthView.getDaysOfTheWeek(); for (int i = 0; i < JXMonthView.DAYS_IN_WEEK; i++) { tmpX = isLeftToRight ? x + (i * fullBoxWidth) + monthView.getBoxPaddingX() + (boxWidth / 2) - (fm.stringWidth(daysOfTheWeek[dayIndex]) / 2) : x + width - (i * fullBoxWidth) - monthView.getBoxPaddingX() - (boxWidth / 2) - (fm.stringWidth(daysOfTheWeek[dayIndex]) / 2); if (showingWeekNumber) { tmpX += isLeftToRight ? fullBoxWidth : -fullBoxWidth; } tmpY = y + fullMonthBoxHeight + monthView.getBoxPaddingY() + fm.getAscent(); g.drawString(daysOfTheWeek[dayIndex], tmpX, tmpY); dayIndex++; if (dayIndex == JXMonthView.DAYS_IN_WEEK) { dayIndex = 0; } } g.setFont(oldFont); // new top is below monthBox and daysOfWeek header int yNew = y + fullMonthBoxHeight + fullBoxHeight; // paint the column of week numbers paintWeeksOfYear(g, x, yNew, width, calendar); int xOffset = 0; if (monthView.isShowingWeekNumber()) { xOffset = fullBoxWidth; } if (isLeftToRight) { paintDays(g, x + xOffset, yNew, width - xOffset, calendar); } else { paintDays(g, x , yNew, width - xOffset, calendar); } } /** * * Paints all days in the days' grid, that is the month area below * the daysOfWeek and to the right/left (depending on * the monthView's componentOrientation) of the weekOfYears. * The calendar * represents the first day of the month to paint.
* * Note: the calendar must not be changed. * * @param g Graphics object. * @param left the left boundary of the day grid. * @param top the upper boundary of the day grid * @param width the width of the day grid. * @param cal the calendar specifying the the first day of the month to paint, * must not be null */ protected void paintDays(Graphics g, int left, int top, int width, Calendar cal) { Calendar calendar = (Calendar) cal.clone(); CalendarUtils.startOfMonth(calendar); Date startOfMonth = calendar.getTime(); CalendarUtils.endOfMonth(calendar); Date endOfMonth = calendar.getTime(); // reset the clone calendar.setTime(cal.getTime()); // alwaysfill the day grid in the month completely // int weeks = getWeeks(calendar); // adjust to start of week calendar.setTime(cal.getTime()); CalendarUtils.startOfWeek(calendar); // painting a grid of day boxes, all with dimensions // width == fullBoxWidth and height = fullBoxHeight. int topOfDay = top; // for (int week = 0; week < WEEKS_IN_MONTH; week++) { // PENDING JW: further simplify - now that we have the reverse mapping // (from logical to bounds) - use it! That will keep the RToL logic // out of here (which was the whole point of introducing logical coords). // for (int week = 0; week <= weeks; week++) { int leftOfDay = isLeftToRight ? left : left + width - fullBoxWidth; for (int day = 0; day < 7; day++) { if (calendar.getTime().before(startOfMonth)) { // leading paintLeadingDay(g, leftOfDay, topOfDay, calendar); } else if (calendar.getTime().after(endOfMonth)) { paintTrailingDay(g, leftOfDay, topOfDay, calendar); } else { paintDay(g, leftOfDay, topOfDay, calendar); } leftOfDay = isLeftToRight ? leftOfDay + fullBoxWidth : leftOfDay - fullBoxWidth; calendar.add(Calendar.DAY_OF_MONTH, 1); } // the assumption is not always true - fails if we had the turn-on of DST with // if (!CalendarUtils.isStartOfWeek(calendar)) { // throw new IllegalStateException("started painting at " + firstStartOfWeek + // " should still be on the start of a week instead of " + calendar.getTime()); // } topOfDay += fullBoxHeight; } } /** * Paints a day the current month, represented by the calendar in a day-box * located at left/top. The size of the day-box is defined by * fullBoxWidth/Height. The appearance of the day depends on its state (like * unselectable, flagged, selected) *
* * Note: the given calendar must not be changed. * * @param g the Graphics to paint into. * @param left the left boundary of the day-box to paint. * @param top the upper boundary of the day-box to paint. * @param calendar the calendar specifying the the day to paint, must not be * null */ protected void paintDay(Graphics g, int left, int top, Calendar calendar) { if (monthView.isUnselectableDate(calendar.getTime())) { paintUnselectableDayBackground(g, left, top, fullBoxWidth, fullBoxHeight, calendar); paintUnselectableDayForeground(g, left, top, fullBoxWidth, fullBoxHeight, calendar); } else if (monthView.isFlaggedDate(calendar.getTime())) { paintFlaggedDayBackground(g, left, top, fullBoxWidth, fullBoxHeight, calendar); paintFlaggedDayForeground(g, left, top, fullBoxWidth, fullBoxHeight, calendar); } else { paintDayBackground(g, left, top, fullBoxWidth, fullBoxHeight, calendar); paintDayForeground(g, left, top, fullBoxWidth, fullBoxHeight, calendar); } } /** * Paints a trailing day of the current month, represented by the calendar, * in a day-box located at left/top. The size of the day-box is defined by * fullBoxWidth/Height. Does nothing if the monthView's * isShowingTrailingDates is false. *
* * Note: the given calendar must not be changed. * * @param g the Graphics to paint into. * @param left the left boundary of the day-box to paint. * @param top the upper boundary of the day-box to paint. * @param calendar the calendar specifying the the day to paint, must not be * null */ protected void paintTrailingDay(Graphics g, int left, int top, Calendar calendar) { if (!monthView.isShowingTrailingDays()) return; paintTrailingDayBackground(g, left, top, fullBoxWidth, fullBoxHeight, calendar); paintTrailingDayForeground(g, left, top, fullBoxWidth, fullBoxHeight, calendar); } /** * Paints a leading day of the current month, represented by the calendar, * in a day-box located at left/top. The size of the day-box is defined by * fullBoxWidth/Height. Does nothing if the monthView's * isShowingLeadingDates is false. *
* * Note: the given calendar must not be changed. * * @param g the Graphics to paint into. * @param left the left boundary of the day-box to paint. * @param top the upper boundary of the day-box to paint. * @param calendar the calendar specifying the the day to paint, must not be * null */ protected void paintLeadingDay(Graphics g, int left, int top, Calendar calendar) { if (!monthView.isShowingLeadingDays()) return; paintLeadingDayBackground(g, left, top, fullBoxWidth, fullBoxHeight, calendar); paintLeadingDayForeground(g, left, top, fullBoxWidth, fullBoxHeight, calendar); } /** * Returns the number of weeks to paint in the current month, as represented * by the given calendar. * * Note: the given calendar must not be changed. * * @param month the calendar specifying the the first day of the month to * paint, must not be null * @return the number of weeks of this month. */ protected int getWeeks(Calendar month) { Date old = month.getTime(); CalendarUtils.startOfWeek(month); int firstWeek = month.get(Calendar.WEEK_OF_YEAR); month.setTime(old); CalendarUtils.endOfMonth(month); int lastWeek = month.get(Calendar.WEEK_OF_YEAR); if (lastWeek < firstWeek) { lastWeek = month.getActualMaximum(Calendar.WEEK_OF_YEAR) + 1; } month.setTime(old); return lastWeek - firstWeek; } /** * Paints the weeks of year if the showingWeek property is true. Does nothing * otherwise. * * It is assumed the given calendar is already set to the * first day of the month. The calendar is unchanged when leaving this method. * * Note: the given calendar must not be changed. * * PENDING JW: this implementation doesn't need the height - should it be given * anyway for symetry in case subclasses need it? * * @param g Graphics object. * @param x x location of month * @param initialY y the upper bound of the "weekNumbers-box" * @param width width of month * @param cal the calendar specifying the the first day of the month to paint, * must not be null */ protected void paintWeeksOfYear(Graphics g, int x, int initialY, int width, Calendar cal) { if (!monthView.isShowingWeekNumber()) return; int tmpX = isLeftToRight ? x : x + width - fullBoxWidth; paintWeekOfYearBackground(g, tmpX, initialY, fullBoxWidth, calendarHeight - (fullMonthBoxHeight + fullBoxHeight), cal); Calendar calendar = (Calendar) cal.clone(); int weeks = getWeeks(calendar); calendar.setTime(cal.getTime()); for (int weekOfYear = 0; weekOfYear <= weeks; weekOfYear++) { paintWeekOfYearForeground(g, tmpX, initialY, fullBoxWidth, fullBoxHeight, calendar); initialY += fullBoxHeight; calendar.add(Calendar.WEEK_OF_YEAR, 1); } } protected void paintDayOfTheWeekBackground(Graphics g, int x, int y, int width, int height, Calendar cal) { int boxPaddingX = monthView.getBoxPaddingX(); g.drawLine(x + boxPaddingX, y + height - 1, x + width - boxPaddingX, y + height - 1); } protected void paintWeekOfYearBackground(Graphics g, int x, int y, int width, int height, Calendar cal) { int boxPaddingY = monthView.getBoxPaddingY(); x = isLeftToRight ? x + width - 1 : x; g.drawLine(x, y + boxPaddingY, x, y + height - boxPaddingY); } /** * Paints the week of the year of the week of the year represented by the * given calendar. *
* * Note: the given calendar must not be changed. * * @param g Graphics object * @param x x-coordinate of upper left corner. * @param y y-coordinate of upper left corner. * @param width width of bounding box * @param height height of bounding box */ @SuppressWarnings({"UNUSED_SYMBOL", "UnusedDeclaration"}) protected void paintWeekOfYearForeground(Graphics g, int x, int y, int width, int height, Calendar cal) { String str = Integer.toString(cal.get(Calendar.WEEK_OF_YEAR)); FontMetrics fm; g.setColor(weekOfTheYearForeground); int boxPaddingX = monthView.getBoxPaddingX(); int boxPaddingY = monthView.getBoxPaddingY(); fm = g.getFontMetrics(); g.drawString(str, isLeftToRight ? x + boxPaddingX + boxWidth - fm.stringWidth(str) : x + boxPaddingX + boxWidth - fm.stringWidth(str) - 1, y + boxPaddingY + fm.getAscent()); } /** * Paints the background of the month string. The bounding box for this * background can be modified by setting its insets via * setMonthStringInsets. The color of the background can be set via * setMonthStringBackground. * * Note: the given calendar must not be changed. * * @param g Graphics object to paint to. * @param x x-coordinate of upper left corner. * @param y y-coordinate of upper left corner. * @param width width of the bounding box. * @param height height of the bounding box. * * @see org.jdesktop.swingx.JXMonthView#setMonthStringBackground * @see org.jdesktop.swingx.JXMonthView#setMonthStringInsets */ protected void paintMonthStringBackground(Graphics g, int x, int y, int width, int height, Calendar cal) { // Modify bounds by the month string insets. Insets monthStringInsets = monthView.getMonthStringInsets(); x = isLeftToRight ? x + monthStringInsets.left : x + monthStringInsets.right; y = y + monthStringInsets.top; width = width - monthStringInsets.left - monthStringInsets.right; height = height - monthStringInsets.top - monthStringInsets.bottom; g.setColor(monthView.getMonthStringBackground()); g.fillRect(x, y, width, height); } /** * Note: the given calendar must not be changed. * * @param g Graphics object to paint to. * @param x x-coordinate of upper left corner. * @param y y-coordinate of upper left corner. * @param width width of the bounding box. * @param height height of the bounding box. * @param cal the calendar specifying the day to use, must not be null */ protected void paintMonthStringForeground(Graphics g, int x, int y, int width, int height, Calendar cal) { // Paint month name. // Font oldFont = monthView.getFont(); // TODO: Calculating the bounds of the text dynamically so we can invoke // a popup for selecting the month/year to view. g.setFont(derivedFont); FontMetrics fm = monthView.getFontMetrics(derivedFont); int month = cal.get(Calendar.MONTH); String monthName = monthsOfTheYear[month]; String yearString = Integer.toString(cal.get(Calendar.YEAR)); Rectangle2D rect = fm.getStringBounds(monthName, g); monthStringBounds[month] = new Rectangle((int) rect.getX(), (int) rect.getY(), (int) rect.getWidth(), (int) rect.getHeight()); int spaceWidth = (int) fm.getStringBounds(" ", g).getWidth(); rect = fm.getStringBounds(yearString, g); yearStringBounds[month] = new Rectangle((int) rect.getX(), (int) rect.getY(), (int) rect.getWidth(), (int) rect.getHeight()); // END g.setColor(monthView.getMonthStringForeground()); int tmpX = x + (calendarWidth / 2) - ((monthStringBounds[month].width + yearStringBounds[month].width + spaceWidth) / 2); int tmpY = y + monthView.getBoxPaddingY() + ((monthBoxHeight - boxHeight) / 2) + fm.getAscent(); monthStringBounds[month].x = tmpX; yearStringBounds[month].x = (monthStringBounds[month].x + monthStringBounds[month].width + spaceWidth); paintMonthStringForeground(g,monthName, monthStringBounds[month].x, tmpY, yearString, yearStringBounds[month].x, tmpY, cal); g.setFont(oldFont); } /** * Paints only text for month and year. No calculations made. Used by custom LAFs. *
* * Note: the given calendar must not be changed. * * @param g Graphics to paint into. * @param monthName Name of the month. * @param monthX Month string x coordinate. * @param monthY Month string y coordinate. * @param yearName Name (number) of the year. * @param yearX Year string x coordinate. * @param yearY Year string y coordinate. */ protected void paintMonthStringForeground(Graphics g, String monthName, int monthX, int monthY, String yearName, int yearX, int yearY, Calendar cal) { g.drawString(monthName, monthX, monthY); g.drawString(yearName, yearX, yearY); } /** * Paint the background for the day specified by the given calendar. *
* * Note: the given calendar must not be changed. * * * @param g Graphics object to paint to * @param x x-coordinate of upper left corner * @param y y-coordinate of upper left corner * @param width width of bounding box for the day * @param height height of bounding box for the day * @param cal the calendar specifying the day to paint, must not be null * @see org.jdesktop.swingx.JXMonthView#isSelectedDate * @see #isToday */ protected void paintDayBackground(Graphics g, int x, int y, int width, int height, Calendar cal) { Date date = cal.getTime(); //InMillis(); if (monthView.isSelected(date)) { g.setColor(monthView.getSelectedBackground()); g.fillRect(x, y, width, height); } // If the date is today make sure we draw it's background over the selected // background. if (isToday(date)) { g.setColor(monthView.getTodayBackground()); g.drawRect(x, y, width - 1, height - 1); } } /** * Paint the foreground for the specified day. *
* * Note: the given calendar must not be changed. * * @param g Graphics object to paint to * @param x x-coordinate of upper left corner * @param y y-coordinate of upper left corner * @param width width of bounding box for the day * @param height height of bounding box for the day * @param cal the calendar specifying the day to paint, must not be null */ protected void paintDayForeground(Graphics g, int x, int y, int width, int height, Calendar cal) { String numericDay = dayOfMonthFormatter.format(cal.getTime()); g.setColor(monthView.getDayForeground(cal.get(Calendar.DAY_OF_WEEK))); int boxPaddingX = monthView.getBoxPaddingX(); int boxPaddingY = monthView.getBoxPaddingY(); paintDayForeground(g, numericDay, isLeftToRight ? x + boxPaddingX + boxWidth : x + boxPaddingX + boxWidth - 1, y + boxPaddingY, cal); } /** * Paints string of the day. No calculations made. Used by LAFs. *
*
* Note: the given calendar must not be changed.
* @param g Graphics to paint on.
* @param numericDay Text representation of the day.
* @param x X coordinate of the upper right corner.
* @param y Y coordinate of the upper right corner.
*/
protected void paintDayForeground(Graphics g, String numericDay, int x, int y, Calendar cal) {
FontMetrics fm = g.getFontMetrics();
g.drawString(numericDay, x - fm.stringWidth(numericDay), y + fm.getAscent());
}
/**
* Paint the background for the specified flagged day. The default implementation just calls
* paintDayBackground.
*
* * Note: the given calendar must not be changed. * * @param g Graphics object to paint to * @param x x-coordinate of upper left corner * @param y y-coordinate of upper left corner * @param width width of bounding box for the day * @param height height of bounding box for the day * @param cal the calendar specifying the day to paint, must not be null */ protected void paintFlaggedDayBackground(Graphics g, int x, int y, int width, int height, Calendar cal) { paintDayBackground(g, x, y, width, height, cal); } /** * Paint the foreground for the specified flagged day. *
* * Note: the given calendar must not be changed. * * @param g Graphics object to paint to * @param x x-coordinate of upper left corner * @param y y-coordinate of upper left corner * @param width width of bounding box for the day * @param height height of bounding box for the day * @param cal the calendar specifying the day to paint, must not be null */ protected void paintFlaggedDayForeground(Graphics g, int x, int y, int width, int height, Calendar cal) { Date date = cal.getTime(); String numericDay = dayOfMonthFormatter.format(date); FontMetrics fm; int boxPaddingX = monthView.getBoxPaddingX(); int boxPaddingY = monthView.getBoxPaddingY(); Font oldFont = monthView.getFont(); g.setColor(monthView.getFlaggedDayForeground()); g.setFont(derivedFont); fm = monthView.getFontMetrics(derivedFont); g.drawString(numericDay, isLeftToRight ? x + boxPaddingX + boxWidth - fm.stringWidth(numericDay): x + boxPaddingX + boxWidth - fm.stringWidth(numericDay) - 1, y + boxPaddingY + fm.getAscent()); g.setFont(oldFont); } /** * Paint the foreground for the specified unselectable day. *
* * Note: the given calendar must not be changed. * * @param g Graphics object to paint to * @param x x-coordinate of upper left corner * @param y y-coordinate of upper left corner * @param width width of bounding box for the day * @param height height of bounding box for the day * @param cal the calendar specifying the day to paint, must not be null */ protected void paintUnselectableDayBackground(Graphics g, int x, int y, int width, int height, Calendar cal) { paintDayBackground(g, x, y, width, height, cal); } /** * Paint the foreground for the specified unselectable day. *
* * Note: the given calendar must not be changed. * * @param g Graphics object to paint to * @param x x-coordinate of upper left corner * @param y y-coordinate of upper left corner * @param width width of bounding box for the day * @param height height of bounding box for the day * @param cal the calendar specifying the day to paint, must not be null */ protected void paintUnselectableDayForeground(Graphics g, int x, int y, int width, int height, Calendar cal) { paintDayForeground(g, x, y, width, height, cal); g.setColor(unselectableDayForeground); String numericDay = dayOfMonthFormatter.format(cal.getTime()); FontMetrics fm = monthView.getFontMetrics(derivedFont); int boxPaddingX = monthView.getBoxPaddingX(); int boxPaddingY = monthView.getBoxPaddingY(); width = fm.stringWidth(numericDay); height = fm.getAscent(); x = isLeftToRight ? x + boxPaddingX + boxWidth - fm.stringWidth(numericDay) : x + boxPaddingX + boxWidth - fm.stringWidth(numericDay) - 1; y = y + boxPaddingY; g.drawLine(x, y, x + width, y + height); g.drawLine(x + 1, y, x + width + 1, y + height); g.drawLine(x + width, y, x, y + height); g.drawLine(x + width - 1, y, x - 1, y + height); } /** * Paint the background for the specified leading day. *
* * Note: the given calendar must not be changed. * * @param g Graphics object to paint to * @param x x-coordinate of upper left corner * @param y y-coordinate of upper left corner * @param width width of bounding box for the day * @param height height of bounding box for the day * @param cal the calendar specifying the day to paint, must not be null */ protected void paintLeadingDayBackground(Graphics g, int x, int y, int width, int height, Calendar cal) { paintDayBackground(g, x, y, width, height, cal); } /** * Paint the foreground for the specified leading day. *
* * Note: the given calendar must not be changed. * * @param g Graphics object to paint to * @param x x-coordinate of upper left corner * @param y y-coordinate of upper left corner * @param width width of bounding box for the day * @param height height of bounding box for the day * @param cal the calendar specifying the day to paint, must not be null */ protected void paintLeadingDayForeground(Graphics g, int x, int y, int width, int height, Calendar cal) { String numericDay = dayOfMonthFormatter.format(cal.getTime()); FontMetrics fm; g.setColor(leadingDayForeground); int boxPaddingX = monthView.getBoxPaddingX(); int boxPaddingY = monthView.getBoxPaddingY(); fm = g.getFontMetrics(); int ltorOffset = x + boxPaddingX + boxWidth - fm.stringWidth(numericDay); g.drawString(numericDay, isLeftToRight ? ltorOffset : ltorOffset - 1, y + boxPaddingY + fm.getAscent()); } /** * Paint the background for the specified trailing day. *
* * Note: the given calendar must not be changed. * * @param g Graphics object to paint to * @param x x-coordinate of upper left corner * @param y y-coordinate of upper left corner * @param width width of bounding box for the day * @param height height of bounding box for the day * @param cal the calendar specifying the day to paint, must not be null */ protected void paintTrailingDayBackground(Graphics g, int x, int y, int width, int height, Calendar cal) { paintLeadingDayBackground(g, x, y, width, height, cal); } /** * Paint the foreground for the specified trailing day. *
*
* Note: the given calendar must not be changed.
*
* @param g Graphics object to paint to
* @param x x-coordinate of upper left corner
* @param y y-coordinate of upper left corner
* @param width width of bounding box for the day
* @param height height of bounding box for the day
* @param cal the calendar specifying the day to paint, must not be null
*/
protected void paintTrailingDayForeground(Graphics g, int x, int y, int width, int height, Calendar cal) {
String numericDay = dayOfMonthFormatter.format(cal.getTime());
FontMetrics fm;
g.setColor(trailingDayForeground);
int boxPaddingX = monthView.getBoxPaddingX();
int boxPaddingY = monthView.getBoxPaddingY();
fm = g.getFontMetrics();
g.drawString(numericDay,
isLeftToRight ?
x + boxPaddingX +
boxWidth - fm.stringWidth(numericDay) :
x + boxPaddingX +
boxWidth - fm.stringWidth(numericDay) - 1,
y + boxPaddingY + fm.getAscent());
}
protected void paintBackground(final Rectangle clip, final Graphics g) {
if (monthView.isOpaque()) {
g.setColor(monthView.getBackground());
g.fillRect(clip.x, clip.y, clip.width, clip.height);
}
}
//---------------------- end of painting
//---------------------- navigation support
private void traverseMonth(int arrowType) {
if (arrowType == MONTH_DOWN) {
previousMonth();
} else if (arrowType == MONTH_UP) {
nextMonth();
}
}
private void nextMonth() {
Date upperBound = monthView.getUpperBound();
if (upperBound == null
|| upperBound.after(getLastDisplayedDay()) ){
Calendar cal = getCalendar();
cal.add(Calendar.MONTH, 1);
monthView.setFirstDisplayedDay(cal.getTime());
}
}
private void previousMonth() {
Date lowerBound = monthView.getLowerBound();
if (lowerBound == null
|| lowerBound.before(getFirstDisplayedDay())){
Calendar cal = getCalendar();
cal.add(Calendar.MONTH, -1);
monthView.setFirstDisplayedDay(cal.getTime());
}
}
//--------------------------- displayed dates, calendar
/**
* Returns the monthViews calendar configured to the firstDisplayedDate.
*
* NOTE: it's safe to change the calendar state without resetting because
* it's JXMonthView's responsibility to protect itself.
*
* @return the monthView's calendar, configured with the firstDisplayedDate.
*/
protected Calendar getCalendar() {
return getCalendar(getFirstDisplayedDay());
}
/**
* Returns the monthViews calendar configured to the given time.
*
* NOTE: it's safe to change the calendar state without resetting because
* it's JXMonthView's responsibility to protect itself.
*
* @param date the date to configure the calendar with
* @return the monthView's calendar, configured with the given date.
*/
protected Calendar getCalendar(Date date) {
Calendar calendar = monthView.getCalendar();
calendar.setTime(date);
return calendar;
}
/**
* Updates the lastDisplayedDate property based on the given first and
* visible # of months.
*
* @param first the date of the first visible day.
*/
private void updateLastDisplayedDay(Date first) {
Calendar cal = getCalendar(first);
cal.add(Calendar.MONTH, ((calendarColumnCount * calendarRowCount) - 1));
CalendarUtils.endOfMonth(cal);
lastDisplayedDate = cal.getTime();
}
/**
* {@inheritDoc}
*/
@Override
public Date getLastDisplayedDay() {
return lastDisplayedDate;
}
/*-------------- refactored: encapsulate aliased fields
*/
/**
* Sets the firstDisplayedDate property to the given value. Must update
* dependent state as well.
*
* Here: updated lastDisplayedDatefirstDisplayedMonth/Year accordingly.
*
*
* @param firstDisplayedDate the firstDisplayedDate to set
*/
protected void setFirstDisplayedDay(Date firstDisplayedDate) {
Calendar calendar = getCalendar(firstDisplayedDate);
this.firstDisplayedDate = firstDisplayedDate;
this.firstDisplayedMonth = calendar.get(Calendar.MONTH);
this.firstDisplayedYear = calendar.get(Calendar.YEAR);
updateLastDisplayedDay(firstDisplayedDate);
monthView.repaint();
}
/**
* @return the firstDisplayedDate
*/
protected Date getFirstDisplayedDay() {
return firstDisplayedDate;
}
/**
* @return the firstDisplayedMonth
*/
protected int getFirstDisplayedMonth() {
return firstDisplayedMonth;
}
/**
* @return the firstDisplayedYear
*/
protected int getFirstDisplayedYear() {
return firstDisplayedYear;
}
/**
* @return the selection
*/
protected SortedSet