Win32::Editor::PFE 0.2
    This module symplifies the DDE link to the great PFE
    (Programmer's File Editor). It provides all DDE functions
    mentioned in PFE's DDE help plus some more. It takes care of
    spawning PFE if it's not already running.

  Ussage

        use Win32::Editor::PFE;
        $pfe = new Win32::Editor::PFE;
        $pfe->Open('script.pl');
        $id = $pfe->Get('WindowID');
        $pfe->Pos(23,10);
        $pfe->EditInsert("<THIS TEXT WAS INSERTED BY A SCRIPT>");
        $pfe->WindowActivate($id);
        $pfe->ComeToForeground();
        undef $pfe;

  Functions

    new
     $pfe = new Win32::Editor::PFE;
     $pfe = new Win32::Editor::PFE (@files_to_open);

    This constructor creates a new Win32::Editor::PFE object and
    connects it to an instance of PFE. If PFE is not running at the
    moment, this function starts it.

    Connect
     $pfe->Connect();

    This functions connects the object to an instance of PFE if it's
    not already connected. This function is called by almost all
    methods to ensure there is a PFE to send the command to.

    Disconnect
     $pfe->Disconnect();

    Disconnects the object from PFE. You should call this method as
    soon as posible after virtualy each method call. The thing is
    that PFE is able to take only one open connection at a time, so
    if you keep the connection you block out other programs and
    scripts.

    Connected
     $isConnected = $pfe->Connected()

    Checks if the object is connected to an instance of PFE.

    Open
     $pfe->Open(@list_of_filenames);
     $pfe->Open(@list_of_filenames, $use_saved_position);

    Opens all the files in the list and returns the number of
    successfuly opened files. If $use_saved_position=1, PFE tries to
    open the files using saved possitions. See FileOpen() in DDE
    Commands in PFE's help.

    You do not have to use absolute paths for the filenames, the
    function takes care of this automaticaly.

    OpenAt
     $pfe->OpenAt( $filename, $line_number [, $column_number]);
     $pfe->OpenAt( $filename, $position_specification);

    Opens a file and possitions the cursor on a particular line and
    column.

    See the PFE's help for file position specifications.

    FileOpen
    This function is exactly as described in PFE's help, except the
    fact that it converts relative paths to absolute.

    Get
     $value = $pfe->Get("property name");

    You may get the value of all data items mentioned in PFE's help,
    "DDE Data Items" topic.

    Pos
     $line_number = $pfe->Pos();
     ($line_number, $column_number) = $pfe->Pos();
     $pfe->Pos( $line_number);
     $pfe->Pos( $line_number, $column_number);
     $pfe->Pos( $position_specification);

    Using this function you may get the current position in the
    active window and/or change it. If you change the position, the
    function returns the original position.

    Execute
     $pfe->Execute("[TheCommand(...)]");
     $pfe->Execute('TheCommand',@parameters);

    This function sends the specified command to PFE. You may either
    enter the command directly as is ("[FileNew()]",
    "[CaretDown(3,1)]", "[FileOpen("c:\autoexec.bat")]", etc.) or
    specify the function name and the parameters. The functions
    takes care of the quoting, I hope it does it right.

    You should not have to use this function, use the AUTOLOADing
    feature instead and write

        $pfe->CaretDown(3,1);
       instead of
        $pfe->Execute('CaretDown','3','1');

    Result
     $pfe->Result();

    Gives you the result of the last command executed over the DDE
    link. The reply will be one of the strings "OK" or "Error" if a
    result is available, and "Busy" if the server is currently
    processing a DDE link command. The results of commands executed
    from the keyboard, menu or toolbar cannot be read by this
    method.

  Author

    Jenda@Krynicky.cz