Mark Dootson > Wx-0.9909 > Wx

Download:
Wx-0.9909.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

New  26
Open  26
Stalled  2
View/Report Bugs
Module Version: 0.9909   Source   Latest Release: Wx-0.9923

NAME ^

Wx - interface to the wxWidgets cross-platform GUI toolkit

SYNOPSIS ^

    use Wx;

    my $app = Wx::SimpleApp->new;
    my $frame = Wx::Frame->new( undef, -1, 'Hello, world!' );

    $frame->Show;
    $app->MainLoop;

DESCRIPTION ^

The Wx module is a wrapper for the wxWidgets (formerly known as wxWindows) GUI toolkit.

This module comes with extensive documentation in HTML format; you can download it from http://wxperl.sourceforge.net/

INSTALLATION ^

Please see docs/INSTALL.pod in source package.

Windows XP look ^

For standalone (packed using PAR, Perl2Exe, Perl2App, ...) applications to get Windows XP look, a file named App.exe.manifest (assuming the program is named App.exe) and containing the text below must be placed in the same directory as the executable file.

  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
      <assemblyIdentity
          processorArchitecture="x86"
          version="5.1.0.0"
          type="win32"
          name="Controls"
      />
      <description>Super wxPerl Application</description>
      <dependency>
          <dependentAssembly>
              <assemblyIdentity
                  type="win32"
                  name="Microsoft.Windows.Common-Controls"
                  version="6.0.0.0"
                  publicKeyToken="6595b64144ccf1df"
                  language="*"
                  processorArchitecture="x86"
          />
      </dependentAssembly>
      </dependency>
  </assembly>

Running on Mac OSX ^

From version 0.98 wxPerl no longer needs to use the special startup executable 'wxperl' to run scripts on the Mac. The ordinary perl interpreter now works without problems. This is because wxPerl now contains code that brings the running application to the front and gives it the focus.

In a syntax checking editor you may prevent Wx code from being given focus as the front process by setting an environment variable

export WXPERL_OPTIONS=NO_MAC_SETFRONTPROCESS

or

$ENV{WXPERL_OPTIONS} = 'NO_MAC_SETFRONTPROCESS';

The code that makes the SetFrontProcess call is in Wx::Mini as

Wx::MacSetFrontProcess();

so it is also straightforward to override this method if you wish.

Finally, any code can force the running application to become the front process regardless of environment settings by calling the xs method directly. (Note the underscore in the method name).

Wx::_MacSetFrontProcess();

AUTHOR ^

Mattia Barbon <mbarbon@cpan.org>

LICENSE ^

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

syntax highlighting: