Perl::Dist::WiX::Asset::Website - Website link asset for a Win32 Perl
This document describes Perl::Dist::WiX::Asset::Website version 1.250.
my $distribution = Perl::Dist::WiX::Asset::Website->new( parent => $dist, name => 'Strawberry Perl Website', url => 'http://strawberryperl.com/', icon_file => 'C:\icons\strawberry.ico', icon_index => 1, );
This asset creates a website link in the Start Menu using the parameters given.
This class is a Perl::Dist::WiX::Role::Asset and shares its API.
The new constructor takes a series of parameters, validates then and returns a new Perl::Dist::WiX::Asset::Website object.
new
It inherits all the params described in the Perl::Dist::WiX::Role::Asset->new() method documentation, and adds some additional params.
The required name parameter is the name of the link on the Start Menu, and also becomes the name of the .url file in the win32 directory under the image location.
name
win32
The required url parameter is the website to link to.
url
The optional directory_id parameter is the ID of the Start Menu directory (or subdirectory of that entry) used by the distribution.
directory_id
Defaults to 'App_Menu_Websites', which puts the shortcut in the 'Related Websites' subdirectory of the Start Menu directory used by the distribution.
The optional icon_file parameter is the file that contains the icon for the Start Menu entry.
icon_file
Defaults to undef, which allows Windows to use its default icon for websites.
The optional icon_index parameter is the index within a .dll file containing multiple icons of the icon to use.
icon_index
This defaults to 1, meaning the first icon in the file, if icon_file is set, and udenf if it is not.
The install method installs the website link described by the Perl::Dist::WiX::Asset::Website object and returns true.
Bugs should be reported via the CPAN bug tracker at
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Perl-Dist-WiX
For other issues, contact the author.
Curtis Jewell <csjewell@cpan.org>
Adam Kennedy <adamk@cpan.org>
Perl::Dist::WiX, Perl::Dist::WiX::Role::Asset
Copyright 2009 - 2010 Curtis Jewell.
Copyright 2007 - 2009 Adam Kennedy.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
The full text of the license can be found in the LICENSE file included with this module.
To install Perl::Dist::WiX, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Perl::Dist::WiX
CPAN shell
perl -MCPAN -e shell install Perl::Dist::WiX
For more information on module installation, please visit the detailed CPAN module installation guide.