Pod-Peapod

 view release on metacpan or  search on metacpan

t/sample.pod  view on Meta::CPAN

See L<"TAGS"> below for more details.

The second form of annotation consists of marks, which are floating
markers in the text.
Marks are used to keep track of various interesting positions in the
text as it is edited.
See L<"MARKS"> below for more details.

The third form of annotation allows arbitrary windows to be
embedded in a text widget.
See L<"EMBEDDED WINDOWS"> below for more details.

The fourth form of annotation allows Tk images to be embedded in a text
widget.
See L<"EMBEDDED IMAGES"> below for more details.

=head1 INDICES

Many of the methods for texts take one or more indices
as arguments.
An index is a string used to indicate a particular place within
a text, such as a place to insert characters or one endpoint of a
range of characters to delete.
Indices have the syntax

t/sample.pod  view on Meta::CPAN

First, the mark B<insert> is associated with the insertion cursor,
as described under L<"THE INSERTION CURSOR"> below.
Second, the mark B<current> is associated with the character
closest to the mouse and is adjusted automatically to track the
mouse position and any changes to the text in the widget (one
exception:  B<current> is not updated in response to mouse
motions if a mouse button is down;  the update will be deferred
until all mouse buttons have been released).
Neither of these special marks may be deleted.

=head1 EMBEDDED WINDOWS

The third form of annotation in text widgets is an embedded window.
Each embedded window annotation causes a window to be displayed
at a particular point in  the text.
There may be any number of embedded windows in a text widget,
and any widget may be used as an embedded window (subject to the
usual rules for geometry management, which require the text window
to be the parent of the embedded window or a descendant of its
parent).
The embedded window's position on the screen will be updated as the

t/sample.pod  view on Meta::CPAN

If the B<-pady> option has been specified as well, then the
requested padding will be retained even if the window is
stretched.

=item B<-window> =E<gt> I<$widget>

Specifies the name of a window to display in the annotation.

=back

=head1 EMBEDDED IMAGES

The final form of annotation in text widgets is an embedded image.
Each embedded image annotation causes an image to be displayed
at a particular point in  the text.
There may be any number of embedded images in a text widget,
and a particular image may be embedded in multiple places in the same
text widget.
The embedded image's position on the screen will be updated as the
text is modified or scrolled.
Each embedded image occupies one character's worth of index space

t/sample.pod  view on Meta::CPAN

that follows the B<image> prefix.
The following forms of the methods are currently supported:

=over 8

=item I<$text>-E<gt>B<imageCget>(I<index, option>)

Returns the value of a configuration option for an embedded image.
I<Index> identifies the embedded image, and I<option>
specifies a particular configuration option, which must be one of
the ones listed in L<"EMBEDDED IMAGES">.

=item I<$text>-E<gt>B<imageConfigure>(I<index, >?I<option, value, ...>?)

Query or modify the configuration options for an embedded image.
If no I<option> is specified, returns a list describing all of
the available options for the embedded image at I<index>
(see L<Tk::options> for information on the format of this list).
If I<option> is specified with no I<value>, then the command
returns a list describing the one named option (this list will be
identical to the corresponding sublist of the value returned if no
I<option> is specified).
If one or more I<option-value> pairs are specified, then the command
modifies the given option(s) to have the given value(s);  in
this case the command returns an empty string.
See L<"EMBEDDED IMAGES"> for information on the options that
are supported.

=item I<$text>-E<gt>B<imageCreate>(I<index, >?I<option, value, ...>?)

This command creates a new image annotation, which will appear
in the text at the position given by I<index>.
Any number of I<option-value> pairs may be specified to
configure the annotation.
Returns a unique identifier that may be used as an index to refer to
this image.
See L<"EMBEDDED IMAGES"> for information on the options that
are supported, and a description of the identifier returned.

=item I<$text>-E<gt>B<imageNames>

Returns a list whose elements are the names of all image instances currently
embedded in $text.

=back

=item I<$text>-E<gt>B<index>(I<index>)

t/sample.pod  view on Meta::CPAN

that follows the B<window> argument.
The following forms of the method are currently supported:

=over 8

=item I<$text>->B<windowCget>(I<index, option>)

Returns the value of a configuration option for an embedded window.
I<Index> identifies the embedded window, and I<option>
specifies a particular configuration option, which must be one of
the ones listed in L<"EMBEDDED WINDOWS"> above.

=item I<$text>->B<windowConfigure>(I<index>?, I<option, value, ...>?)

Query or modify the configuration options for an embedded window.
If no I<option> is specified, returns a list describing all of
the available options for the embedded window at I<index>
(see L<Tk::options> for information on the format of this list).
If I<option> is specified with no I<value>, then the command
returns a list describing the one named option (this list will be
identical to the corresponding sublist of the value returned if no
I<option> is specified).
If one or more I<option-value> pairs are specified, then the command
modifies the given option(s) to have the given value(s);  in
this case the command returns an empty string.
See L<"EMBEDDED WINDOWS"> above for information on the options that
are supported.

=item I<$text>->B<windowCreate>(I<index>?, I<option, value, ...>?)

This command creates a new window annotation, which will appear
in the text at the position given by I<index>.
Any number of I<option-value> pairs may be specified to
configure the annotation.
See L<"EMBEDDED WINDOWS"> above for information on the options that
are supported.
Returns an empty string.

=item I<$text>->B<windowNames>

Returns a list whose elements are the names of all windows currently
embedded in $text.

=back