1) CultureInfo support :
- all DateFormats, Days of Week, Months of Year, First Day of Week are retieved from the CultureInfo
- Default is allways the CultureInfo retrieved from
--> System.Globalization.CultureInfo.CurrentCulture.Clone();
- dtp_MainFrame.Culture = new CultureInfo("something");
--> can be used to overide this value.

2) Font support :
- Default is allways "Frutiger Linotype",10F,Bold
--> if "Comic Sans MS" is not installed "Arial" will be used
4 Font Properties are supported :
- dtp_MainFrame.CalendarFont = : all Font-Properties below will be set !
- dtp_MainFrame.FontCaption = Font("Courier New",12,System.Drawing.FontStyle.Italic);
- dtp_MainFrame.FontDay = Font("Tahmoa",10,System.Drawing.FontStyle.Regular);
- dtp_MainFrame.FontToday = Font("Comic Sans MS",10,System.Drawing.FontStyle.Underline);
Checks are made to insure that the resulting Control will fit the Compact Screen (Width 240)

3) Color support :
- Default are the default Window values (in so far as it was supported)
--> =SystemColors.ActiveCaptionText; =System.Drawing.Color.LightSalmon; etc.
9 Color (for Brushes) Properties are supported :
- dtp_MainFrame.CalendarForeColor : Day-Color (activ Month, Arrows, Today)
- dtp_MainFrame.CalendarMonthBackround : Day-Background (activ Month, Arrow Box)
- dtp_MainFrame.CurInactiv : Day-Color (inactiv Month)
- dtp_MainFrame.RedActiv : Invalid Day-Color (activ Month)
- dtp_MainFrame.RedInactiv : Invalid Day-Color (inactiv Month)
- dtp_MainFrame.BackSelect : Selected Day-Background
- dtp_MainFrame.TextSelect : Selected Day-Text
- dtp_MainFrame.CalendarTitelBackColor : Caption-Background (Top portion of the Control)
- dtp_MainFrame.CalendarTitelForeColor : Caption-Text (Month / Year Text)
No checks are made to prevent eye damage:   

4) Min/MaxDateTime support :
- Default are the DateTime values : DateTime.MinValue / DateTime.MaxValue;
- dtp_MainFrame.MinDateTime = new DateTime(2004,1,29);
- dtp_MainFrame.MaxDateTime = dtp_MainFrame.MinDateTime.AddDays(15);
The Dates between 2004-01-29 to 2004-02-13 may be selected
--> You may wonder why 2004-02-29 in the Eye-Killer is selected and that would be a very good question indeed ... Corrected.

5) FirstDayOfWeek support :
- Default is the CultureInfo.DateTimeFormat.FirstDayOfWeek value;
- dtp_MainFrame.FirstDayOfWeek = (int)DayOfWeek.Wednesday;
The Control will show this value as First Day of Week (Saturday, Sunday and Monday are realistic)
--> You may wonder why this is supported, but I would prefer not to remember the claims I made in the past...
... lets say ... it makes the testing of the logic easier.

6) DayOfWeekC support (Amount of characters shown for the Weekdays):
- Default is 2
- dtp_MainFrame.DayOfWeekC = 55;
Checks are made to insure that the results will fit the Screen
--> the amount of Characters will be reduced until it fits or the longest found Weekday
--> the Desktop Version returns 10 (length of longest Weekday : "Donnerstag")

--> the Compact Version returns 7

7) CustomFormat (non-Standard display of Dates):
- Default is "yyyy-MMM-dd"
- dtp_MainFrame.Format = mj10777.WinControls.DateTimePickerFormat.Custom;
- dtp_MainFrame.CustomFormat = "d MMMM yyyy 'r.'";
Standard LongDate in Polish is "d MMMM yyyy", but Poles often use a "r." for Ruku in their dates :
Note: if the CustomFormat or the LongDateFormat is to long to fit:
- the ShortDateFormat will be used

8) Today (non-Standard display of "Today"):
- Default is the value returned by DateTimePicker_CultureInfo.OnToday();
- dtp_MainFrame.Today = "RumpelstilchenTag";
You want to replace the standard "Today" value to something else :

Note: if this name is to long to fit : (Grrr ...) change the name !

Other Properties :
- Format, Value, Text, BackColor(=MonthBackground), Font(=CalendarFont) ,ForeColor(=CalendarForeColor) as in Desktop DateTimePicker
- BackgroundImage, CalendarTrailingForeColor (what it this?) : not supported

---

What does the Desktop.DateTimePicker do that the mj10777.DateTimePicker does not ?

---

1) Whatever this may be called (Squibble ?) it is not impletated (yet)
- which is a pity really. It is in any case on my TODO list.
- Since the Compact version is very cramped for size as it is, the Squibble is set around the "Today" Text as apposed being set in front of this text.
- The original WinCe-API used a black Square/Rectangle using two DrawRectangle command's
- I use a red Circle/Ellipse using two DrawEllipse command's
- How this done in the original Desktop version can only be assumed but
--> some sort of resizing is being done , , so this cannot be a Bitmap.
- so I assume some sort of DrawPolygon is being used with a Array of Points based on a Rectangle.

---

Mark Johnson - Berlin, Germany
02.03.2004