Kalenderkomponente Swishmax 2

31. March 2009 |

Autor: Tom

Beschreibung

Diese Kalenderkomponente ermöglicht die Anzeige und Auswahl eines Datums. Das aktuelle Datum wird mit einem Unterstrich hervorgehoben. Es kann durch die Monate und Jahre geblättert werden. Bei der Auswahl des Datum wird eine Ereignisfunktion ausgeführt. Der aktuelle Status der Schaltfläche (Button) kann mit übergeben werden. Im Abschnitt Methoden und Eigenschaften können Sie nachlesen, wie Sie den Kalender mit einem beliebigen Datum anzeigen können.

Voraussetzungen

Flash Export version	SWF 8 oder besser
SWiSH Max version	v2.0, build 20080131 oder besser

Parameter

Parameter name	Beschreibung
EventFunction	Name der Funktion, die bei Eingabe eines neuen Datums aufgerufen wurde. Wenn leer, dann wird das nicht genutzt Die Funktion hat folgende Syntax: Events(name,val) Der zurückgegebene Name, ist der Name des Objektes val ist eine Zeichenkette, die das Datum im Format : YYYY/M/D enthält. YYYY= Jahreszahl, M ist der Monat 1-12 und D ist der Tag. Das ausgewählte Datum kann über die Eigenschaft G_Date abgefragt werden.
UseVectorFonts	Vector fonts (Einstellung = true) -verbessert das Aussehen bei größeren Kalendern.Das Bild oben ist mit Vector fonts erstellt und sieht besser aus. Ist der Kalender größer als die Originalgröße sollten auf jeden Fall Verktorfonts eingesetzt werden. Pixel fonts (Einstellungen = false) ergibt einen schärferen Eindruck, wenn der Kalender kleiner ist. Diese Einstellungen sollte man nutzen, wenn der Kalender in der Originalgröße oder kleiner genutzt wird.
AllowDragging	Wenn Einstellung true, kann der Kalender verschoben werden.
DayAndMonthNames	Gruppe: Sprachenspezifische Monate und Tage
MonthHeadings	Semikolongetrennte Liste der Monate, in richtiger Reihenfolge z.b. Januar, Februar, April, Mail…
DayHeadings	Semikolongetrennte Liste der Tage eg. M;Tu;W;Th;F;Sa;Su
FirstDayOfWeek	Tag, mit dem die Woche starten soll Für M;Tu;W;Th;F;Sa;Su wählt man “Monday” Achtung: Fehler bei dieser Einstellung führen zu fehlerhaften Tagesnamen im ganzen Kalender
Heading Colors	Gruppe: Text- und Hintergrundfarbe für Kopfzeile der Tage
ColorBgndHeading	Hintergrundfarbe für Kopfzeile
ColorTextHeading	Textfarbe für Kopfzeile
Month Background Colors	Gruppe: Farben für die Datumsanzeige
ColorNormal	Normale Hintergrundfarbe Der Alphawert (Transparenz) für diese Farbe definiert die Transparenz der Datumsanzeige für den Kalender. Ein Wert unter 100% zeigt ein ähnliches Bild, wie das nächste Bild – rechte Seite.
ColorOver	Farbe für Mausberührung
ColorPress	Farbe bei Mausklick
Month Text Colors	Gruppe: Textfarbe in der Datumsanzeige
ColorTextN	Standardtextfarbe
ColorTextO	Textfarbe bei Mausberührung
ColorTextP	Textfarbe bei Mausklick
ColorTextDisabled	Textfarbe für vorherigen und nächsten Monat

Leider ist bei dieser Komponente der Pfad zur Funktion fest auf eine Ebene darüber fixiert. Ähnlich wie bei den Radiobuttons wird ein Problem bei der Gruppierung der Kalenderkomponenten auftreten. Achten Sie also darauf. Im eBook Swishmax 2 für Einsteiger sind geänderte und eingedeutschte Kalenderkomponenten enthalten.

2 Beispiele für den Kalender mit Hintergrundobjekten.

Links ist der Alphawert 1005 und rechts 75%.

Eigenschaften

Die Eigenschaften können per objectname.eigenschaft angesprochen werden. Auf diesem Weg können die Eigenschaften auch überschrieben werden.

Eigenschaft	Beschreibung
G_Date	Ein Datumsobjekt, dass das ausgewählte Datum enthält.

Methoden

Die Methoden können genutzt werden, um die per Swishmax 2 /Swishminimax 2 eingetellten Parameter zu überschreiben. Zum Beispiel kann eine Combobox abhängig von Ereignissen im Film andere Werte erhalten.

Methode	Beschreibung
FillDates(dd,mm,yy)	Stellt den Kalender auf das übergebene Datum ein. Beachten Sie, dass Monat eine Nummer zwischen 0=Januar und 11=Dezember ist. FillDates(2,4,2007) zeigt im Kalender den 2. Mai 2007 mit 2 (unterstrichen) an. Nach dem Aufruf von FillDates() sollte DisplayDates() aufgerufen werden. Achtung: DMY Reihenfolge ist entgegengesetzt der Datumsobjekt .setFullYear() Methode!
DisplayDates()	Update und neu anzeigen des Kalenders
MonthOffset(inc)	Ist inc = true, springt der Kalender zum nächsten Monat und zeigt den Kalender, ist inc=false geht es zum vorherigen Monat.
YearOffset(n)	n ist die Abweichung in Jahren. Kalender zeigt das aktuelle Jahr + n Jahre an
version()	gibt die Buildversion zurück z.B. “20080221″

Beispiel

Voraussetzung ist ein Kalender mit dem Namen “Calendar”.

Das Script befindet sich im Toplevel des Filmes.

Das Actionscript initialisiert den Kalender auf den 2nd May 2007. Die Initialisierung funktioniert nicht mittels onSelfEvent (load), wenn der Kalender das aktuelle Datum als Startdatum nimmt.

Die Ereignisfunktion im Beispiel zeigt das ausgewählte Datum im Debug-Fenster an.

function Events(name,val)
{
  trace(name);
  if ("Calendar" == name)
  {
      // zeigt das zurückgegebene Datum
      trace("val=" add val);
      // Hinweis aktuelle Stunde, Minute
      trace(Calendar.G_Date.toString());    // Anzeige als Text
  }
}
onFrame (1, afterPlacedObjectEvents)
{
  // Kalender auf den 02.05.2007 setzen
  // Hinweis: Das funktioniert nur im onFrame(, afterPlacedObjectEvents)
  // nachdem der Kalender den aktuellen Tag und Monat geladen hat
  // Monat ist 4 weil 0=Januar.
  Calendar.FillDates(2,4,2007);        // 2nd May 2007
  Calendar.DisplayDates();          // Kalenderanzeige updaten

Diese Komponente ist in Swishmax 2 und Swishminmax 2 enthalten!

Möchten Sie weitere ausgefeiltere Funktionen, so werfen Sie einen Blick auf unsere kommerziellen Komponenten:

Features:

zeigt Bilder, Videos (H.264), SWF und FLV an
Slideshow
komplette Farbanpassung
Automatisches Laden von Vorschaubildern
Vorschaubilder und Elemente extern

»zur Lightpanekomponente

Entwicklung

v1.0	20080221	First release
v2.0	20080221	Added support fro Help files and links. (20080221)
v2.1	20080225	Added dragging and alpha transparency.
v2.1a	20080228	Fixed bug with header text color and setting of date on update. Changed to be SWF8+ due to apparent bugs in SWF7 date object.

SwishKomponenten.de