The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Win32::GUI::DateTime - Create and manipulate datetime controls

DESCRIPTION

[TBD]

METHODS

Common methods apply to most windows, controls and resources.

new

new(PARENT, %OPTIONS)

Creates a new DateTime object; can also be called as PARENT->AddDateTime(%OPTIONS).

Class specific %OPTIONS are:

  -align  => 'right'/'left' (default 'left')
    The drop-down month calendar alignement.
  -format => 'shortdate', 'longdate', 'time'
    Control format type (Use local format date/time).
  -shownone => 0/1 (default 0)
    Allow no datetime (add a prefix checkbox).
  -updown   => 0/1 (default 0 for date, 1 for time format)
    Use updown control instead of the drop-down month calendar.

See also the common options.

Format

Format(FORMAT)

See SetFormat()

GetDate

GetDate()

Returns the date in the DateTime control in a three elements array (day, month, year).

GetDateTime

GetDateTime()

See GetSystemTime()

GetMonthCal

GetMonthCal()

Retrieves the handle to a date and time picker's (DTP) child month calendar control.

GetMonthCalColor

GetMonthCalColor(icolor)

Retrieves the color for a given portion of the month calendar within a date and time picker (DTP) control. icolor :

  MCSC_BACKGROUND = Retrieve the background color displayed between months.
  MCSC_MONTHBK = Retrieve the background color displayed within the month.
  MCSC_TEXT = Retrieve the color used to display text within a month.
  MCSC_TITLEBK = Retrieve the background color displayed in the calendar's title.
  MCSC_TITLETEXT = Retrieve the color used to display text within the calendar's title.
  MCSC_TRAILINGTEXT = Retrieve the color used to display header day and trailing day
                text. Header and trailing days are the days from the previous and following
                months that appear on the current month calendar.

GetMonthCalFont

GetMonthCalFont(icolor)

Retrieves the font that the date and time picker (DTP) control's child month calendar control is currently using.

GetSystemTime

GetSystemTime()

Returns the date and time in the DateTime control in a eight elements array (year, month, day, dayofweek, hour, minute, second, millisecond).

GetTime

GetTime()

Returns the time in the DateTime control in a four elements array (hour, min, sec, msec).

IsNone

IsNone()

Test if the DateTime control is None (control check box was not selected).

SetDate

SetDate(DAY, MONTH, YEAR)

Sets the date in the DateTime control in a three elements array (day, month, year).

SetDateTime

SetDateTime(YEAR,MON, DAY, HOUR, MIN, SEC, [MSEC=0])

See SetSystemTime()

SetFormat

SetFormat(FORMAT)

Sets the format for the DateTime control to the specified string.

SetMonthCalColor

SetMonthCalColor(icolor,color)

Sets the color for a given portion of the month calendar within a date and time picker (DTP) control.

SetMonthCalFont

SetMonthCalFont(font,flag)

Sets the font to be used by the date and time picker (DTP) control's child month calendar control.

SetNone

SetNone(handle)

Set none state in the DateTime control (control check box was selected).

SetSystemTime

SetSystemTime(YEAR,MON, DAY, HOUR, MIN, SEC, [MSEC=0])

Sets the date time in the DateTime control

SetTime

SetTime(HOUR, MIN, SEC, [MSEC=0])

Sets the time in the DateTime control in a four elements array (hour, min, sec, [msec=0]).

EVENTS

Common events apply to most windows and controls.

Change

Change()

Sent when the datetime change. .

CloseUp

CloseUp()

Sent when the user closes the drop-down month calendar. .

DropDown()

Sent when the user activates the drop-down month calendar..

VERSION

Documentation for Win32::GUI v1.14 created 01 Jun 2017

This document is autogenerated by the build process. Edits made here will be lost. Edit docs/per_package.tpl instead.

SUPPORT

Homepage: http://perl-win32-gui.sourceforge.net/.

For further support join the users mailing list from the website at http://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users. There is a searchable list archive at http://sourceforge.net/p/perl-win32-gui/mailman/perl-win32-gui-users/.

COPYRIGHT and LICENCE

Copyright (c) 1997..2017 Aldo Calpini. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.