MonthCalendar
Hinweis: Die Dokumentation ist noch nicht vollständig wird aber im laufe der nächsten Zeit komplettiert.
MonthCalendar ist ein grafisches Steuerelement zum hinzufügen eines Komfortablen Kalenders in den GUI. Das Control ist in C# (.NET 2) geschreiben und kann ebenfalls in VB.NET verwendet werden. Dabei stehen viele Konfigurations - Optionen zur Verfügung mit denen das Aussehen und Verhalten des Kalenders verändert werden kann:
- Schriftart im Kalender ist einstellbar
- Anzeige eines für jeden Monat geänderten Images m Kopf oder unter dem gesamten Kalender sowie unter den Monatstagen
- Titelleiste mit dem Monatsnamen und dem Jahr sowie einer Navigation zum wechseln des angezeigten Monats und Jahres.
- Anpassbare Hintergrundfarbe und Scriftart für jedes Element (Header, Wochetagsnamen, Wochennummern, Monatstagen, spezielle Tage, Today - Bereich). Die Hintergrundfarbe kann mit einem Farbverlauf gezeichnet und der Transparenzlevel festgelegt werden.
- Unter dem Header können die Abkürzungen für Wochentage angezeigt werden (Mo - So).
- Anzeige der Wochennummern
- Komplett formatierbare Monatstage (auch Tage des vergangenen bzw. folgenden Monats -> TrailingDays)
- speziell formatierte Tage (hier steht Rekursion zur Verfügung: Täglich, Wöchentlich, Monatlich und Jährlich
- Today - Bereich mit dem Heutigen Datum (dieses kann separat festgelegt werden)
Namespace: MonthCalendar
Assembly: MonthCalendar.dll
Syntax C#:
public MonthCalendar : Control
Members:
| Name |
Beschreibung |
| Calendar() |
Intialisiert eine neue Instanz des MonthCalendars.
|
| Name |
Beschreibung |
| Border |
Legt das Aussehen des Randes um den Kalender fest. |
| CalendarWeekRule |
Legt die Regel zur Berechnung der ersten Woche eines Jahres fest..
|
| CanSelectTrailingDays |
Mit dieser Eigenschaft kann das Verhalten bezüglich der Selektion von Tagen aus dem vorigen bzw. dem nach folgenden Monat gesteuert werden. Standartein- stellung ist "true".
|
| Culture |
Definiert die im Kalender verwendeten Spracheinstellungen. |
| Dates |
Mit dieser Eigenschaft können besondere Tage (zB. Feiertage) im Kalender markiert werden |
| FirstDayOfWeek |
Die Eigenschaft legt den Tag der Woche fest, mit dem diese beginnt. Standart- einstellung ist hier defaut, dh. der Tag wird aus den Systemeinstellungen gelesen.
|
| Header |
Legt alle Einstellungen für das Kalenderelement "Header" fest. Diese beziehen sich auf die Farben für den Hintergrund sowie des Textes, den Rand(Border), Navigationsschaltflächen sowie der Anzeige des Elementes insgesamt. |
| Imagelist |
Diese Eigenschaft beinhaltet die Imagelist welche mit der Eigenschaft "Dates" zur Darstellung der Images von "speziellen Tagen" verwendet wird. |
| Keyboard |
Spezifiziert die Tastaturbefehle zur Steuerung des Kalenders |
| MaxDate |
Diese Eigenschaft legt das späteste wählbare Datum fest |
| MaxSelectionCount |
Mit diesem Property kann die Maximale, vom Anwender auswählbare Anzahl von Tagen festgelegt werden. Standartwert ist 7 |
| MinDate |
Spezifiziert das früheste, wählbare Datum |
| MonthDays |
Über die Eigenschaft ist es möglich, das Aussehen der Monatstage zu verändern. Neben den Stil für den Hintergrund der Tage kann unter anderem festgelegt werden, ob Samstag und Sonntag markiert werden sollen sowie in welchem Stil die Trailing- und SelectedDays erscheinen. Detailiertere Angaben finden Sie in den Details zu dieser Eigenschaft. |
| MonthImages |
Mit hilfe dieser Gruppe von Eigenschaften können die Bilder für die einzelnen Monate des Jahres festgelegt werden. |
| OnlyMonthMode |
Mit dieser Eigenschaft können Sie festlegen, das nur die Monatsansicht des Kalenders zur Verfügung stehen soll. In den Standarteinstellungen stehen alle Modi des Kalenders zur Verfügung, dh. die Eigenschaft steht auf "false" |
| Selected |
Dieses Property enthält eine Auflistung aller im Control markierten Tage. |
| SelectionMode |
Legt den Auswahl - Modus für das Control fest. Dafür stehen die folgenden Möglichkeiten bereit: smNone, smOne und smMulti. |
| StartWithZoom |
Hier können Sie die Anzeige - Modus festlegen, in dem der Kalender initialisiert wird. Mögliche Werte sind: vmMonth, vmYear, vm12Years und vm120Years. Alle anderen Anzeige - Modi stehen in jedem Fall zur Verfügung. |
| Today |
Über diese Eigenschaft besteht die Möglichkeit den "Today" - Bereich im Fuße zu konfigurieren. Dabei bestehen unter anderem die Optionen, den "Today" - Bereich auszublenden, das Datumsformat festzulegen, den Hintergrund zu formatieren, die Ausrichtung und die Schriftart und -farbe festzulegen. |
| TodaysDate |
Enthält das aktuelle Datum das in der TodayArea sowie in den Monatstagen markiert wird. Soll dieses immer angezeigt werden, so darf der Wert dieser Eigenschaft nicht verändert werden um ein speichern im Formular zu verhindern. |
| WeekDays |
Legt die Formatierung der wochentagsnamen fest. Optionen bestehen für den Hintergrund, den Rahmen, die Schriftart und -farbe sowie der sichtbarkeit des Bereiches. |
| WeekNumbers |
Bietet die Möglichkeit, die Wochennummern links zu konfigurieren. Hierbei besteht die Möglichkeit diese auszublenden, den Hintergrund, die Schriftart oder -farbe festzulegen. |
| Name |
Beschreibung |
| YearChanged |
Wird ausgelöst, wenn das aktive Jahr geändert wurde.
|
| CanChangeYear |
Tritt ein, wenn das aktive Jahr geändert werden soll. |
| MonthChanged |
Wird ausgelöst, wenn der aktive Monat geändert wurde. |
| CanChangeMonth |
Wird ausgelöst, wenn der aktive Monat geändert werden soll. |
| NavPreviousClick |
Wird ausgelöst, wenn der Benutzer im Navigationsbereich zum vorigen Monat gesprungen ist. |
| NavNextClick |
Wird ausgelöst, wenn der Benutzer im Navigationsbereich zum nächsten Monat gesprungen ist. |
| NavPreviousYearClick |
Wird ausgelöst, wenn der Benutzer im Navigationsbereich zum vorigen Jahr gesprungen ist. |
| NavNextYearClck |
Wird ausgelöst, wenn der Benutzer im Navigationsbereich zum nächsten Jahr gesprungen ist. |
| CanSelectDay |
Wird ausgelöst, wenn der selektierte Tag geändert werden soll. |
| SelectDay |
Wird ausgelöst, wenn der gewählte Tag geändert wurde. |
| CanZoomOut |
Wird ausgelöst, wenn der Anzeigebereich vergrößert werden soll |
| ZoomOut |
Wird ausgelöst, wenn der Anzeigebereich vergrößert wurde |
| CanZoomIn |
Wird ausgelöst, wenn der Anzeigebereich verkleinert werden soll. |
| ZoomIn |
Wird ausgelöst, wenn der Anzeigebereich verkleinert wurde |
| MonthImageRender |
Wird ausgelöst, wenn das Monatsbild dargestellt werden soll. |
| HeaderRender |
Wird ausgelöst, wenn der Header dargestellt werden soll |
| WeekDayBackgroundRender |
Wird ausgelöst, wenn der Hintergrund für die Wochentagsnamen dargestellt werden soll. |
| WeekDayRender |
Wird ausgelöst, wenn ein Wochentag dargestellt wird. |
| WeekNumbersBackgroundRender |
Wird ausgelöst, wenn der Hintergrund für die Wochennummern darstellt werden soll. |
| WeekNumberRender |
Wird ausgelöst, wenn eine Wochennummer darstellt werden soll. |
| MonthDayRender |
Wird ausgelöst, wenn ein Monatstag dargestellt werden soll. |
| MonthRender |
Wird ausgelöst, wenn ein Monat dargestellt werden soll. |
| YearRender |
Wird ausgelöst, wenn ein Jahr dargestellt werden soll. |
| YearGroupRender |
Wird ausgelöst, wenn ein Bereich von Jahren dargestellt werden soll. |
| FooterRender |
Wird ausgelöst, wenn der TodayBereich dargestellt werden soll. |
| HeaderClick |
Wird ausgelöst, wenn der Benutzer in den Kopfbereich geklickt hat |
| SelectionStart |
Wird ausgelöst, wenn der Benutzer mit der Auswahl mehrerer Tage beginnt. |
| SelectionEnd |
Wird ausgelöst, wenn der Benutzer die Auswahl mehrerer Tage beendet. |
| FirstDayOfWeekChanged |
Wird ausgelöst, wenn der Tag geändert wurde, mit dem die Kalender - Woche beginnt. |
| MinDateChanged |
Wird ausgelöst, wenn die MInDate - Eigenschaft geändert wurde. |
| MaxDateChanged |
Wird ausgelöst, wenn die MaxDate - Eigenschaft geändert wurde |
| CultureChanged |
Wird ausgelöst, wenn die Spracheinstellungen (Culture - Eigenschaft) geändert wurden. |
| OnlyMonthModeChanged |
Wird ausgelöst, wenn die Eigenschaft "OnlyMonthMode" geändert wurde. |
| SelectionModeChanged |
Wird ausgelöst, wenn der Auswahlmodus geändert wurde. |
| CanSelectTrailingDaysChanged |
Wird ausgelöst, wenn die Eigenschaft "CanSelectTrailingDays" geändert wurde. |
| HeaderChanged |
Wird ausgelöst, wenn der Stil für den Header geändert wurde. |
| FooterChanged |
Wird ausgelöst, wenn der Stil für den Today - Bereich geändert wurde. |
| WeekDaysChanged |
Wird ausgelöst, wenn der Stil für die Wochentagsnamen geändert wurde. |
| WeekNumbersChanged |
Wird ausgelöst, wenn der Stil für die Wochennummern geändert wurde. |
| MonthDaysChanged |
Wird ausgelöst, wenn der Stil für die Monatstage geändert wurde. |
| KeyboardChanged |
Wird ausgelöst, wenn ein oder mehrere Tastenkodes für die Keyboardsteuerung geändert wurden. |
| MonthImagesChanged |
Wird ausgelöst, wenn ein oder mehrere Bilder für die Monate geändert wurden. |
| BorderChanged |
Wird ausgelöst, wenn der Stil des Rahmens um den Kalender geändert wurde. |
| EnableMultiSelectionMode |
Wird ausgelöst, wenn der Mehrfachauswahlmodus aktiviert wurde. |
| DisableMultiSelectionMode |
Wird ausgelöst, wenn der Mehrfachauswahlmodus deaktiviert wurde. |
Unterstützt werden folgende Betriebssysteme: WindowsXP, Windows Vista, Windows 7, Windows Server 2003
.NET Framework:
kompatibel mit: 3.5, 3.0, 2.0
Zuletzt aktualisiert am Sonntag, den 11. April 2010 um 08:54 Uhr
|