This code is used to highlight text in a Tk::Text window. This is useful in the context of highlighting some kind of tags, but could be used for any text. By changing a value, you can turn the text highlighting on and off.

Usage (from Tk widget "-command" option):

[\&toggleTextHighlighting \$highlight, \$regex, \$widget]

Where $highlight equals 1 or 2 (highlighting on or off), $regex is the regular expression used to highlight the text, and $widget is a reference to a Text widget.

sub toggleTextHighlighting {
    my ($highlight, $regex, $widget) = @_;

    # Deference the variables that you need to get values from
    $highlight = ${$highlight};
    $regex = ${$regex};
    $widget = ${$widget};

    # Create a tag to configure the text
                            -foreground => "white",
                            -background => "red");
    if ($highlight == 1) {
        $widget->FindAll(-regex, -nocase, $regex);
        if ($widget->tagRanges('sel')) {
            my %startfinish  = $widget->tagRanges('sel');
            foreach(sort keys %startfinish) {
                $widget->tagAdd("foundtag", $_, $startfinish{$_});
        $widget->tagRemove('sel', '1.0', 'end');
    } else {
        $widget->tagRemove("foundtag", '1.0', 'end');