dxclock(1X)dxclock(1X)NAMEdxclock - DECwindows interface to the clock
SYNOPSISdxclock [ flags ]
FLAGS
Specifies the color of the window's border (color displays only). The
default is specified by means of the Session Manager's Customize Window
dialog box. Specifies the color of the window's background (color dis‐
plays only). The default is specified by means of the Session Man‐
ager's Customize Window dialog box. Specifies the display screen on
which dxclock displays its window. If the display option is not speci‐
fied, dxclock uses the display screen specified by your DISPLAY envi‐
ronment variable. The display option has the format hostname:number.
Using two colons (::) instead of one (:) indicates that DECnet is to be
used for transport. The default is :0. For more information, see
X(1X). This option is the same as the -d option. Specifies the color
of the text (color displays only). The default is specified by means
of the Session Manager's Customize Window dialog box. Specifies the
font for all of the clock menus. (The analog and digital fonts are
automatically scaled to match the clock size.) The default font is
menu12. This option is overriden by the .Xdefaults file. Specifies the
width, length, and location of the dxclock window. If the geometry
option is not specified, dxclock uses default values. The geometry
option has the format [widthxlength][{+-}x{+-}y]. For more information
about the screen coordinate system, see X(1X). The dxclock window has
one pop-up menu. To display this pop-up menu, position the pointer
anywhere within the dxclock window and click MB3 (the right mouse but‐
ton unless you have redefined it). This menu contains the following
menu items: Displays the Settings dialog box that lets you specify the
clock regions to display, turn on or turn off the use of analog time,
digital time, date, menu bar and 24-hour digital time. Sets the alarm,
and enter a message that appears when the alarm goes off. You can also
display this dialog box by placing the pointer at any position within
the dxclock window and double-clicking MB1. Saves the clock's settings
and its size and position, to use the next time you run the clock.
Restores the use of system default values for the clock's settings,
size, and position. Displays information about using the dxclock com‐
mand. Closes the dxclock window.
DESCRIPTION
The dxclock command displays a window that continuously displays the
system date and time. The clock can display time values in military
style (0 through 23 hours) or in 12-hour AM and PM format. The dxclock
window has an alarm and the following components: Analog region Digital
region Date region
X Defaults
The dxclock application uses the values in the .Xdefaults file when you
logged in and uses the appropriate resource specification to customize
the appearance dxclock window. A resource specification in the .Xde‐
faults file has the following format:
[name*]resource: value Specifies the application name or the name
string that restricts the resource assignment to that application or to
a component of an application. If this argument is not specified, the
resource assignment is globally available to all X applications. Spec‐
ifies the resource. Specifies the value that is to be assigned to the
resource.
Because each toolkit-based application can consist of a combination of
widgets (for example, push buttons and a scroll bar), you can form the
name string by adding widget class and name identifiers to the string.
For further information about adding class and name identifiers, see
X(1X).
For dxclock the available class identifiers is Clock.
For dxclock, the available name identifiers are Digital and FontFamily.
In addition to the general resources listed in X(1X), the resources
available for dxclock are: Specifies that the alarm be turned on. If
set to zero, the alarm is not turned on. If set to 1, the alarm is
turned on. The default is zero. Specifies the hour the alarm is to go
off (0 to 23). The default is 12. Specifies the message to be dis‐
played when the alarm goes off. The default is the string Alarm Mes‐
sage. Specifies the minute the alarm is to go off (00 to 59). The
default is 00. Specifies that the alarm is set for PM. If set to
zero, the alarm is set for AM. If set to 1, the alarm is set for PM.
The default is zero. Specifies whether the analog portion of the
dxclock window is displayed. If set to zero, the analog portion is not
displayed. If set to 1, the analog portion is displayed. The default
is 1. Specifies whether the date portion of the dxclock window is dis‐
played. If set to zero, the date portion is not displayed. If set to
1, the date portion is displayed. The default is 1. Specifies whether
the digital portion of the dxclock window is displayed. If set to
zero, the digital portion is not displayed. If set to 1, the digital
portion is displayed. The default is 1. Specifies whether the digital
portion of the dxclock window displays the date in 12-hour format or
24-hour format. If set to zero, 12-hour format is used. If set to 1,
24-hour format is used. The default is zero.
The fonts used by dxclock are specified by an asterisk (*). This is
done so that a font family is chosen instead of a particular font. The
asterisk (*) is a wildcard character that matches all font sizes.
RESTRICTIONS
The system time cannot be changed while the clock is running. The
dxclock window must be closed and reopened if the system time is
changed.
FILESRELATED INFORMATION
Commands: X(1X)dxclock(1X)