NAME

Win32::AutoItX::Control::TreeView - OO interface for TreeView32 controls

SYNOPSIS

    use Win32::AutoItX;

    my $a = Win32::AutoItX->new;

    my $pid = $a->Run('regedit.exe');
    my $window = $a->get_window('Registry Editor');
    $window->wait;
    $window->show;

    my $treeview = $window->get_control('SysTreeView321')->treeview();
    $treeview->expand('#0');
    for my $i (0 .. $treeview->count('#0') - 1) {
        print "Item #$i = ", $treeview->text("#0|#$i"), "\n";
    }

    $treeview->expand('Computer|HKEY_LOCAL_MACHINE');
    $treeview->select('Computer|HKEY_LOCAL_MACHINE|SOFTWARE');

DESCRIPTION

Win32::AutoItX::Control::TreeView provides an object-oriented interface for AutoItX methods to operate with TreeView32 (SysTreeView32) controls.

The $item parameter is a string-based parameter that is used to reference a particular treeview item using a combination of text and indices. Indices are 0-based. For example:

    Heading1
    ----> H1SubItem1
    ----> H1SubItem2
    ----> H1SubItem3
    ----> ----> H1S1SubItem1
    Heading2
    Heading3

Each "level" is separated by |. An index is preceded with #. For example:

    Item            $item
    Heading2        "Heading2" or "#1"
    H1SubItem2      "Heading1|H1SubItem2" or "#0|#1"
    H1S1SubItem1    "Heading1|H1SubItem3|H1S1SubItem1" or "#0|#2|#0"

METHODS

new

    $treeview = Win32::AutoItX::Control::TreeView->new($control)

creates a TreeView object.

count

    $count = $treeview->count($item)

returns the number of children for a selected item.

exists

    $boolean = $treeview->exists($item)

returns 1 if an item exists, otherwise 0.

text

    $text = $treeview->text()

returns the text of an item.

is_checked

    $checked = $treeview->is_checked($item)

returns the state of an item. 1:checked, 0:unchecked, -1:not a checkbox.

check

    $treeview->check($item)

checks an item (if the item supports it).

uncheck

    $treeview->uncheck($item)

unchecks an item (if the item supports it).

collapse

    $treeview->collapse($item)

collapses an item to hide its children.

expand

    $treeview->expand($item)

expands an item to show its children.

select

    $treeview->select($item)

selects an item.

selected

    $item = $treeview->selected($use_index)

returns the item reference of the current selection using the text reference of the item (or index reference if $use_index is set to 1).

Win32::AutoItX::Control methods

This module also provides most of Win32::AutoItX::Control methods.

SEE ALSO

Win32::AutoItX::Control

Win32::AutoItX

AutoItX Help

https://www.autoitscript.com/autoit3/docs/functions/ControlTreeView.htm

AUTHOR

Mikhail Telnov <Mikhail.Telnov@gmail.com>

COPYRIGHT

This software is copyright (c) 2017 by Mikhail Telnov.

This library is free software; you may redistribute and/or modify it under the same terms as Perl itself.

cpanm Win32::AutoItX

perl -MCPAN -e shell
install Win32::AutoItX