1 CAPI Reference Entries

titled-pane

Summary

The classtitled-pane provides support for decorating a pane with a title (a piece of text positioned next to the pane) and with a message (a piece of text below the pane).

Superclasses

simple-pane

Subclasses

interface
layout
title-pane
display-pane
text-input-pane
button
list-panel
button-panel
option-pane
contact-pane

Slots

title

A title string for the current pane (ornil).

title-args

Keyword arguments to the title make-instance.

title-position

The position of the title.

title-adjust

How to adjust the title relative to the pane.

message

A message string for the current pane (ornil).

message-args

Keyword arguments to the messagemake-instance.

Accessors

titled-pane-title
titled-pane-message

Description

The titled pane makes its decorations from title panes, and their look can be changed with the argumentstitle-args andmessage-args.

The message is always placed below the pane, but the title's position can be adjusted by specifying a title position which can be any of the following.

:left

Place the title to the left of the pane.

:right

Place the title to the right of the pane.

:top

Place the title above the pane.

:bottom

Place the title below the pane.

Thetitle-adjust slot is used to adjust the title so that it is left justified, right justified or centered. The value oftitle-adjust can be any of the values accepted by the functionpane-adjusted-offset, which are:left,:right,:top,:bottom,:center and:centre.

Examples

Try each of these examples to see some of the effects that titled panes can produce. Note thattext-input-pane is a subclass oftitled-pane, and that it has a defaulttitle-position of:left.

(capi:contain (make-instance 'capi:text-input-pane))

(capi:contain (make-instance 'capi:text-input-pane
                              :title "Enter some text:"))

(capi:contain (make-instance 
               'capi:text-input-pane
               :title "Enter some text:"
               :title-position :top))

(capi:contain (make-instance 'capi:text-input-pane
                              :title "Enter some text:"
                              :title-position :top
                              :title-adjust :center))

(capi:contain (make-instance 'capi:text-input-pane
                             :title "Enter some text:"
                             :title-position :top
                             :title-adjust :right))

(capi:contain (make-instance 'capi:text-input-pane
                              :message "A message"))

(capi:contain (make-instance 'capi:text-input-pane
                              :message "A message"
                              :title "Enter some text:"))

(capi:contain (make-instance 'capi:text-input-pane
                             :title "Enter some text:"
                             :title-args
                              '(:foreground :red)))

See Also

title-pane

Generated with Harlequin WebMaker