Class: cWebDateForm
Properties | Events | Methods | Index of Classes
The Web Framework single line edit control with integrated date selection (popup calendar)
Hierarchy
cObject > cWebBaseObject > cWebObject > cWebBaseUIObject > cWebBaseDEOServer > cWebBaseControl > cWebBaseDEO > cWebBaseForm > cWebForm > cWebDateForm
Show full hierarchy and direct subclasses
Library: Web Application Class Library
Package: cWebDateForm.pkg
Description
The cWebDateForm class is a web single line edit control with integrated date selection via a popup calendar.
The cWebDatePicker class is a (non-popup) calendar control allowing year, month and date selection.
A date form is ideal for data entry of date values (peDataType = typeDate). It has the appearance of a regular form control with a special prompt button. When the prompt button is clicked a date picker appears allowing the selection of a single date from a monthly calendar.
The form:
The popup calendar:
Other than the integrated popup calendar, a cWebDateForm behaves like a cWebForm. See cWebForm for more information.
Sample
Object oCustomerView is a cWebView
Object oCustomer_DD is a Customer_DataDictionary
End_Object
Set Main_DD to oCustomer_DD
Set Server to oCustomer_DD
Object oCustomer_Name is a cWebDateForm
Entry_Item Order.Order_Date
Set psLabel to "Order Date:"
End_Object
End_Object
The above sample demonstrates a cWebView with a data dictionary object (DDO) and a cWebDateForm object with a data binding to the Order table, Order_Date column.
Object oStartDate is a cWebDateForm
Set piColumnSpan to 3
Set psLabel to "Start Date:"
Set pbServerOnChange to True
Procedure OnChange String sNewValue String sOldValue
Forward Send OnChange sNewValue sOldValue
Send ShowInfoBox to ghoWebApp ("The Date Is: " + sNewValue)
End_Procedure
End_Object
The above sample demonstrates a cWebDateForm object without a data binding. Whenever the user selects a new date, the OnChange event is fired and the date value is displayed in an Info Box. Note that pbServerOnChange is set to true to ensure that the OnChange event is sent to the server.
Display Options
Set pbAutoShow to true to automatically activate the date picker whenever the control receives the focus.
Set pbShowToday to determine whether the default date will be today's date according to the client's current system date (i.e. the current date on the client machine).
Set pbShowWeekNr and piStartWeekAt to modify the popup calendar appearance.
Drag and Drop Support
This control can be used as a valid drop target by registering it as such in a cWebDragDropHelper object.
The supported actions for this control are: - C_WebDropOnControl
This allows the control to accept data dragged from elsewhere in the control (if configured that way) and can also be used to accept files when registered within a cWebDragDropFileHelper.
See Also