Perl/Tk Pocket Reference

8. The Text Widget 27

-window => widgetRef

Widget to display.

Text Embedded Image Options

-align => top| center| bottom| baseline

Where image is displayed on the line.

-image => image

Specifies Tk image to use for embedded image.

-name => imageName

Specifies name which may be used to reference the

embedded image.

-padx => width

Extra space in screen units to leave on the left and right

side of image.

-pady => height

Extra space in screen units to leave on the top and bottom

of image.

Text Widget Commands

$text->bbox(index);

Returns a list (x, y, width, height) giving an approximate

bounding box of character given by index.

$text->compare(index1, op, index2);

Compares indices index1 and index2 according to rela-

tional operater op.

$text->delete(index1 ?, index2 ?);

Deletes range of characters (index2 defaults to index1 +

1 char).

$text->dlineinfo(index);

Returns a list (x, y, width, height, baseline) describing the

screen area taken by display line at index.

28 Perl/Tk Pocket Reference

$text->dump(?switches, ? index1 ?, index2 ?);

Returns detailed info on text widget contents in range

index1 to index2. Switches include

-all, -mark, -tag,

-text, -window for specifying type of info returned. The

switch

-command => callback exists to invoke a proce-

dure on each element type in the range.

$text->get(index1 ?, index2 ?);