CAPITAL Series 7 Visual Builder Reference Guide - Shell()

Contents

Fast Start

Weight Scale Interfacing (Digi D770)

What Is Visual Builder?

What's New In Visual Builder?

Creating A CAPITAL Form

Creating a Form - Conceptual Overview

Creating a Form - Quick Guide For Advanced Users

The Forms Wizard

Creating A CAPITAL Report

The Label Wizard

Report Wizard Tutorial

New & Revised Topics in CAPITAL 7.5

AllocatePayment()

PayMethodName()

New & Revised Topics in CAPITAL 7.41

Business Functions Listing

BufferRollBack()

BufferUpdates()

StockQuantity()

WriteTextFile()

New & Revised Topics in CAPITAL 7.4

Business Functions Listing

Moving & Resizing Body Objects

Operators & Expressions

Picture Object Properties

RunApplication()

Send Product Info Email With Pictures

Start-up Switches

StockAnalysis()

New & Revised Topics in CAPITAL 7.3

AddTraceProperty()

Business Functions Listing

LockSemaphore()

Trouble-Shooting Guide

UnlockSemaphore()

New & Revised Topics in CAPITAL 7.2

Business Functions Listing

StockGetQuantity()

StockQuantity()

Basic Editing

Moving & Resizing Objects

Moving & Resizing Body Objects

Creating Forms & Reports

Form Design Hints & Tips

Body Properties

Rule Wizard Guidelines

Body Groups & Totals

Form Output Properties

Question Wizard

Form Question Prompt

Preface and Postscript Scripts

Form Dictionaries

Form Editor Preferences

Bar Code Field Objects

Text Object Properties

Picture Object Properties

Why are Table Joins Necessary?

Linking Forms - Concepts

Linking Forms - Tutorial

Linking Forms - Hints & Problem Solver

Special Topics

CAPITAL Data Browser

Bar Codes - An Overview

Cross-Tab Concepts

Cross Tab Fields

Cross-Tab Hints & Tips

Printing

Transaction (Form) Printing

The Print Job Manager

Windows Printing Concepts

Script Programming

Business Functions Listing

Capital Business Script

Variables & Data Types

Operators & Expressions

Type Conversion

Business Functions Overview

IF (expression) GOTO

IF (expression) ... ELSE ... ENDIF

Visual Forms Builder Special Variables

Sending Email Using CBS

Programmer's Frequently Asked Questions

Business Functions

AddTraceProperty()

AllocatePayment()

BufferRollBack()

BufferUpdates()

CompressTable()

CopyToClipBoard()

CreateEmailJob()

CreatePrintJob()

DateFromMonth()

ExpenseAnalysis()

OpenVisualBuilder()

PayMethodName()

RunApplication()

SendEscapeCodes()

StockAnalysis()

StockDescription()

StockMovement()

StockQuantity()

WriteFileLine()

WriteTextFile()

Tutorials

Report Wizard Tutorial (Basic)

Label Wizard Tutorial (Advanced)

Forms Library

The Visual Builder Report & Forms Library

Forms Stationary

Report Library - Customer Transactions

Report Library - Cash Management

Report Library - Sales Analysis

Report Library - Sales Orders & Back Orders

Report Library - Stock Control

Report Library - Service Management & Periodic Billing

Report Library - Special

Appendix

Overriding Print Warning Messages

Questions & Answers

Start-up Switches

Trouble-Shooting Guide

Weight Scale Interfacing (Digi D770)

Working With Text Printers

CAPITAL Series 7 Visual Builder Reference Guide

Shell()

Execute another application or task.

Syntax

Shell(cFile, [cParameters], [cfolder], [nShow]) --> nResult

Arguments

<cFile> --> is the application program to start, for example, "EXCEL"

<cParameters> --> are optional parameters to pass to the application or task.

<cfolder> --> is an optional parameter that indicates in which folder the application is found. This is the folder path.

<nShow> --> is an optional instruction on how to show the application when it starts. The default value is 1. The range of acceptable values are listed in the following table:

Value	Meaning
0	Hide application when starting. (Do not make it visible.)
1	Display normally.
2	Start as an icon (minimised on taskbar).
3	Start maximised (take up full area of display).
4	Display but not make it the active window by changing focus.

While you may issue a show instruction there is no guarantee that the application or task will obey the request.

Returns

Returns a numeric value. Values between 0 and 31 indicate a failure to execute the program or perform the task. Common error conditions are listed in the table below:

Value	Meaning
0	System was out of memory, executable file was corrupt, relocations were invalid, or parameters sent to function were of incorrect format.
2	File not found.
3	Path not found.
8	There was insufficient memory to start the application.
10	Windows version was incorrect.
11	Executable file was invalid. Either it was not a Windows application or the EXE program was corrupted.
16	Attempt to load an application that could not be loaded twice.
20	One of the DLL files associated with the application or task was corrupt.
31	There is no associated file type or action for the request that Windows can recognise.

Description

This function is used to start another application or execute a task.

Example

* Open Excel

Shell("Excel")

* Start Windows Explorer

Shell("Explorer")

* Go to CAPITAL web site

Shell("www.capitaloffice.com.au")

* Send an email using your default email software

Shell("mailto:support@capialoffice.com.au")

____________________________

Related Topics

Business Function List

RunApplication()

Sending Email Using CBS