NAME

Qt4 - Perl bindings for the Qt4 version 4 library

SYNOPSIS

  use Qt4;

DESCRIPTION

This module is a port of the PerlQt43 package to work with Qt4 version 4.

EXPORT

None by default.

PERL-SPECIFIC DOCUMENTATION

The following is a list of perl-specific implementation details, broken up by class.

Qt4::Variant

According to the Qt4 documentation:

    Because QVariant is part of the Qt4Core library, it cannot provide
    conversion functions to data types defined in Qt4Gui, such as QColor,
    QImage, and QPixmap.  In other words, there is no toColor() function.
    Instead, you can use the QVariant::value() or the qVariantValue() template
    function.

PerlQt4 implements this functionality by supplying 2 functions, Qt4::qVariantValue() and Qt4::qVariantFromValue(). These two functions, in addition to handling the Qt4Gui types, can also handle Perl hash references and array references. To accomplish this, 2 metatypes have been declared, called 'HV*' and 'AV*'.

Qt4::qVariantValue()

Returns: An object of type $typename, or undef if the conversion cannot be made.

Args: $variant: A Qt4::Variant object. $typename: The name of the type of data you want out of the Qt4::Variant. This parameter is optional if the variant contains a perl hash or array ref.

Description: Equivalent to Qt4's qVariantValue() function.

Qt4::qVariantFromValue()

Returns: A Qt4::Variant object containing a copy of the given value on success, undef on failure.

Args: $value: The value to place into the Qt4::Variant.

Description: Equivalent to Qt4's qVariantFromValue() function. If $value is a hash or array ref, the resulting Qt4::Variant will have it's typeName set to 'HV*' or 'AV*', respectively.

SEE ALSO

The existing Qt4 documentation is very complete. Use it for your reference.

Get the project's current version at http://code.google.com/p/perlqt4/

AUTHOR

Chris Burel, <chrisburel@gmail.com>

COPYRIGHT AND LICENSE

Copyright (C) 2008 by Chris Burel

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.