Delphi - TDateTimePicker komponens használata

A komponens egy speciális combobox (a TComboBox osztályból származtatva), melynek segítségével a felhasználó egy dátumot vagy időpontot adhat meg.

Properties

CalAlignment
A property értéke határozza meg, hogy a naptár (DateMode=dmComboBox esetén) a komponens bal, vagy jobb széléhez legyen-e igazítva. Két értéke lehet:

dtaLeft - balra igazítva
dtaRight - jobbra igazítva

CalColors
A naptár színeinek beállítására szolgál.

BackColor - háttérszín
MonthBackColor - hónapok háttérszíne
TextColor - szöveg színe
TitleBackColor - a fejléc és a kijelölt nap háttérszíne
TitleTextColor - a fejléc és a kijelölt nap szöveg színe
TrailingTextColor - az előző és a következő hónap napjainak szöveg színe

Checked
A property segítségével lekérdezhető ill. beállítható a CheckBox értéke. A CheckBox csak abban az esetben látszik, ha a ShowCheckBox property értéke igaz.

Date
Ezzel a property-vel kérdezhető le ill. adható meg dátum (TdateTime).

DateFormat
Meghatározza a dátum megjelenési formáját. Két lehetséges értéke van:

dfLong - hosszú dátum formátum.
dfShort - rövid dátum formátum

Figyelembe veszi a Területi beállításoknál meghatározott értékeket.

DateMode
Meghatározza a komponens megjelenési formáját. Ez kétféle lehet:

dmComboBox - ComboBox stílusú megjelenés (legördülő naptár)
dmUpDown -fel-le nyilak segítségével állítható be a kívánt érték.

DateTime
A property segítségével egyszerre kérdezhető le vagy állítható be a dátum és az időpont. Ez a property nem állítható be az Object Inspectorban!

DroppedDown
A logikai típusú property segítségével lekérdezhető hogy a legördülő naptár látszik-e.

Kind
Meghatározza hogy dátum, vagy idő bevitelére használjuk a komponenst. A két lehetséges érték:

dtkDate - dátum
dtkTime - idő

MaxDate
Ezzel a property-vel megadható az a legutolsó dátum, amit a felhasználó még megadhat a komponens segítségével.

MinDate
Hasonló a MaxDate komponenshez, de itt a legkorábbi dátumot kell beállítani.
ParseInput
Engedélyezi vagy letiltja az OnUserInput eseményt. Az OnUserInput esemény akkor következik be, amikor a felhasználó a billentyűzetről gépeli be a kívánt értéket.

ShowCheckBox
Logikai típusú property. Ha az értéke true, akkor a dátum (vagy idő) előtt megjelenik egy CheckBox, melynek értékét a Checked property-vel tudjuk beállítani, ill. lekérdezni. Olyan esetekben lehet hasznos, amikor nem kötelező a dátumot, vagy az időpontot megadni.

Time
Az idő lekérdezésére ill. beállítására szolgáló property.

Methods

BoldDays(Days: array of LongWord; var MonthBoldInfo: LongWord);
Az OnGetMonthInfo esemény keletkezésekor használható metódus. Használatával megadható, hogy a megjelenő hónapban mely napok legyenek kiemelve (pl. ünnepnapok). Az első paraméter egy tömb, melyben a napok számait adhatjuk meg. A MonthBoldInfo paraméter bitjei megadják, hogy a tömbből melyik napok lettek elfogadva.

Events

OnChange
Akkor következik be, amikor új dátumot vagy időt ad meg a felhasználó.

OnCloseUp
Akkör jön létre, amikor a legördülő naptár bezáródik.

OnDropDown
A legördülő naptár megjelenésekor bekövetkező esemény.

OnUserInput
Abban az esetben következik be, amikor a felhasználó begépel egy új dátumot és az enter billentyűt leüti, valamint a ParseInput property értéke igazra van állítva. A következő paramétereket kapjuk meg (a szokásos Sender-en kívül):
UserString: a felhasználó által begépelt szöveg;
DateAndTime: az a dátum, melyet a begépelt szövegből elő tudott állítani a gép. Ha a szöveg nem értelmezhető dátumként, akkor a legkisebb dátum (1899.12.30). Ezt a paramétert módosíthatjuk!
AllowChange: logikai típusú paraméter, amellyel engedélyezhetjük, vagy megtilthatjuk az új dátum beírását. Alapesetben az értéke igaz;