strepsirrhini/office-gobmx
9
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
office-gobmx/svtools/inc/calendar.hxx
Hans-Joachim Lankenau 233b88bc96 INTEGRATION: CWS dba12 (1.1.1.1.580); FILE MERGED 
2004/05/04 07:41:33 fs 1.1.1.1.580.1: #i28669# properly respect WB_LEFT/CENTER/RIGHT styles
2004-06-28 16:06:00 +00:00

524 lines
21 KiB
C++
Raw Blame History

/*************************************************************************
*
* $RCSfile: calendar.hxx,v $
*
* $Revision: 1.2 $
*
* last change: $Author: hjs $ $Date: 2004-06-28 17:06:00 $
*
* The Contents of this file are made available subject to the terms of
* either of the following licenses
*
* - GNU Lesser General Public License Version 2.1
* - Sun Industry Standards Source License Version 1.1
*
* Sun Microsystems Inc., October, 2000
*
* GNU Lesser General Public License Version 2.1
* =============================================
* Copyright 2000 by Sun Microsystems, Inc.
* 901 San Antonio Road, Palo Alto, CA 94303, USA
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License version 2.1, as published by the Free Software Foundation.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
* MA 02111-1307 USA
*
*
* Sun Industry Standards Source License Version 1.1
* =================================================
* The contents of this file are subject to the Sun Industry Standards
* Source License Version 1.1 (the "License"); You may not use this file
* except in compliance with the License. You may obtain a copy of the
* License at http://www.openoffice.org/license.html.
*
* Software provided under this License is provided on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
* WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
* MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
* See the License for the specific provisions governing your rights and
* obligations concerning the Software.
*
* The Initial Developer of the Original Code is: Sun Microsystems, Inc.
*
* Copyright: 2000 by Sun Microsystems, Inc.
*
* All Rights Reserved.
*
* Contributor(s): _______________________________________
*
*
************************************************************************/
#ifndef _CALENDAR_HXX
#define _CALENDAR_HXX
#ifndef _INTN_HXX
#include <tools/intn.hxx>
#endif
#ifndef _CTRL_HXX
#include <vcl/ctrl.hxx>
#endif
#ifndef _TIMER_HXX
#include <vcl/timer.hxx>
#endif
#ifndef _FIELD_HXX
#include <vcl/field.hxx>
#endif
class Table;
class MouseEvent;
class TrackingEvent;
class KeyEvent;
class HelpEvent;
class DataChangedEvent;
class FloatingWindow;
class PushButton;
struct ImplDateInfo;
class ImplDateTable;
class ImplCFieldFloatWin;
/*************************************************************************
Beschreibung
============
class Calendar
Diese Klasse erlaubt die Auswahl eines Datum. Der Datumsbereich der
angezeigt wird, ist der, der durch die Klasse Date vorgegeben ist.
Es werden soviele Monate angezeigt, wie die Ausgabeflaeche des
Controls vorgibt. Der Anwender kann zwischen den Monaten ueber ein
ContextMenu (Bei Click auf den Monatstitel) oder durch 2 ScrollButtons
zwischen den Monaten wechseln.
--------------------------------------------------------------------------
WinBits
WB_BORDER Um das Fenster wird ein Border gezeichnet.
WB_TABSTOP Tastatursteuerung ist moeglich. Der Focus wird
sich geholt, wenn mit der Maus in das
Control geklickt wird.
WB_QUICKHELPSHOWSDATEINFO DateInfo auch bei QuickInfo als BalloonHelp zeigen
WB_BOLDTEXT Formatiert wird nach fetten Texten und
DIB_BOLD wird bei AddDateInfo() ausgewertet
WB_FRAMEINFO Formatiert wird so, das Frame-Info angezeigt
werden kann und die FrameColor bei AddDateInfo()
ausgewertet wird
WB_RANGESELECT Es koennen mehrere Tage selektiert werden, die
jedoch alle zusammenhaengend sein muessen
WB_MULTISELECT Es koennen mehrere Tage selektiert werden
WB_WEEKNUMBER Es werden die Wochentage mit angezeigt
--------------------------------------------------------------------------
Mit SetCurDate() / GetCurDate() wird das ausgewaehlte Datum gesetzt und
abgefragt. Wenn der Anwnder ein Datum selektiert hat, wird Select()
gerufen. Bei einem Doppelklick auf ein Datum wird DoubleClick() gerufen.
--------------------------------------------------------------------------
Mit CalcWindowSizePixel() kann die Groesse des Fensters in Pixel fuer
die Darstellung einer bestimmte Anzahl von Monaten berechnet werden.
--------------------------------------------------------------------------
Mit SetSaturdayColor() kann eine spezielle Farbe fuer Sonnabende gesetzt
werden und mit SetSundayColor() eine fuer Sonntage. Mit AddDateInfo()
koennen Tage speziell gekennzeichnet werden. Dabei kann man einem
einzelnen Datum eine andere Farbe geben (zum Beispiel fuer Feiertage)
oder diese Umranden (zum Beispiel fuer Termine). Wenn beim Datum
kein Jahr angegeben wird, wird der Tag in jedem Jahr benutzt. Mit
AddDateInfo() kann auch jedem Datum ein Text mitgegeben werden, der
dann angezeigt wird, wenn Balloon-Hilfe an ist. Um nicht alle Jahre
mit entsprechenden Daten zu versorgen, wird der RequestDateInfo()-
Handler gerufen, wenn ein neues Jahr angezeigt wird. Es kann dann
im Handler mit GetRequestYear() das Jahr abgefragt werden.
--------------------------------------------------------------------------
Um ein ContextMenu zu einem Datum anzuzeigen, muss man den Command-Handler
ueberlagern. Mit GetDate() kann zur Mouse-Position das Datum ermittelt
werden. Bei Tastaturausloesung sollte das aktuelle Datum genommen werden.
Wenn ein ContextMenu angezeigt wird, darf der Handler der Basisklasse nicht
gerufen werden.
--------------------------------------------------------------------------
Bei Mehrfachselektion WB_RANGESELECT oder WB_MULTISELECT kann mit
SelectDate()/SelectDateRange() Datumsbereiche selektiert/deselektiert
werden. SelectDateRange() gilt inkl. EndDatum. Mit SetNoSelection() kann
alles deselektiert werden. SetCurDate() selektiert bei Mehrfachselektion
jedoch nicht das Datum mit, sondern gibt nur das Focus-Rechteck vor.
Den selektierten Bereich kann man mit GetSelectDateCount()/GetSelectDate()
abgefragt werden oder der Status von einem Datum kann mit IsDateSelected()
abgefragt werden.
Waehrend der Anwender am selektieren ist, wird der SelectionChanging()-
Handler gerufen. In diesem kann der selektierte Bereich angepasst werden,
wenn man beispielsweise den Bereich eingrenzen oder erweitern will. Der
Bereich wird mit SelectDate()/SelectDateRange() umgesetzt und mit
GetSelectDateCount()/GetSelectDate() abgefragt. Wenn man wissen moechte,
in welche Richtung selektiert wird, kann dies ueber IsSelectLeft()
abgefragt werden. TRUE bedeutet eine Selektion nach links oder oben,
FALSE eine Selektion nach rechts oder unten.
--------------------------------------------------------------------------
Wenn sich der Date-Range-Bereich anpasst und man dort die Selektion
uebernehmen will, sollte dies nur gemacht werden, wenn
IsScrollDateRangeChanged() TRUE zurueckliefert. Denn diese Methode liefert
TRUE zurueck, wenn der Bereich durch Betaetigung von den Scroll-Buttons
ausgeloest wurde. Bei FALSE wurde dies durch Resize(), Methoden-Aufrufen
oder durch Beendigung einer Selektion ausgeloest.
*************************************************************************/
// ------------------
// - Calendar-Types -
// ------------------
#define WB_QUICKHELPSHOWSDATEINFO ((WinBits)0x00004000)
#define WB_BOLDTEXT ((WinBits)0x00008000)
#define WB_FRAMEINFO ((WinBits)0x00010000)
#define WB_WEEKNUMBER ((WinBits)0x00020000)
// Muss mit den WinBits beim TabBar uebereinstimmen oder mal
// nach \vcl\inc\wintypes.hxx verlagert werden
#ifndef WB_RANGESELECT
#define WB_RANGESELECT ((WinBits)0x00200000)
#endif
#ifndef WB_MULTISELECT
#define WB_MULTISELECT ((WinBits)0x00400000)
#endif
#define DIB_BOLD ((USHORT)0x0001)
// ------------
// - Calendar -
// ------------
class Calendar : public Control
{
private:
ImplDateTable* mpDateTable;
Table* mpSelectTable;
Table* mpOldSelectTable;
Table* mpRestoreSelectTable;
XubString* mpDayText[31];
XubString maDayText;
XubString maWeekText;
International maIntn;
Rectangle maPrevRect;
Rectangle maNextRect;
String maDayOfWeekText;
long mnDayOfWeekAry[7];
Date maOldFormatFirstDate;
Date maOldFormatLastDate;
Date maFirstDate;
Date maOldFirstDate;
Date maCurDate;
Date maOldCurDate;
Date maAnchorDate;
Date maDropDate;
Color maSelColor;
Color maOtherColor;
Color* mpStandardColor;
Color* mpSaturdayColor;
Color* mpSundayColor;
ULONG mnDayCount;
long mnDaysOffX;
long mnWeekDayOffY;
long mnDaysOffY;
long mnMonthHeight;
long mnMonthWidth;
long mnMonthPerLine;
long mnLines;
long mnDayWidth;
long mnDayHeight;
long mnWeekWidth;
long mnDummy2;
long mnDummy3;
long mnDummy4;
WinBits mnWinStyle;
USHORT mnFirstYear;
USHORT mnLastYear;
USHORT mnRequestYear;
BOOL mbCalc:1,
mbFormat:1,
mbDrag:1,
mbSelection:1,
mbMultiSelection:1,
mbWeekSel:1,
mbUnSel:1,
mbMenuDown:1,
mbSpinDown:1,
mbPrevIn:1,
mbNextIn:1,
mbDirect:1,
mbInSelChange:1,
mbTravelSelect:1,
mbScrollDateRange:1,
mbSelLeft:1,
mbAllSel:1,
mbDropPos:1;
Link maSelectionChangingHdl;
Link maDateRangeChangedHdl;
Link maRequestDateInfoHdl;
Link maDoubleClickHdl;
Link maSelectHdl;
Timer maDragScrollTimer;
USHORT mnDragScrollHitTest;
#ifdef _SV_CALENDAR_CXX
void ImplInit( WinBits nWinStyle );
void ImplInitSettings();
void ImplGetWeekFont( Font& rFont ) const;
void ImplFormat();
USHORT ImplHitTest( const Point& rPos, Date& rDate ) const;
void ImplDrawSpin( BOOL bDrawPrev = TRUE, BOOL bDrawNext = TRUE );
void ImplDrawDate( long nX, long nY,
USHORT nDay, USHORT nMonth, USHORT nYear,
DayOfWeek eDayOfWeek,
BOOL bBack = TRUE, BOOL bOther = FALSE,
ULONG nToday = 0 );
void ImplDraw( BOOL bPaint = FALSE );
void ImplUpdateDate( const Date& rDate );
void ImplUpdateSelection( Table* pOld );
void ImplMouseSelect( const Date& rDate, USHORT nHitTest,
BOOL bMove, BOOL bExpand, BOOL bExtended );
void ImplUpdate( BOOL bCalcNew = FALSE );
void ImplScroll( BOOL bPrev );
void ImplInvertDropPos();
void ImplShowMenu( const Point& rPos, const Date& rDate );
void ImplTracking( const Point& rPos, BOOL bRepeat );
void ImplEndTracking( const Point& rPos, BOOL bCancel );
#endif
protected:
BOOL ShowDropPos( const Point& rPos, Date& rDate );
void HideDropPos();
DECL_STATIC_LINK( Calendar, ScrollHdl, Timer *);
public:
Calendar( Window* pParent, WinBits nWinStyle = 0 );
Calendar( Window* pParent, const ResId& rResId );
~Calendar();
virtual void MouseButtonDown( const MouseEvent& rMEvt );
virtual void MouseButtonUp( const MouseEvent& rMEvt );
virtual void MouseMove( const MouseEvent& rMEvt );
virtual void Tracking( const TrackingEvent& rMEvt );
virtual void KeyInput( const KeyEvent& rKEvt );
virtual void Paint( const Rectangle& rRect );
virtual void Resize();
virtual void GetFocus();
virtual void LoseFocus();
virtual void RequestHelp( const HelpEvent& rHEvt );
virtual void Command( const CommandEvent& rCEvt );
virtual void StateChanged( StateChangedType nStateChange );
virtual void DataChanged( const DataChangedEvent& rDCEvt );
virtual void SelectionChanging();
virtual void DateRangeChanged();
virtual void RequestDateInfo();
virtual void DoubleClick();
virtual void Select();
void SetInternational( const International& rIntn );
const International& GetInternational() const { return maIntn; }
void SelectDate( const Date& rDate, BOOL bSelect = TRUE );
void SelectDateRange( const Date& rStartDate, const Date& rEndDate,
BOOL bSelect = TRUE );
void SetNoSelection();
BOOL IsDateSelected( const Date& rDate ) const;
ULONG GetSelectDateCount() const;
Date GetSelectDate( ULONG nIndex = 0 ) const;
void EnableCallEverySelect( BOOL bEvery = TRUE ) { mbAllSel = bEvery; }
BOOL IsCallEverySelectEnabled() const { return mbAllSel; }
USHORT GetRequestYear() const { return mnRequestYear; }
void SetCurDate( const Date& rNewDate );
Date GetCurDate() const { return maCurDate; }
void SetFirstDate( const Date& rNewFirstDate );
Date GetFirstDate() const { return maFirstDate; }
Date GetLastDate() const { return maFirstDate+mnDayCount; }
ULONG GetDayCount() const { return mnDayCount; }
Date GetFirstMonth() const;
Date GetLastMonth() const;
USHORT GetMonthCount() const;
BOOL GetDate( const Point& rPos, Date& rDate ) const;
Rectangle GetDateRect( const Date& rDate ) const;
BOOL GetDropDate( Date& rDate ) const;
long GetCurMonthPerLine() const { return mnMonthPerLine; }
long GetCurLines() const { return mnLines; }
void SetStandardColor( const Color& rColor );
const Color& GetStandardColor() const;
void SetSaturdayColor( const Color& rColor );
const Color& GetSaturdayColor() const;
void SetSundayColor( const Color& rColor );
const Color& GetSundayColor() const;
void AddDateInfo( const Date& rDate, const XubString& rText,
const Color* pTextColor = NULL,
const Color* pFrameColor = NULL,
USHORT nFlags = 0 );
void RemoveDateInfo( const Date& rDate );
void ClearDateInfo();
XubString GetDateInfoText( const Date& rDate );
void StartSelection();
void EndSelection();
BOOL IsTravelSelect() const { return mbTravelSelect; }
BOOL IsScrollDateRangeChanged() const { return mbScrollDateRange; }
BOOL IsSelectLeft() const { return mbSelLeft; }
Size CalcWindowSizePixel( long nCalcMonthPerLine = 1,
long nCalcLines = 1 ) const;
void SetSelectionChangingHdl( const Link& rLink ) { maSelectionChangingHdl = rLink; }
const Link& GetSelectionChangingHdl() const { return maSelectionChangingHdl; }
void SetDateRangeChangedHdl( const Link& rLink ) { maDateRangeChangedHdl = rLink; }
const Link& GetDateRangeChangedHdl() const { return maDateRangeChangedHdl; }
void SetRequestDateInfoHdl( const Link& rLink ) { maRequestDateInfoHdl = rLink; }
const Link& GetRequestDateInfoHdl() const { return maRequestDateInfoHdl; }
void SetDoubleClickHdl( const Link& rLink ) { maDoubleClickHdl = rLink; }
const Link& GetDoubleClickHdl() const { return maDoubleClickHdl; }
void SetSelectHdl( const Link& rLink ) { maSelectHdl = rLink; }
const Link& GetSelectHdl() const { return maSelectHdl; }
};
inline const Color& Calendar::GetStandardColor() const
{
if ( mpStandardColor )
return *mpStandardColor;
else
return GetFont().GetColor();
}
inline const Color& Calendar::GetSaturdayColor() const
{
if ( mpSaturdayColor )
return *mpSaturdayColor;
else
return GetFont().GetColor();
}
inline const Color& Calendar::GetSundayColor() const
{
if ( mpSundayColor )
return *mpSundayColor;
else
return GetFont().GetColor();
}
/*************************************************************************
Beschreibung
============
class CalendarField
Bei dieser Klasse handelt es sich um ein DateField, wo ueber einen
DropDown-Button ueber das Calendar-Control ein Datum ausgewaehlt werden
kann.
--------------------------------------------------------------------------
WinBits
Siehe DateField
Die Vorgaben fuer das CalendarControl koennen ueber SetCalendarStyle()
gesetzt werden.
--------------------------------------------------------------------------
Mit EnableToday()/EnableNone() kann ein Today-Button und ein None-Button
enabled werden.
--------------------------------------------------------------------------
Wenn mit SetCalendarStyle() WB_RANGESELECT gesetzt wird, koennen im
Calendar auch mehrere Tage selektiert werden. Da immer nur das Start-Datum
in das Feld uebernommen wird, sollte dann im Select-Handler mit
GetCalendar() der Calendar abgefragt werden und an dem mit
GetSelectDateCount()/GetSelectDate() der selektierte Bereich abgefragt
werden, um beispielsweise diese dann in ein weiteres Feld zu uebernehmen.
--------------------------------------------------------------------------
Wenn ein abgeleiteter Calendar verwendet werden soll, kann am
CalendarField die Methode CreateCalendar() ueberlagert werden und
dort ein eigener Calendar erzeugt werden.
*************************************************************************/
// -----------------
// - CalendarField -
// -----------------
class CalendarField : public DateField
{
private:
ImplCFieldFloatWin* mpFloatWin;
Calendar* mpCalendar;
WinBits mnCalendarStyle;
PushButton* mpTodayBtn;
PushButton* mpNoneBtn;
Date maDefaultDate;
BOOL mbToday;
BOOL mbNone;
Link maSelectHdl;
#ifdef _SV_CALENDAR_CXX
DECL_LINK( ImplSelectHdl, Calendar* );
DECL_LINK( ImplClickHdl, PushButton* );
DECL_LINK( ImplPopupModeEndHdl, FloatingWindow* );
#endif
public:
CalendarField( Window* pParent, WinBits nWinStyle );
CalendarField( Window* pParent, const ResId& rResId );
~CalendarField();
virtual void Select();
virtual BOOL ShowDropDown( BOOL bShow );
virtual Calendar* CreateCalendar( Window* pParent );
Calendar* GetCalendar();
void SetDefaultDate( const Date& rDate ) { maDefaultDate = rDate; }
Date GetDefaultDate() const { return maDefaultDate; }
void EnableToday( BOOL bToday = TRUE ) { mbToday = bToday; }
BOOL IsTodayEnabled() const { return mbToday; }
void EnableNone( BOOL bNone = TRUE ) { mbNone = bNone; }
BOOL IsNoneEnabled() const { return mbNone; }
void SetCalendarStyle( WinBits nStyle ) { mnCalendarStyle = nStyle; }
WinBits GetCalendarStyle() const { return mnCalendarStyle; }
void SetSelectHdl( const Link& rLink ) { maSelectHdl = rLink; }
const Link& GetSelectHdl() const { return maSelectHdl; }
protected:
virtual void StateChanged( StateChangedType nStateChange );
};
#endif // _CALENDAR_HXX
Reference in a new issue View git blame Copy permalink