OpenOffice.org OpenOffice - 3.0 Quick Start Guide download pdf (Page 371)

dispatcher = createUnoService("com.sun.star.frame.DispatchHelper")

rem -------------------------------------------------------------

dim args1(0) as new com.sun.star.beans.PropertyValue

args1(0).Name = "Text"

args1(0).Value = "Andrew Pitonyak"

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

end sub

The macro in Listing 1 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” 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 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.

Chapter 13 Getting Started with Macros 371

1 2 ... 366 367 368 369 370 371 372 373 374 375 376 ... 432 433

No comments

OpenOffice.org OpenOffice - 3.0 Quick Start Guide Page 371