 |
Click this button to go to the index for this section. |
dxclock(1X)
NAME
dxclock - DECwindows interface to the clock
SYNOPSIS
dxclock [options]
OPTIONS
-bd color
Specifies the color of the window's border (color displays only). This
overrides the system default defined in the Session Manager's Customize
Window dialog box.
-bg color
Specifies the color of the window's background (color displays only).
This overrides the system default defined in the Session Manager's
Customize Window dialog box.
-d dispname
Specifies the display screen where dxclock displays its window. If the
display option is not specified, dxclock uses the display screen
specified by your DISPLAY environment 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).
-display dispname
This option is the same as the -d option.
-fg color
Specifies the color of the text (color displays only). This overrides
the system default defined in the Session Manager's Customize Window
dialog box.
-fn font
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 overridden by the .Xdefaults file.
-geometry
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 button unless you have redefined it). This menu contains the
following menu items:
Display...
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.
Alarm...
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.
Save Options
Saves the clock's settings and its size and position, to use the next
time you run the clock.
Restore System Options
Restores the use of system default values for the clock's settings,
size, and position.
Help
Displays information about using the dxclock command.
Exit
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 of the dxclock window. A resource specification in the
.Xdefaults file has the following format:
[name*]resource: value
name
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.
resource
Specifies the resource.
value
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:
AlarmOn
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.
AlarmHour
Specifies the hour the alarm is to go off (0 to 23). The default is 12.
AlarmMessage
Specifies the message to be displayed when the alarm goes off. The
default is the string Alarm Message.
AlarmMinute
Specifies the minute the alarm is to go off (00 to 59). The default is
00.
AlarmPM
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.
AnalogOn
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.
DateOn
Specifies whether the date portion of the dxclock window is displayed.
If set to zero, the date portion is not displayed. If set to 1, the
date portion is displayed. The default is 1.
DigitalOn
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.
militaryOn
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.
FILES
~/.Xdefaults
~/.DXclock
/usr/lib/X11/app-defaults/DXclock
~./DXclock
SEE ALSO
Commands: X(1X)