OpenOffice.org OpenOffice - 3.3 Guía de inicio rápido descargar pdf (Pagina 327)

dispatcher.executeDispatch(document, ".uno:InsertText", "", 0, args1())

end sub

The macro in Listing 4 is not as complicated as it first appears. Learning a few things

helps significantly in understanding the generated macros. The discussion starts with

features near the top of the macro listing and describes them. If you like to avoid

details, then simply change the text “Andrew Pitonyak” in the macro above to what

you want to insert at the current cursor position.

Comments start with REM

The keyword REM, short for remark, starts a macro comment. All text after REM (on

the same line) is ignored. As a short cut, the single quote character can also be used

to start a comment.

Tip

StarBasic is not case-sensitive for keywords, so REM, Rem, and rem all

start a comment. If you use symbolic constants defined by the API, it is

safer to assume that the names are case-sensitive—symbolic constants

are an advanced topic not usually needed by people that use the macro

recorder.

Defining subroutines with SUB

Individual macros are stored in subroutines defined with the keyword SUB. The end

of a subroutine is indicated by the words END SUB. The code starts by defining the

subroutine named Main, which is empty and does nothing. The next subroutine,

EnterMyName, contains the generated code.

Tip

OpenOffice.org always creates an empty subroutine named Main when

it creates a module.

There are advanced topics that are beyond the scope of this document, but knowing

about them might be of interest:

• You can write a macro so that values can be passed to the subroutine. The

values are called arguments. Recorded macros do not accept arguments.

• Another kind of subroutine is called a function. A function is a subroutine that

returns a value. The keyword FUNCTION is used rather than SUB to define a

function. Generated macros are always of type SUB.

Defining variables using DIM

You can write information on a piece of paper so that you can look at it later. A

variable, like a piece of paper, contains information that can be changed and read.

The DIM statement is similar to setting aside a piece of paper to be used to store a

message or note.

The EnterMyName macro defines the variables document and dispatcher as type

object. Other common variable types include string, integer, and date. A third

variable, named args1, is an array of property values. A variable of type array allows

a single variable to contain multiple values, similar to storing multiple pages in a

single book. Values in an array are usually numbered starting from zero. The number

in the parentheses indicates the highest usable number to access a storage location.

In this example, there is only one value, and it is numbered zero.

Chapter 13 Getting Started with Macros 327

1 2 ... 322 323 324 325 326 327 328 329 330 331 332 ... 378 379

Comentarios a estos manuales

Sin comentarios

OpenOffice.org OpenOffice - 3.3 Guía de inicio rápido Pagina 327

Comentarios a estos manuales

Relacionado con productos y manuales para Software De Gráficos OpenOffice.org OpenOffice - 3.3