Microsoft KB Archive/107990

= LONG: VB Pro 3.0 SAMPLES.TXT: Descriptions of Sample Programs =

PSS ID Number: 107990

Article Last Modified on 1/8/2003

-

The information in this article applies to:


 * Microsoft Visual Basic Professional Edition for Windows 3.0

-



This article was previously published under Q107990



SUMMARY
The following article contains the complete contents of the SAMPLES.TXT file distributed with the Professional Edition of Visual Basic version 3.0 for Windows. SAMPLES.TXT describes the sample programs shipped with this product.



MORE INFORMATION
SAMPLES.TXT

          Samples Notes for Microsoft (R) Visual Basic (R) Professional Edition

Version 3.00

(C) Copyright Microsoft Corporation, 1993

Contents
Sample Description -- ---  1     MAPI 2    Multimedia 3    Outline 4    Pen 5    PicClip 6    ODBC 7    Communications

1: MAPI Sample
Program example using the MSMAPI.VBX controls, MapiMessages and MapiSession controls.

NOTE: To run this sample, you need a MAPI-compliant messaging system such as the one contained in Microsoft Windows for Workgroups.

BRIEF DESCRIPTION:

This sample program illustrates the use of the MAPI controls by sending and receiving electronic mail.

BACKGROUND:

The MapiSession control establishes a MAPI session and signs off from a MAPI session. The MapiMessages control allows you to perform a variety of messaging systems functions after a messaging session has been established. These functions include accessing, downloading, and sending messages, displaying the details and address book dialog boxes, accessing data attachments, resolving recipient names during addressing, and performing compose, reply, reply-all, forward, and deleting actions on messages.

FILES:   MAILLST.FRM.......Form for displaying the list of mail messages. MAILLST.FRX.......The binary portion of the mail messages form. MAILOPTF.FRM......Form for setting options. MAILSUP.BAS.......Module of support routines for the example. MSGVIEW.FRM.......Form in which a viewed message is displayed. MSGVIEW.FRX.......The binary portion of the viewed messages form. NEWMSG.FRM........Form for creating a new message. VBMAIL.FRM........The main form. VBMAIL.FRX........The binary portion of the main form. VBMAIL.MAK........The MAKE file for the project.

TO RUN: After starting the Visual Basic environment (VB.EXE), you can load files in this sample program by choosing Open Project from the File menu and selecting the VBMAIL.MAK file.

2: Multimedia Sample
This sample program illustrates the use of some of the device types supported by the Media Control Interface (MCI). The four device types used in this program are:

Device Type    Description - MMMovie        Plays Multimedia movie files (*.MMM). CDAudio        Plays audio discs from the CD-ROM drive. Sequencer      Plays MIDI sequencer sound files (*.MID). WaveAudio      Plays digitized waveform sound files (*.WAV).

HARDWARE REQUIREMENTS:

In order to access a CD-ROM drive or a sound card, the hardware, along with any supporting device drivers, should be installed and configured for the machine. The following table lists the hardware required for the MCI device types used in this program:

Device Type    Hardware -- MMMovie        No extra hardware. *See software requirements. CDAudio        CD-ROM drive. Sequencer      Sound card (e.g., Sound Blaster Pro) WaveAudio      Sound card.

SOFTWARE REQUIREMENTS:

In order to run the MCI application, Microsoft Windows with Multimedia Extensions 1.0, or Windows with Multimedia must be installed. The Multimedia Extensions include device drivers for the different types of MCI devices.

To access a specific MCI device type, the corresponding MCI device driver must be installed. The following table lists the device drivers required for the MCI device types used in this program:

Device Type    Device Driver -- MMMovie        MCIMMP.DRV    *See note below. CDAudio        MCICDA.DRV Sequencer      MCISEQ.DRV WaveAudio      MCIWAVE.DRV

The [mci] section of the SYSTEM.INI file contains a list of the installed MCI device types. This is what your file would look like if all 4 of the above device types were installed:

[mci] CDAudio=mcicda.drv WaveAudio=mciwave.drv Sequencer=mciseq.drv MMMovie=mcimmp.drv

BACKGROUND:

The MCI control provides a high-level interface for using multimedia devices. Using the property settings of a control, you can determine the settings and the actions of a device.

The MCI control is also smart enough to know what actions are relevant for the current state of a device. For example, if you click a "Pause" button while playing a movie, the "Play" button is automatically re-enabled.

MMMovie NOTE:

If you are unable to run an animation movie (*.MMM file), make sure the MCIMMP.DRV and MMP.DLL files are installed on your machine. To install the animation driver from Windows 3.1, run the "Drivers" applet from the Control Panel, insert Disk 1 of the Professional Edition. Select "Unlisted Driver," and accept "A:\" as the directory. You will then be ready to use the animation features of the MCI control.

FILES:

  ABOUTBOX.FRM.......The dialog box for the "About Box." ABOUTBOX.FRX.......The binary portion of the "About Box" form. ANIMATE.FRM........Form for playing Multimedia Movie files. CD.FRM.............The form for playing compact disc audio. CD.FRX.............The binary portion of the compact disc form. GLOBAL.BAS.........Global data types and declarations. MCITEST.BAS........Global Subs and Functions. MCITEST.FRM........The main form. MCITEST.FRX........The binary portion of the main form. MCITEST.MAK........The make file for the project. MCITEST.MID........Sample MIDI sequencer file. MCITEST.MMM........Sample Multimedia Movie file. MCITEST.WAV........Sample waveform file. OPENDLG.FRM........Form for holding the common dialog control. WAVE.FRM...........Form for playing waveform and MIDI files.

TO RUN:

In the Visual Basic environment (VB.EXE), you can load the files in this sample program by choosing Open Project from the File menu, and selecting the MCITEST.MAK file.

Two additional files appear in the Project Window:

MCI.VBX............MCI control.

CMDIALOG.VBX.......Common Dialog control.

3: Outline Sample
Program example using the MSOUTLIN.VBX control.

BRIEF DESCRIPTION:

This sample program illustrates the use of the Outline control with an address book database application.

BACKGROUND:

The outline control allows users to graphically present hierarchically structured data in a variety of different ways.

FILES:   PHONE.FRM.........The main form. PHONE.FRX.........Binary data for the main form. PHONE.MAK.........The MAKE file for the project. PHONE.MDB.........Database file. PHONE.LDB.........Database file. FIRSTTAB.BMP......Bitmap for the project. LASTTAB.BMP.......Bitmap for the project. MIDTAB.BMP........Bitmap for the project.

TO RUN:

After starting the Visual Basic environment (VB.EXE), you can load files in this sample program by choosing Open Project from the File menu and select the PHONE.MAK file.

4: Pen Sample
NOTE: To run this sample you must have Windows for Pen Computing, or install the PENWIN.DLL file. See below.

BRIEF DESCRIPTION of PEN SAMPLE PROGRAM: This sample program illustrates many uses of the Pen controls:  * the new On-Screen Keyboard control * inking and displaying bitmaps on the new InkOnBitmap control * handwriting recognition in both delayed and non-delayed mode * recognition of gestures * transfer of ink data between controls * manipulation of the Recognition Context data structure * and more.

The file PENAPI.TXT contains function and constant declarations for the entire set of Windows for Pen Computing API.

FILES:   DELAY.FRM.........Form for demonstrating Delayed Recognition. DELAY.FRX.........The binary for DELAY.FRM. EDITSUBF.FRM......Support Form for Gesture demonstration. GESTFRM.FRM.......Form for demonstrating Custom Gestures. INKFRM.FRM........Form for showing transfer of Ink data. IOBFRM.FRM........Form demonstrating the Ink On Bitmap control. IOBFRM.FRX........The binary for IOBFRM.FRM. KEYBRD.FRM........Form for the On-Screen Keyboard Button demo. KEYBRD.FRX........The binary for KEYBRD.FRM. PENAPI.TXT........Pen function declarations and constants. PENMAIN.FRM.......Main form. PENMAIN.FRX.......The binary for MAIN.FRM. PENSMPL.MAK.......The MAKE file for the project. RCFRM.FRM.........Form demonstrating the Recognition Context. GRAFPAPR.BMP......Bitmap for creating graph paper effect. RULEPAPR.BMP......Bitmap for creating ruled paper effect. SKBFACE.BMP.......Bitmap of default keyboard on SKB Button. TRANSFRM.FRM......Form for demonstrating transfer of ink data.

TO RUN:

After starting the Visual Basic environment (VB.EXE), you can load files in this sample program by choosing Open Project from the File menu and select the PENSMPL.MAK file.

Installing PENWIN.DLL:

This procedure will result in a system that will let you run applications that contain Visual Basic BEdit, HEdit, InkOnBitmap, and SKB Button controls and call the Windows for Pen Computing APIs. You will not be able to perform handwriting recognition or draw ink on the screen. Microsoft Windows 3.1 is required.

SYSTEM.INI Changes

The following items must be added or changed in your SYSTEM.INI file so that the pen extensions will work. NOTE: Back up your old SYSTEM.INI file before proceeding.

  In the "[boot]" section:

Add "penwindows" to the list of drivers after "drivers=".

For example: drivers = mmsystem.dll penwindows </li> <li> In the "[drivers]" section:

Add a new item "penwindows" and set it equal to the path to PENWIN.DLL.

For example: penwindows = C:\WINDOWS\PENWIN.DLL </li> <li>Restart Windows.</li></ol>

When Windows is restarted, PENWIN.DLL will be loaded as an installed driver, and you will be able to run applications containing Visual Basic BEdit, HEdit, InkOnBitmap, and SKB Button controls and call the Windows for Pen Computing APIs.

5: PicClip Sample
Program example using the PICCLIP.VBX control.

BRIEF DESCRIPTION:

This sample program illustrates one of the many possible uses of the Picture Clipping control.

BACKGROUND:

This sample application uses the PicClip control to spin a top.

FILES: <pre class="fixed_text">  INFOFORM.FRM......The information form. INFOFORM.FRX......The binary data for the information form. REDTOP.FRM........The main form. REDTOP.FRX........The binary data for the main form. REDTOP.MAK........The MAKE file for the project.

TO RUN:

After starting the Visual Basic environment (VB.EXE), you can load files in this sample program by choosing Open Project from the File menu and selecting the REDTOP.MAK file.

6: ODBC
Program example using ODBC and the VT (Virtual Table) object layer.

NOTE: To access ODBC data sources with this sample, you must first install ODBC using the ODBC setup program provided with Visual Basic Professional Edition.

BRIEF DESCRIPTION:

This sample program illustrates various programming techniques used to access data through the VT layer built into the Visual Basic Professional Edition. It behaves like a general purpose database utility capable of the following functions:


 * 1) Table Creation
 * 2) Table Modification (adding and deleting fields and indexes)
 * 3) Data Browsing/Modifying one record at a time using a dynaset or a table.
 * 4) Data Browsing via the Grid control (non-updatable)
 * 5) Data Browsing/Modifying via the new Data Control
 * 6) Data Export to Tab Delimited text file
 * 7) Direct SQL Statement execution for any SQL supported functions such as Insert, Update, Delete, Drop, Create, Dump, etc.
 * 8) AdHoc Query tool that helps users unfamiliar with SQL create complex queries with where clauses, joins, order by and group by expressions while limiting output to selected columns
 * 9) Transaction Processing
 * 10) Copying table structures and data to same or different server
 * 11) Support of Microsoft Access, Dbase 3, Dbase 4, FoxPro 2.0, Paradox 3.x, Btrieve, SQL and Oracle data, both DDL and DML.

The code contains comments to help explain the use of the various methods in the data access layer. Code and forms may be copied from this application to other applications with minimal modification.

ODBC BACKGROUND:

ODBC (Open Database Connectivity) is a standard adopted by multiple vendors designed to enable users to connect to any data source with a single application. This is achieved through a layered approach including:


 * 1) Programming Layer-embedded functions in the development tool which in this case is Visual Basic Professional.
 * 2) Driver Manager-the basic ODBC library that routes calls to the appropriate driver.
 * 3) Data Driver - the library of functions that acts upon a specific database backend such as SQL Server, Xbase, Excel, etc. (note that SQL Server is the first of many drivers to become available for ODBC)

These layers work together to enable data access from any source for which an ODBC driver exists. The sample application will work, without modification, on any new level one ODBC driver that becomes available. With multiple drivers, connections may be made to different data sources from the same application at the same time enabling seamless data access from disparate data sources.

FILES: <pre class="fixed_text">  ABOUTBOX.FRM......Standard "About box" for the application. ABOUTBOX.FRX......Icon for the "About Box". ADDFIELD.FRM......Form to add fields to Tables. CPYSTRU.FRM.......Form to copy Table structures. DATABOX.FRM.......General purpose list form. DYNAGRID.FRM......Form used to display data in a Grid control. DYNAGRID.FRX......Icon for DYNAGRID.FRM. DYNASET.FRM.......Form to display data in single record mode. DYNASET.FRX.......Icon for DYNASET.FRM FIND.FRM..........Form used to find records in a Dynaset. INDEXADD.FRM......Form used to add indexes to Tables. JOIN.FRM..........Form used to add Joins to the Query Builder. OPENDB.FRM........Form used to open a database. QUERY.FRM.........Form used to build Queries. QUERY.FRX.........Icon for QUERY.FRM. REPLACE.FRM.......Form to perform global replaces on a Table. REPLACE.FRX.......Icon for REPLACE.FRM. SEEK.FRM..........Form used to get input for Seek function on Table form. SQL.FRM...........Form to enter and execute SQL statements. SQL.FRX...........Icon for SQL.FRM. TABLES.FRM........Form used to display table lists. TABLES.FRX........Icon for TABLES.FRM. TABLEOBJ.FRM......Form used to display data in Table object TABLEOBJ.FRX......Icon for TABLEOBJ.FRM TBLSTRU.FRM.......Form to display and modify table structures. VDMDI.FRM.........Main MDI form for the application. VDMDI.FRX.........Icon for VDMDI.FRM. VISDATA.BAS.......Support functions for the application. VISDATA.ICO.......Icon for the applicaiton. VISDATA.MAK.......Make file for applicaiton. ZOOM.FRM..........Form to zoom in on character data in the dynaset forms.

TO RUN:

After starting the Visual Basic environment (VB.EXE), you can load files in this sample program by choosing Open Project from the File menu and selecting the VISDATA.MAK file in the SAMPLES\VISDATA directory.

To open a local database, choose the type of database and a file open common dialog will be provided with the file type set to the requested data file type.

If you choose ODBC from the File/Open menu, the next dialog you will see is the Open Database form. Because you probably have no servers entered, you will need to enter a name for an existing SQL server on your network. If you already know the user ID and password, you can add them as well. The Database name is optional. Once you have entered this data, select 'Okay' and you should be able to log on to the server. You may get some more dialogs in the process. Answer any questions you can and ask the SQL administrator for help if you run into problems or don't know some of the parameters.

Once a database is open, double-click a table name to open the table in the selected mode (Single Record or Table View). Use the Query Builder to create dynasets with selected data from one or more tables at a time. If "Use Data Control" or "Use Grid" is chosen, a dynaset will be created. However, the following objects will be created only under the following circumstances when the "No Data Control" option is selected:

<pre class="fixed_text">Data Type           Feature Chosen    Object Type Created -- Microsoft Access    Table Open        Table Microsoft Access    Query Open        Dynaset Microsoft Access    Execute SQL       Dynaset ISAM                Table Open        Table ISAM                Execute SQL       Dynaset ODBC                Any               Dynaset

The table is always updatable and the dynaset will be updatable in most cases except on ODBC with no unique index, certain multiple table joins, and other SQL select statements such as count(*), max, and so on.

VBTERM Sample
VBTERM is a terminal emulation program example using MSCOMM.VBX.

BRIEF DESCRIPTION:

This sample program illustrates how to use the communications control with a serial port.

BACKGROUND:

MSCOMM.VBX allows you to open a serial port, change its settings, send and receive data through the port, and monitor and set many of the different data lines. It's dual-method access allows for both polling and event driven communications.

FILES: <pre class="fixed_text">  CANSEND.FRM.......Dialog box used during file transfer. TERMSET.FRM.......Form used to change the serial port settings. TERMSET.FRX.......Binary data for TERMSET.FRM. VBTERM.FRM........The main form. VBTERM.FRX........Binary data for VBTERM.FRM. VBTERM.GLO........Global declarations. VBTERM.MAK........The MAKE file for the project.

TO RUN:

After starting the Visual Basic environment (VB.EXE), you can load files in this sample program by choosing Open Project from the File menu and select the VBTERM.MAK file.

Dialer Sample
DIALER is a program example demonstrating how to dial out using MSCOMM.VBX with a modem.

FILES: <pre class="fixed_text">  DIALER.FRM........The main form. DIALER.MAK........The MAKE file for the project.

TO RUN:

After starting the Visual Basic environment (VB.EXE), you can load files in this sample program by choosing Open Project from the File menu and select the DIALER.MAK file.

Additional query words: 3.00

Keywords: KB107990

Technology: kbAudDeveloper kbVB300 kbVB300Search kbVBSearch kbZNotKeyword2 kbZNotKeyword6

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© 2004 Microsoft Corporation. All rights reserved.