Build Method

Rebuilds a project or creates an application (.app) file, executable (.exe) file, or dynamic-link library (.dll) from a Visual FoxPro project.

Object.Build([cOutputName] [, nBuildAction] [, lRebuildAll]   
[, lShowErrors] [, lBuildNewGUIDs])

Parameters

cOutputName

Specifies the name of the .app, .exe, or .dll file to create.

If cOutputName includes a file extension and nBuildAction is omitted, the file extension in cOutputName determines the type of file built. For example, if the extension in cOutputName is ".exe", an executable file is created.

nBuildAction

Specifies that to rebuild a project or generate an .app, .exe, or .dll file. If nBuildAction is specified and cOutPutName does not include an extension, the appropriate extension is added.

The following table lists the values for nBuildAction.

nBuildAction FoxPro.h constant Description

1

BUILDACTION_REBUILD

Rebuilds the project. (Default)

2

BUILDACTION_BUILDAPP

Creates an .app file.

3

BUILDACTION_BUILDEXE

Creates an .exe file.

4

BUILDACTION_BUILDDLL

Creates a .dll file.

5

BUILDACTION_BUILDMTDLL

Creates a multithreaded .dll file.

lRebuildAll

Specifies whether to recompile files in the project before creating an .app, .exe, or .dll file.

If lRebuildAll is True (.T.), the following files are recompiled:

  • Program files.

  • Format files.

  • Source code in forms, labels, reports, and visual class libraries.

  • Stored procedures in databases.

If lRebuildAll is False (.F.) or is omitted, files in the project are not recompiled before creating the .app, .exe, or .dll file.

lShowErrors

Specifies whether to display compilation errors in an editing window after the build completes.

The following table describes the values for lShowErrors.

lShowErrors Description

True (.T.)

Display errors in an editing window for an error (.err) file.

False (.F.) or omitted

Do not display errors.

lBuildNewGUIDs

Specifies whether to generate new registry globally unique identifiers (GUIDs) when creating an .exe or .dll file.

NoteNote

If nBuildAction is less than 3, Visual FoxPro disregards lBuildNewGUIDs.

The following table describes values for lBuildNewGUIDs.

lShowErrors Description

True (.T.)

Generate new GUIDs.

False (.F.) or omitted

Do not generate new GUIDs.

Expand imageReturn Value

Expand imageRemarks

Expand imageSee Also


© , 1996-2020 • Updated: 11/10/20
Comment or report problem with topic