home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
VSCPPv8.zip
/
VACPP
/
IBMCPP
/
samples
/
IOC
/
LISTBOX
/
README
< prev
Wrap
Text File
|
1995-06-09
|
6KB
|
125 lines
******************************************************************************
* List Box Sample Program Readme *
* *
* COPYRIGHT: Copyright (C) International Business Machines Corp., 1992,1995. *
* *
* DISCLAIMER OF WARRANTIES: *
* The following [enclosed] code is sample code created by IBM *
* Corporation. This sample code is not part of any standard IBM product *
* and is provided to you solely for the purpose of assisting you in the *
* development of your applications. The code is provided "AS IS", *
* without warranty of any kind. IBM shall not be liable for any damages *
* arising out of your use of the sample code, even if they have been *
* advised of the possibility of such damages. *
******************************************************************************
* NOTE: WE RECOMMEND USING A FIXED SPACE FONT TO LOOK AT THE SOURCE *
LISTBOX
DESCRIPTION:
The List Box Sample demonstrates adding and retrieving data from
a listbox. You can add items, retrieve select items, or retrieve
all the items to the second listbox. In addition, you can select
or deselect all listbox items and test for exception handling.
Classes used include IListBox and IException.
PROJECT LOCATION:
Inside the IOC Samples folder (inside the VisualAge C++ Samples
folder).
SOURCE FILE LOCATION:
X:\ibmcpp\samples\ioc\listbox
where X: is the drive you installed the samples and document
component of VisualAge C++.
HOW TO RUN THE SAMPLE:
FROM WITHIN THE WORKFRAME ENVIRONMENT:
To run the prebuilt project, open the Samples folder on your
OS/2 desktop then double-click on the project's icon to open
the project view of the sample. Click on the RUN button of
the project's toolbar.
FROM THE COMMAND LINE:
Simply type the name of the .EXE file, that is:
LISTBOX
If the sample fails to execute or abnormally ends, you can
get more information about the failure by turning on the
ICLUI trace. This is done by setting the environment
variable ICLUI_TRACE as follows:
set ICLUI_TRACE=ON
set ICLUI_TRACETO=STDERR
The second export controls where the trace information is
reported. With tracing turned on, ICLUI exception text will
be written to a standard error file. For example:
hello1 >hello1.out 2>&1
The exception data is now in the file hello1.out.
HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
FROM WITHIN THE WORKFRAME ENVIRONMENT:
Open the Samples folder on your OS/2 desktop then
double-click on the project's icon to open the project view
of the sample. In the upper half of the project window you
will see the icons of the files associated with the sample.
From the Project pulldown, select Build -> Rebuild All. To run
the sample project, see HOW TO RUN THE SAMPLE PROJECT above.
FROM THE COMMAND LINE:
- A command file is provided to allow rebuilding of the
WorkFrame projects from the command line. Simply type:
BUILD
To run the sample project, see HOW TO RUN THE SAMPLE PROJECT
above.
- The sample application can also be built by entering:
NMAKE
with no options while in the directory containing the
sample application files. The makefile is named
Makefile
To clean up the files generated from running make, enter:
NMAKE CLEAN
while in the directory containing the sample program files.
SOFTWARE/HARDWARE PREREQUISITES:
o IBM VisualAge C++
o OS/2 2.1 or Warp
o IBM or compatible 386 and up.
ADDITIONAL INFORMATION:
o For more information on the creation and use of projects in
the WorkFrame environment, see the VisualAge C++ for OS/2
User's Guide.
o For more information on the User Interface Classes, see the
VisualAge C++ for OS/2 Open Class Library User's Guide.
Both books can be found online. To access an online book, simply
open the main VisualAge C++ desktop folder, then open the
Information Folder inside. To view a book, double-click on that
book's icon.
REQUIRED FILES:
README - Readme file for LISTBOX
alistbox.cpp - Source code for LISTBOX
alistbox.hpp - Class header file form LISTBOX
alistbox.h - Defines for LISTBOX
alistbox.rc - Resource File for LISTBOX
alistbox.ico - OS/2 icon file
Makefile.os2 - Make file for building this sample program