File 'clock/dayBrowse.cls' (part of 'Pool_Clock')


Home | Packages | Files | Procedures | Classes | Keywords | External packages


Written by
Andreas Kupries
Description
Widget to choose day, depending on given month and year
See also
calendar
Keywords
calendar, choosing a day, day choice

Class 'dayBrowser'

Superclasses
valueManager
Options
dayrelief, heading, month, onwrap, sunday, weekno
Membervariables
chosen, m, monlen, offset, y
Methods
GetOffset, OnWrap, RefreshDay, RefreshDisplay, TrackDayrelief, TrackHeading, TrackMonth, TrackSunday, TrackWeekno, createSubwidgets, dayBrowser, downOne, downSeven, setBindings, setBindingsTo, upOne, upSeven, updateDisplay

-dayrelief
Relief of button associated to currently chosen day
-heading
Color to mark header row.
-month
External month/year information (in format mm/yyyy) to control the appearance of the widget.
-onwrap
Script to evaluate in the case of a wrap around, either at the start or the end of the month. The evaluation takes place before the execution of valueManager:command. A single argument is appended before the actual evaluation, it specifies the direction of the wrap. Possible values are 'up' (wrap 12 -> 1) and 'down' (wrap 1->12). A possible use is the modification of an associated yearBrowser.
-sunday
Color to mark sundays.
-weekno
Color to mark week numbers

chosen
Index of chosen button for chosen day.
m
Derived information, he month part of dayBrowser:month.
monlen
Derived information, the length of the specified dayBrowser:month.
offset
Offset of first day in month into the day-area. Alternative description: Difference between day and number of associated button.
y
Derived information, he year part of dayBrowser:month.

GetOffset ()

Internal method. Computes the weekday associated to the first day in a month. This is used to correctly indent the topmost row of day buttons.

OnWrap (direction)

Propagates wraparound events, if possible
Argument: directiondirection of wrap, one 'up' or 'down' respectively.

RefreshDay (storeChange day)

Refreshes the day buttons after a change of the current value.
Argument: storeChange1 if called by day button day. This requires propagation of the new value to all internal data structures. 0 makes internal changes visible to the user, by changing the appearance of the buttons.
Argument: dayRelevant for storeChange=1, index of activated button.

RefreshDisplay ()

Refreshes the area containing the day buttons according to changes in day, month or year.

TrackDayrelief (o oldValue)

Executed whenever the relief of the buttons is set.
Argument: oThe name of the changed option, always '-dayrelief'.
Argument: oldValueThe old value of the option.

TrackHeading (o oldValue)

Executed whenever the color of the heading is changed.
Argument: oThe name of the changed option, always '-heading'.
Argument: oldValueThe old value of the option.

TrackMonth (o oldValue)

Executed every time the month/year information is changed.
Argument: oThe name of the changed option, always '-month'.
Argument: oldValueThe old value of the option.

TrackSunday (o oldValue)

Executed whenever the color of the sunday column requires a refresh.
Argument: oThe name of the changed option, always '-sunday'.
Argument: oldValueThe old value of the option.

TrackWeekno (o oldValue)

Executed whenever the color of the weeknumber column requires a refresh.
Argument: oThe name of the changed option, always '-weekno'.
Argument: oldValueThe old value of the option.

createSubwidgets ()

Called by the framework to generate the subwidgets and their layout.

dayBrowser ()

Initializes the value to the current day if not set already by the user. Initializes the month/year information to the current month/year if not already set by the user.

downOne ()

Decrements chosen day by one. Touching the lower bound triggers a wrap-around to the highest value possible. This event might be propagated.

downSeven ()

Increments chosen day by seven (ahead a week). Touching the upper bound triggers a wrap-around. This event might be propagated.

setBindings ()

Adds various keyboard accelerators to the daybrowser.

setBindingsTo (w)

Adds various keyboard accelerators to the given widget.
Argument: wThe widget the accelerators are added to.

upOne ()

Increments the chosen day by one. Touching the upper bound triggers a wrap-around to the lowest value possible. This event might be propagated.

upSeven ()

Decrements chosen day by seven (back a week). Touching the lower bound triggers a wrap-around. This event might be propagated.

updateDisplay ()

Method required by the superclass valueManager to propagate changes to the value into the display. Requests are simply forwarded to dayBrowser:RefreshDay


Generated by AutoDoc 2.1 at 02/20/1999, invoked by Andreas Kupries