NAME

Win32::FindWindow - find windows on Win32 systems

SYNOPSIS

    use Win32::FindWindow;
    
    # find a window with the class name.
    my $window = find_window( classname => 'ExploreWClass' );
    
    # basename, filename, windowtext, and classname can be specified.
    my $window = find_window( basename   => 'Explorer.EXE'
                            , filename   => 'C:\\WINDOWS\\Explorer.EXE'
                            , windowtext => 'C:\\'
                            , classname  => 'ExploreWClass' );
    
    # hwnd and pid can be specified, too.
    # hwnd defaults to the retval of GetDesktopWindow().
    # pid is not effective until specifying it.
    
    # find with regexp:
    # it must set the value by qr// style.
    my $window = find_window( classname  => qr/^ExploreWClass$/
                            , filename   => qr/^C:\\WINDOWS\\.*/
                            , basename   => qr/^Explorer.EXE$/
                            , windowtext => qr/^C:\\$/ );
    
    # the retval is an object.
    # the read-only accessor are as follows:
    $window->hwnd;
    $window->windowtext;
    $window->classname;
    $window->pid;
    $window->filename;
    $winfow->basename;
    
    # call find_windows() to return multiple values.
    my @windows = find_windows( classname => 'MSPaintApp'
                              , filename  => 'C:\\WINDOWS\\system32\\mspaint.exe'
                              , basename  => 'mspaint.exe'
                              , windowtext => qr/^.+$/ );
    
    # set $Win32::FindWindow::ENCODING with wide characters search
    # ex. Japanese UTF-8
    use utf8;
    use encoding 'utf8', STDOUT => 'cp932';
    $Win32::FindWindow::ENCODING = 'cp932';
    
    my @windows = find_windows( classname => qr/スタート/ );

DESCRIPTION

This module provides routines for finding windows on Win32 systems.

METHODS

read-only accessors

hwnd()

windowtext()

classname()

pid()

filename()

basename()

AUTHOR

Michiya Honda <pia@cpan.org>

LICENCE

This library is free software, licensed under the same terms with Perl. See perlartistic.