Home Dokumentation Komponenten MonthCalendar MonthCalendar - Übersicht
Freitag, den 05. März 2010 um 13:47 Uhr
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 Calendar : Control

 

 

Members:

Konstrukoren

Name Beschreibung
Calendar() Intialisiert eine neue Instanz des MonthCalendars.
Methoden
Name Beschreibung
SelectPreviousMonth

Zeigt den Monat vor dem aktuellem an
SelectNextMonth Zeigt den Monat nach dem aktuellem an
SelectPreviousYear Zeigt das Jahr vor dem aktuellem im Kalender an
SelectNextYear Zeigt das Jahr nach dem aktuellem im Kalender an
SelectToday Zeigt das in TodayDate angegebene Datum im Kalender an
SetViewMode Setzt den aktiven Anzeigemodus
Eigenschaften
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
MaxSelectionCounter 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.
Events
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.
Plattformen

 

Unterstützt werden folgende Betriebssysteme: WindowsXP, Windows Vista, Windows 7, Windows Server 2003
Versionsinformationen

 

.NET Framework:

kompatibel mit: 3.5, 3.0, 2.0

 

Zuletzt aktualisiert am Montag, den 17. Januar 2011 um 09:55 Uhr
Mehr in dieser Kategorie: Konstruktor »
nach oben