api: Content

API@OOo: NEWSLETTER January/2004

Dear OOo community,

This is the January issue of the API@OOo NEWSLETTER.  At the 1st of each 
month, I am summarizing what was going on in the previous month within 
the OOo API project and the OOo SDK.  


*** ====================================================================
*** OOo API and OOo SDK Highlights this Month
*** --------------------------------------------------------------------

	- #01: Multiple-Inheritance Interface Types
	- #02: How to insert a Field usable in the mailmerge function.
	- #03: Casting Versus UnoRuntime.queryInterface
	- #04: Opportunities to Contribute to OOo
	- #05: What do do in Listeners and What Not do in Listeners
	- #06: Preventing OpenOffice.org GUI Dialogs from Popping up
	- #07: No TLB Files needed for OLE-Automation Binding 
	- #08: StarOffice7 Basic Programmers Guide in 10 Languages
	- #09: Retrieving a TextField in the Current Paragraph
	- #10: CodeSnipped: Merging Subsequent Cells with Equal Values
	- #11: Correction of CodeSnippet Template
	- #12: Closing Office Documents
	- #13: Security Within Macros
	- #14: How to Make Another Document the Current Document?
	- #15: Worm-Attack


*** ====================================================================
*** #01: Multiple-Inheritance Interface Types
*** --------------------------------------------------------------------

Stephan Bergmann announced [1] the integration of multiple inheritance
for interfaces.  The documentation [2] is also extended.

1:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1029640
2:http://udk.openoffice.org/common/man/draft/multinherit.html


*** ====================================================================
*** #02: How to insert a Field usable in the mailmerge function.
*** --------------------------------------------------------------------

Stephan Wunderlich posted [1] some Java code to programmatically insert 
a field which can be used for mail merge into a text document.

1:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1019204


*** ====================================================================
*** #03: Casting Versus UnoRuntime.queryInterface
*** --------------------------------------------------------------------

Stephan Bergmann explained [1] the differences of casting versus
the use of UnoRuntime.queryInterface in the Java language binding.

1:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1021012


*** ====================================================================
*** #04: Opportunities to Contribute to OOo
*** --------------------------------------------------------------------

C. P. Hennessy posted [1] a list of opportunities to contribute to OOo.

1:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1021766


*** ====================================================================
*** #05: What do do in Listeners and What Not do in Listeners
*** --------------------------------------------------------------------

Andreas Schluens explained [1] which action must be avoided in
implementations of Listeners if you don't want to run into serious
runtime problems.

1:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1023683


*** ====================================================================
*** #06: Preventing OpenOffice.org GUI Dialogs from Popping up
*** --------------------------------------------------------------------

Mathias Bauer explained [1] what to do when OOo pops uo dialogs pop on
an API call which are not expected.  He also states that using -headless
is a hack and he mentioned its drawbacks.

1:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1024455


*** ====================================================================
*** #07: No TLB Files needed for OLE-Automation Binding 
*** --------------------------------------------------------------------

Mathias Bauer stated that there are no TLB files for our OLE binding 
because we only support OLE-Automation (IDispatch).

1:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1024825


*** ====================================================================
*** #08: StarOffice7 Basic Programmers Guide in 10 Languages
*** --------------------------------------------------------------------

Juergen Schmidt announced [1] updates to our web page with external
references [2], including StarOffice7 Basic Programmers Guide in 
ten languages.

1:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1025741
2:http://api.openoffice.org/TipsAndTricks/external.html


*** ====================================================================
*** #09: Retrieving a TextField in the Current Paragraph
*** --------------------------------------------------------------------

Andrew Pitonyak posted [1] some BASIC code to retrieve a TextField from 
the current paragraph.

1:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1028670


*** ====================================================================
*** #10: CodeSnipped: Merging Subsequent Cells with Equal Values
*** --------------------------------------------------------------------

Michael Hoennig presented [1] a CodeSnippet [2] for spreadsheet documents
to merge subsequent cells with equal values.

1:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1028608
2:http://api.openoffice.org/source/browse/api/www/Examples/Snippets/Calc/Calc.CellMerger.snip


*** ====================================================================
*** #11: Correction of CodeSnippet Template
*** --------------------------------------------------------------------

Thomas Schindl pointed out [1] that two subsequent dashes ("--") are not
allowed in XML comments.  Therefore Michael Hoennig announced [2] a
correction of the template [3] and Paolo Mantovani an update [4] of his
CodeSnippet creator.

1:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1035315
2:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1035464
3:http://api.openoffice.org/SDK/snippets/index.html
4:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1035959


*** ====================================================================
*** #12: Closing Office Documents
*** --------------------------------------------------------------------

Mathias Bauer [1] and Stephan Wunderlich [2] explained why sometimes
neither XCloseable::close() nor XComponent::dispose() works to close
a document and what can be done about it.

1:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1031799
2:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1031906


*** ====================================================================
*** #13: Security Within Macros
*** --------------------------------------------------------------------

Christian Andersson started [1] an interesting discussion about security
issues in OOo macros.  Please also read the answers in this thread.

1:http://udk.openoffice.org/servlets/ReadMsg?list=dev&msgId=1023585


*** ====================================================================
*** #14: How to Make Another Document the Current Document?
*** --------------------------------------------------------------------

Mathias Bauer [1] and Paolo Mantovani [2] explained how to activate a
certain document to make it the current document at the user interface.

1:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1038999
2:http://api.openoffice.org/servlets/ReadMsg?list=dev&msgId=1038999


*** ====================================================================
*** #15: Worm-Attack
*** --------------------------------------------------------------------

Due to a worm attack with about 2 mails per minute going into group
moderation, the openoffice.org project mailing lists did not accept any
mails for the last few days of January.  


*** ====================================================================
*** About this NEWSLETTER
*** --------------------------------------------------------------------

The archive of this newsletter can be found on our website:
	http://api.openoffice.org/NewsLetter/

If you think this newsletter is useful and you would like to take over
responsibility for the API@OOo NEWSLETTER, just drop us a hint.  Or if
you just have something interesting for the next API@OOo NEWSLETTER,
mail your article to mi@openoffice.org.  The community ill appreciate
your contribution.

        Michael
The free and open productivity suite

API@OOo: NEWSLETTER January/2004
