Sancho: 1 revision

2012-03-30T09:00:25Z

1 revision

Sancho: Correct link fa:FA/Documentation/BASIC_Guide

2011-03-12T08:39:19Z

Correct link fa:FA/Documentation/BASIC_Guide

New page

{{Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=none
|NextPage=Documentation/BASIC Guide/Language
}}
{{DISPLAYTITLE:{{OOo}} BASIC Programming Guide}}
__NOTOC__
{{Download_Collection|MediaWiki:Collections/BASIC_Guide}}

This guide provides an introduction to programming with {{OOo}} Basic. To get the most out of this book, you should be familiar with other programming languages. Extensive examples are provided to help you quickly develop your own {{OOo}} Basic programs.

{{Documentation/Tip|{{OOo}} offers a complete user interface for developing programs in Basic. It is described in the chapter [[Documentation/DevGuide/Basic/OpenOffice.org_Basic|{{OOo}} Basic]] of the Developer's Guide. Before attempting to write macros you should read [[Documentation/DevGuide/Basic/First_Steps_with_OpenOffice.org_Basic|First Steps with OpenOffice.org Basic]] and the pages on [[Documentation/DevGuide/Basic/OpenOffice.org_Basic_IDE|OpenOffice.org Basic IDE]]. Since other pages of the Developer's Guide on Basic are technical details for experienced Basic programmers, you should then read this Basic Programming Guide.}}

This guide divides information about {{OOo}} administration into several chapters. The first three chapters introduce you to {{OOo}} Basic:

* [[Documentation/BASIC Guide/Language|The Language of {{OOo}} Basic]]
* [[Documentation/BASIC Guide/Runtime_Library|Runtime Library]]
* [[Documentation/BASIC Guide/API_Intro|Introduction to the API]]

These chapters provide an overview of {{OOo}} Basic and should be read by anyone who intends to write {{OOo}} Basic programs. The remaining chapters describe the individual components of the {{OOo}} API in more detail and can be read selectively as required:

* [[Documentation/BASIC Guide/Documents|Working with Documents]]
* [[Documentation/BASIC Guide/Text Documents|Text Documents]]
* [[Documentation/BASIC Guide/Spreadsheets|Spreadsheet Documents]]
* [[Documentation/BASIC Guide/Drawings Presentations|Drawings and Presentations]]
* [[Documentation/BASIC Guide/Charts|Charts (Diagrams)]]
* [[Documentation/BASIC Guide/Database|Databases]]
* [[Documentation/BASIC Guide/Dialogs|Dialogs]]
* [[Documentation/BASIC Guide/Forms|Forms]]

==About {{OOo}} Basic==

The {{OOo}} Basic programming language has been developed especially for {{OOo}} and is firmly integrated in the Office package.

As the name suggests, {{OOo}} Basic is a programming language from the Basic family. Anyone who has previously worked with other Basic languages — in particular with Visual Basic or Visual Basic for Applications (VBA) from Microsoft — will quickly become accustomed to {{OOo}} Basic. Large sections of the basic constructs of {{OOo}} Basic are compatible with Visual Basic.

The {{OOo}} Basic programming language can be divided into four components:

* The language of {{OOo}} Basic: Defines the elementary linguistic constructs, for example, for variable declarations, loops, and functions.
* The runtime library: Provides standard functions which have no direct reference to {{OOo}}, for example, functions for editing numbers, strings, date values, and files.
* The {{OOo}} API (Application Programming Interface): Permits access to {{OOo}} documents and allows these to be created, saved, modified, and printed.
* The Dialog Editor: Creates personal dialog windows and provides scope for the adding of control elements and event handlers.

{{Documentation/VBAnote|Compatibility between {{OOo}} Basic and VBA relates to the {{OOo}} Basic language as well as the runtime library. The {{OOo}} API and the Dialog Editor are not compatible with VBA (standardizing these interfaces would have made many of the concepts provided in {{OOo}} impossible).}}

==Intended Users of {{OOo}} Basic==

The scope of application for {{OOo}} Basic begins where the standard functions of {{OOo}} end. Routine tasks can therefore be automated in {{OOo}} Basic, links can be made to other programs — for example to a database server — and complex activities can be performed at the press of a button by using predefined scripts.

{{OOo}} Basic offers complete access to all {{OOo}} functions, supports all functions, modifies document types, and provides options for creating personal dialog windows.

==Use of {{OOo}} Basic==

{{OOo}} Basic can be used by any {{OOo}} user without any additional programs or aids. Even in the standard installation, {{OOo}} Basic has all the components needed to create its own Basic macros, including:

* The integrated development environment (IDE) which provides an editor for creating and testing macros.
* The interpreter, which is needed to run {{OOo}} Basic macros.
* The interfaces to various {{OOo}} applications, which allow for direct access to Office documents.

==More Information==

The components of the {{OOo}} API that are discussed in this guide were selected based on their practical benefits for the {{OOo}} Basic programmer. In general, only parts of the interfaces are discussed. For a more detailed picture, see [http://api.openoffice.org/docs/common/ref/com/sun/star/module-ix.html the API reference].

The [[Documentation/DevGuide/OpenOffice.org_Developers_Guide|Developer's Guide]] describes the {{OOo}} API in more detail than this guide, but is primarily intended for Java and C++ programmers. Anyone who is already familiar with {{OOo}} Basic programming can find additional information in the Developer's Guide on {{OOo}} Basic and {{OOo}} programming.

Programmers who want to work directly with Java or C++ rather than {{OOo}} Basic should consult the {{OOo}} Developer's Guide instead of this guide. {{OOo}} programming with Java or C++ is a considerably more complex process than programming with {{OOo}} Basic.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide}}
{{PDL1}}
[[fa:FA/Documentation/BASIC_Guide]]

← Older revision	Revision as of 09:00, 30 March 2012
(No difference)

Documentation/BASIC Guide - Revision history

Sancho: 1 revision

Sancho: Correct link fa:FA/Documentation/BASIC_Guide