Help-Site Computer Manuals
Software
Hardware
Programming
Networking
  Algorithms & Data Structures   Programming Languages   Revision Control
  Protocols
  Cameras   Computers   Displays   Keyboards & Mice   Motherboards   Networking   Printers & Scanners   Storage
  Windows   Linux & Unix   Mac

Win32API::Const
Access Win32 constants such as WM_CLOSE, HELP_CONTENTS, etc.

Win32API::Const - Access Win32 constants such as WM_CLOSE, HELP_CONTENTS, etc.


NAME

Win32API::Const - Access Win32 constants such as WM_CLOSE, HELP_CONTENTS, etc.


SYNOPSIS


  #

  # Access value of WM_CLOSE without importing it

  #

  use Win32API::Const;

  print "WM_CLOSE         = ", Win32API::Const::WM_CLOSE(), "\n";



  #

  # Import and access values of WM_CLOSE and HELP_CONTENTS

  #

  use Win32API::Const qw(WM_CLOSE HELP_CONTENTS);

  print "WM_CLOSE         = ", WM_CLOSE(),      "\n";

  print "HELP_CONTENTS    = ", HELP_CONTENTS(), "\n";



  #

  # Import WM_CLOSE, along with all constants whose names start with WS_ or SE_

  #

  use Win32API::Const qw(:WS_ WM_CLOSE :SE_);

  print "WM_CLOSE         = ", WM_CLOSE(),         "\n";

  print "WS_MAXIMIZE      = ", WS_MAXIMIZE(),      "\n";

  print "WS_MINIMIZE      = ", WS_MINIMIZE(),      "\n";

  print "WS_OVERLAPPED    = ", WS_OVERLAPPED(),    "\n";

  print "SE_SHUTDOWN_NAME = ", SE_SHUTDOWN_NAME(), "\n";


DESCRIPTION

The Win32API::Const module allows you to access the values of Win32 constants by name. Almost 6,000 constants are included -- these were parsed from the egcs 1.1 header files: Defines.h, Messages.h, Errors.h, Base.h, and Sockets.h.

Constant names and values were parsed from the egcs 1.1 Win32 header files (egcs is the free GNU C/C++ compiler). You can download the Win32 version of egcs from <ftp://ftp.xraylith.wisc.edu/pub/khan/gnu-win32/>.

A full list of Win32 constants and their meanings can be found in the documentation for your Win32 C/C++ compiler or in the Microsoft Developer Network (MSDN).

IMPORT A CONSTANT

To import a constant, specify its name on the use line. For example, to import the constants WM_CLOSE and SE_SHUTDOWN_NAME, do this:


  use Win32API::Const qw(WM_CLOSE SE_SHUTDOWN_NAME);

Then, you can get the value of the constant by calling it like a subroutine.


  my $value = WM_CLOSE();

  print "The value of WM_CLOSE is: $value\n";

IMPORT A RANGE OF CONSTANTS

If you want to import all Win32 constants that start with, let's say, ``WM_'', then place ``:WM_'' in the import list. For example:


  use Win32API::Const qw(:WM_);

  print "The value of WM_CLOSE is: ", WM_CLOSE(), "\n";

  print "The value of WM_HELP is:  ", WM_HELP(),  "\n";

You can import an individual constant and a range of constants on the same line. For example, let's say you wan to import all the constants that start with WM_ and HELP_, along with the constant named SE_SHUTDOWN_NAME.


  use Win32API::Const qw(:WM_ SE_SHUTDOWN_NAME :HELP_);

The order you list stuff in the import list does not matter.

Note that importing :WM is different than importing :WM_ (note the trailing underscore). The former imports constants such as WMSZ_BOTTOM, whereas the latter does not. It's up to you what you want to do.

USE A CONSTANT WITHOUT IMPORTING IT

You can still use a constant, even if you do not import it into your namespace -- heck, even if you do not import any constants into your namespace. Just call it like you would any subroutine, and specify the full Win32API::Const package name.


  use Win32API::Const;

  print "WM_CLOSE = ", Win32API::Const::WM_CLOSE(), "\n";


COPYRIGHT

Win32API::Const -- Basic API Constants Copyright (C) 1998 Brian Dellert: <aspider@pobox.com>, 206/689-6828, <http://www.applespider.com>

Constants parsed from the egcs 1.1 header files Defines.h, Messages.h, Errors.h, Base.h, & Sockets.h

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program (gpl.license.txt); if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.


SEE ALSO

Programminig
Wy
Wy
yW
Wy
Programming
Wy
Wy
Wy
Wy