Apache OpenOffice Wiki - User contributions [en]

AODL

2008-05-07T19:11:14Z

LarsBehr:

'''AODL (An Open Document Library)'''

== Summary ==
AODL is the .net module of the [[ODF_Toolkit|ODF Toolkit]]. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
 
== Main Features ==
Until now, the following fundamental operations are supported by AODL: 

<ul>
<li>Creating new documents in the text and the spreadsheet format.</li>
<li>Loading and manipulating documents in the text and spreadsheet (not complete yet) format.</li>
<li>Initial support for Charts within Spreadsheet Documents.</li>
<li>Export loaded or created documents into the HTML format (text and spreadsheet documents).</li>
<li>Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)</li>
</ul>
 
== ODF implemented Features ==
<ul>
<li> Reading, editing, creating and saving documents in the OpenDocument text format (TextDocument class).</li>
<li> Reading, editing, creating and saving documents in the OpenDocument spreadsheet format (SpreadsheetDocument class).</li>
<li> ParagraphBuilder class, this class offer several methods for the creation of often used Paragraphs types.</li>
<li> TableBuilder class, this class offer several methods for the creation of often used Table types.</li>
<li> TextBuilder class, this class offer several methods for the simple creation of ITextCollections that will be used within a Paragraph.</li>
<li> SizeConverter class, this class offer size conversation and size type conversation methods for height and width properties of AODL OpenDocument objects.</li>
<li> Colors class, this class offer the possibility to convert any .net system color to the corresponding color used in any document in the OpenDocument format.</li>
<li> Support for common styles. These are e.g used by OpenOffice as style templates.</li>
<li> Reading and writing of the documents metadata.</li>
<li> Full Paragraph support incl. Paragraphstyle and Paragraphproperties.</li>
<li> Full Header support incl. Headerstyle and Proeperties.</li>
<li> List support (number and bullet) support incl. Liststyle and Listproperties.</li>
<li> Full Table of Contents support incl. Sectionstyles.</li>
<li> Full Table support with nested table up to any depth and cellmerging support.</li>
- Full support for Rows incl. Rowstyle and Rowproperties.
- Full support for Columns incl. Columnstyle and Columnproperties.
- Full support for Cells incl. Cellstyle and Cellproperties.
<li> Text support incl. Textstyle and textproperties. ........... 
Take a look at this [[AODL features|page]] to see a complete list of existing features.  
</li>
</ul>
== FAQ ==
The AODL [[AODL FAQ|FAQ]] (where to get the source, requirements, ..) 
== Source Code and Download ==
<ul>
<li>[http://odftoolkit.openoffice.org/servlets/ProjectDocumentList?folderID=679&expandFolder=679&folderID=0 Download] of the binary releases.</li>
<li>[http://odftoolkit.openoffice.org/source/browse/odftoolkit/ CVS checkout] of the current AODL source code.</li>
</ul>
== Code Snippets and Examples==
Here you will find several AODL code [[AODL examples|examples / snippets]]. Larger examples in form of Sample Applications a part of the source code.  
== Further Information ==
The [[ODF_Toolkit|ODF Toolkit Wiki page]]. 
The ODF Toolkit [http://odftoolkit.openoffice.org project homepage] on the OpenOffice.org website.
A [[AODL wishlist|Wish List]] for additional features and enhancements. 
[[category:Summer of Code 2007]][[category:AODL]]

AODL

2008-05-07T18:13:40Z

LarsBehr:

'''AODL (An Open Document Library)'''

== Summary ==
AODL is the .net module of the [[ODF_Toolkit|ODF Toolkit]]. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
 
== Main Features ==
Until now, the following fundamental operations are supported by AODL: 

<ul>
<li>Creating new documents in the text and the spreadsheet format.</li>
<li>Loading and manipulating documents in the text and spreadsheet (not complete yet) format.</li>
<li>Initial support for Charts within Spreadsheet Documents.</li>
<li>Export loaded or created documents into the HTML format (text and spreadsheet documents).</li>
<li>Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)</li>
</ul>
 
== ODF implemented Features ==
<ul>
<li> Reading, editing, creating and saving documents in the OpenDocument text format (TextDocument class).</li>
<li> Reading, editing, creating and saving documents in the OpenDocument spreadsheet format (SpreadsheetDocument class).</li>
<li> ParagraphBuilder class, this class offer several methods for the creation of often used Paragraphs types.</li>
<li> TableBuilder class, this class offer several methods for the creation of often used Table types.</li>
<li> TextBuilder class, this class offer several methods for the simple creation of ITextCollections that will be used within a Paragraph.</li>
<li> SizeConverter class, this class offer size conversation and size type conversation methods for height and width properties of AODL OpenDocument objects.</li>
<li> Colors class, this class offer the possibility to convert any .net system color to the corresponding color used in any document in the OpenDocument format.</li>
<li> Support for common styles. These are e.g used by OpenOffice as style templates.</li>
<li> Reading and writing of the documents metadata.</li>
<li> Full Paragraph support incl. Paragraphstyle and Paragraphproperties.</li>
<li> Full Header support incl. Headerstyle and Proeperties.</li>
<li> List support (number and bullet) support incl. Liststyle and Listproperties.</li>
<li> Full Table of Contents support incl. Sectionstyles.</li>
<li> Full Table support with nested table up to any depth and cellmerging support.</li>
- Full support for Rows incl. Rowstyle and Rowproperties.
- Full support for Columns incl. Columnstyle and Columnproperties.
- Full support for Cells incl. Cellstyle and Cellproperties.
<li> Text support incl. Textstyle and textproperties. ........... 
Take a look at this [[AODL features|page]] to see a complete list of existing features. 
</li>
</ul>
== FAQ ==
The AODL [[AODL FAQ|FAQ]] (where to get the source, requirements, ..) 
== Source Code and Download ==
AODL code [[AODL examples|examples / snippets]] 
[http://odftoolkit.openoffice.org/servlets/ProjectDocumentList?folderID=679&expandFolder=679&folderID=0 Download] of the binary releases. 
[http://odftoolkit.openoffice.org/source/browse/odftoolkit/ CVS checkout] of the current AODL source code. 

== Further Information ==
The [[ODF_Toolkit|ODF Toolkit Wiki page]]. 
The ODF Toolkit [http://odftoolkit.openoffice.org project homepage] on the OpenOffice.org website.
A [[AODL wishlist|Wish List]] for additional features and enhancements. 
[[category:Summer of Code 2007]][[category:AODL]]

AODL

2008-05-07T18:02:16Z

LarsBehr:

'''AODL (An Open Document Library)'''

AODL is the .net module of the [[ODF_Toolkit|ODF Toolkit]]. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
 
Until now, the following fundamental operations are supported by AODL: 

<ul>
<li>Creating new documents in the text and the spreadsheet format.</li>
<li>Loading and manipulating documents in the text and spreadsheet (not complete yet) format.</li>
<li>Initial support for Charts within Spreadsheet Documents.</li>
<li>Export loaded or created documents into the HTML format (text and spreadsheet documents).</li>
<li>Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)</li>
</ul>
 
'''Further information:'''
Take a look at this [[AODL features|page]] to see a complete list of existing features. 
The AODL [[AODL FAQ|FAQ]] (where to get the source, requirements, ..) 
A [[AODL wishlist|Wish List]] for additional features and enhancements. 
AODL code [[AODL examples|examples / snippets]] 
[http://odftoolkit.openoffice.org/servlets/ProjectDocumentList?folderID=679&expandFolder=679&folderID=0 Download] of the binary releases. 
[http://odftoolkit.openoffice.org/source/browse/odftoolkit/ CVS checkout] of the current AODL source code. 
The [[ODF_Toolkit|ODF Toolkit Wiki page]]. 
The ODF Toolkit [http://odftoolkit.openoffice.org project homepage] on the OpenOffice.org website.

[[category:Summer of Code 2007]][[category:AODL]]

ODF Toolkit

2007-08-17T11:08:51Z

LarsBehr:

{|border=1
|+ Project responsibilities
| Project Lead || [[User:Dl|Dieter Loeschky]]
|-
| Co-Lead || [[User:Mib|Michael Brauer]], [[User:Jsc|Jürgen Schmidt]]
|}

The [[Wikipedia:ODF|ODF]] Toolkit Wiki is an extensions to the [http://odftoolkit.openoffice.org odftoolkit.openoffice.org] project. The wiki is the place for more dynamic content and the place for collaboration work.

==Requirements==
The intention of the requirements section is to collect the different requirements for an ODF Toolkit. We expect that especially requirements will be described in more detail and that is the reason why we prefer a separate entry for each requirement. Please follow our recommendation and put new requirements under ODF_Toolkit/Requirements/<new_requirement>. The requirements are collected automatically. Please tag the requirement accordingly, use at least the categories '''ODFToolkit''' and '''Requirement'''.

<DPL>category=ODFToolkit
category=Requirement</DPL> <noinclude>[[Category:ODFToolkit]]</noinclude>

==Things in progress - Efforts==
In this section you can find a list of activities which are currently ongoing. The effort list is collected automatically. Please follow our recommendation and put new efforts under ODF_Toolkit/Efforts/<new_effort> and tag the it accordingly, use at least the categories '''ODFToolkit''' and '''Effort'''.

<DPL>category=ODFToolkit
category=Effort</DPL> <noinclude>[[Category:ODFToolkit]]</noinclude>

==ODF Toolkit Modules==
.net module AODL - A library for working with the OpenDocument format in C#, VisualBasic.net, ... [[AODL|AODL Wiki page]].
 
Java module odf4j - Odf4j is a (pure) Java class-library providing ODF processing capabilities for applications based on the Java platform. [[Odf4j|odf4j Wiki page]].
 

==Meeting Minutes==

There is a weekly ODF Toolkit Meeting:

<DPL>category=ODFToolkit
category=Minutes</DPL> <noinclude>[[Category:ODFToolkit]]</noinclude>

==[[ODF_Toolkit/FAQ|FAQ]]==
A list of frequently asked questions related to the [http://odftoolkit.openoffice.org ODF Toolkit].

==[[ODF_Toolkit/External_Resources|External Resources]]==
ODF becomes more and more popular and you here can find more interesting external stuff related to ODF, ODF manipulation, ODF tools ...

[[Category:Project]]
[[Category:ODFToolkit]]
[[Category:API]]
[[Category:Development]]

AODL

2007-08-17T09:07:23Z

LarsBehr:

'''AODL (An Open Document Library)'''

AODL is the .net module of the [[ODF_Toolkit|ODF Toolkit]]. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
 
Up to now, the following fundamental operations are supported by AODL: 

<ul>
<li>Creating new documents in the text and the spreadsheet format.</li>
<li>Loading and manipulating documents in the text and spreadsheet (not complete yet) format.</li>
<li>Export loaded or created documents into the HTML format (text and spreadsheet documents).</li>
<li>Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)</li>
</ul>
 
'''Further information:'''
Take a look at this [[AODL features|page]] to see a complete list of existing features. 
The AODL [[AODL FAQ|FAQ]] (where to get the source, requirements, ..) 
A [[AODL wishlist|Wish List]] for additional features and enhancements. 
AODL code [[AODL examples|examples / snippets]] 
[http://odftoolkit.openoffice.org/servlets/ProjectDocumentList?folderID=679&expandFolder=679&folderID=0 Download] of the binary releases. 
[http://odftoolkit.openoffice.org/source/browse/odftoolkit/ CVS checkout] of the current AODL source code. 
The [[ODF_Toolkit|ODF Toolkit Wiki page]]. 
The ODF Toolkit [http://odftoolkit.openoffice.org project homepage] on the OpenOffice.org website.

[[category:Summer of Code 2007]][[category:AODL]]

AODL features

2007-08-17T08:59:27Z

LarsBehr:

'''AODL features list'''

<ul>
<li> Reading, editing, creating and saving documents in the OpenDocument text format (TextDocument class).</li>
<li> Reading, editing, creating and saving documents in the OpenDocument spreadsheet format (SpreadsheetDocument class).</li>
<li> ParagraphBuilder class, this class offer several methods for the creation of often used Paragraphs types.</li>
<li> TableBuilder class, this class offer several methods for the creation of often used Table types.</li>
<li> TextBuilder class, this class offer several methods for the simple creation of ITextCollections that will be used within a Paragraph.</li>
<li> SizeConverter class, this class offer size conversation and size type conversation methods for height and width properties of AODL OpenDocument objects.</li>
<li> Colors class, this class offer the possibility to convert any .net system color to the corresponding color used in any document in the OpenDocument format.</li>
<li> Support for common styles. These are e.g used by OpenOffice as style templates.</li>
<li> Reading and writing of the documents metadata.</li>
<li> Full Paragraph support incl. Paragraphstyle and Paragraphproperties.</li>
<li> Full Header support incl. Headerstyle and Proeperties.</li>
<li> List support (number and bullet) support incl. Liststyle and Listproperties.</li>
<li> Full Table of Contents support incl. Sectionstyles.</li>
<li> Full Table support with nested table up to any depth and cellmerging support.</li>
- Full support for Rows incl. Rowstyle and Rowproperties.
- Full support for Columns incl. Columnstyle and Columnproperties.
- Full support for Cells incl. Cellstyle and Cellproperties.
<li> Text support incl. Textstyle and textproperties.</li>
- Simple Text
- Formated text
- Footnotes and Endnotes
<li> Textcontrol Whitespaces, Tabstops and Linebreaks.</li>
<li> XLink support (Hyperlinks for www, email, ftp,.. ).</li>
<li> Full Bookmark support (Standard, End and Start).</li>
<li> Graphic support, graphics could be used as simple embed graphic or as a Illustration with a sorounding DrawTextBox.</li>
<li> Drawframe support. The draw frame is the standard container object for draw objects and graphics. Incl. Graphicstyle and Graphicproperties.</li>
<li> Imagemap support with DrawAreaRectangle and DrawAreaCircle.</li>
<li> DrawTextBox support.</li>
<li> Officescripts support. Office scripts could be used within a image map.</li>
<li> Deep cloning of AODL content objects. Deep clones from most of the IContent implementations like Tables, Paragraphs could be simply created by calling the clone method.</li>
<li> The Unknown content pattern. The unknown content implementation is available for Styles, Content and Text. All content that will be read from a OpenDocument file which isn't implemented yet will be mapped to a UnknownContent, UnknownTextContent resp. a UknownStyle object. All these implementation has a public property Node which made it easy to analyze the OpenDocument format inside. At least this solution make it possible to load and write files back without loosing any style or content information.</li>
<li> OpenDocument Importer interface. This interface let you easily writing your own importer implementations. Existing standard implementation of IImporter</li>
- PlainTextImporter (TextDocument only)
- CsvImporter (SpreadsheetDocument only)
- OpenDocumentImporter all document types.
<li> OpenDocument Exporter interface. This interface let you easily writing your own exporter implementations. Existing standard implementation of IExporter</li>
- OpenDocumentExporter all document types.
- HtmlExporter all document types.
- PDF export for text documents (early beta and TextDocument only)
<li> Helper class LinesStyles (possible Linestyles), Border (possible Border) and FontFamilies (about 100 fonts).</li>
<li> Print documents via the included OpenOfficeLib (This is feature is embed in seperate dll and is the only feature which need an existing OpenOffice installation.)</li>
<li> Master style pages support</li>
<li> Office forms support</li>
<li> Fields support</li>
</ul>
[[category:Summer of Code 2007]][[category:AODL]]

ODF Toolkit/Minutes/2007 06

2007-06-01T14:51:19Z

LarsBehr:

There is a weekly ODF Toolkit Meeting. Minutes are gathered for one month per Wiki page, latest first.

= 2007/06/01 =

15:00–16:00 CEST

== Attendees ==

* Juergen Schmidt (JSC)
* Malte Timmermann (MT)
* <strike>Michael Brauer (MIB)</strike>
* Stephan Bergmann (SB)
* Dieter Loeschky (DL)
* <strike>Lars Oppermann (LO)</strike>
* Bernd Eilers (BEI)
* Lars Behrmann (LB)
''Associates:''
* <strike>Kay Ramme (KR)</strike>
* Kai Sommerfeld (KSO)
* <strike>Matthias Hütsch (MHU)</strike>

''Minute Taker:'' LB (Next: MT, SB, DL, BEI, MIB, JSC)

== Action Items ==

* no action items

New action items:

* no new action items

== Topics ==

* DL: short review of the todays IRC meeting with the redflag developers.

* BEI: continuous progress in the odf4j implementation. New developers from redflag joined the odf4j project.

* JSC: ongoing work on a UNO based ODF toolkit API.

* LB: GSOC: Oleg added new parts of the forms implementation. Two new developer from redflag joined the AODL project and will work on the chart implementation.

* SB: ongoing work on the separation of URE / Office.

* MT: ongoing work on the OOo modularization.

[[Category:ODFToolkit]]
[[Category:Minutes]]

ODF Toolkit/Minutes/2007 06

2007-06-01T14:46:43Z

LarsBehr:

.net Module AODL: Forms and Fields implementation

2007-04-20T11:03:25Z

LarsBehr:

This is the wiki page for the Google [[Summer_of_Code_2007]] proposal by Oleg Yegorov and mentored by Dieter Löschky and Lars Behrmann.

== Proposal ==
TODO: Write Proposal.

== Current Status ==
TODO: Write current status.

TODO: Insert link to students blog.

== Student Task List ==
* Subscribe to ODF Toolkit mailing list. Done.
* Submit a filled-out copy of the Joint Copyright Assignment form (JCA). Done.
* Workout initial implementation details. Done
* Create a detailed project proposal. In progress

==Further information about the ODF Toolkit==
AODL code [[AODL|AODL Wiki page]] 
The [[ODF_Toolkit|ODF Toolkit Wiki page]]. 
The ODF Toolkit [http://odftoolkit.openoffice.org project homepage] on the OpenOffice.org website.

Summer of Code 2007

2007-04-20T10:49:17Z

LarsBehr:

Similar to [[SummerOfCode2006|last year]], OpenOffice.org is participating in the [http://code.google.com/soc/ Google Summer of Code](tm) initiative sponsored by Google.

This page lists the 10 tasks that have been accepted from the [[Summer_of_Code_2007/proposals|proposals]] for this year. Students work with their mentors
on the projects with a mid-term milestone in Juli until [http://code.google.com/support/bin/answer.py?answer=60325&topic=10729 August].

=Accepted Tasks=

==Calc==

===Integration of R into Calc===

Create an add-on component that allows a Calc user to let the [http://www.r-project.org/ R environment] do calculations on data from Calc cells and put the results into the spreadsheet again.

This should include a dialog to select input parameters and options, and allow results to be values or graph images. Note that the incompatible licenses (R is under GPL) have to be taken care of, possibly by starting R as a separate process.

Some more thoughts on the subject have been collected at [[Statistical Data Analysis Tool#Third Party Library Integration]].

* Required skills/knowledge: Some familiarity with statistical methods

; Contact
: dev@sc.openoffice.org
: Niklas.Nebel at sun.com

: Leonard Mada
: (on statistics and R syntax)
: discoleo at openoffice.org

; More Information
: Check [http://www.11-55.org/ooblog/ Wojciech's blog] for regular updates.

==Framework==

===Status bar control to display/change the language===

Currently the Writer lacks means to display the language in use. There's also no easy way to change the language as the user has to use the menu. A status bar control would help to solve these problems. It should help to determine about the language used at the cursor position or the document. The control should be implemented using existing UNO APIs.

* Required skills/knowledge: C++
* Useful skills: Basic UNO API knowledge

; Contact
: dev@framework.openoffice.org,
: Carsten.Driesner at sun.com
: Thomas.Lange at sun.com

; Mentor
: Carsten Driesner
: Thomas Lange

; Student
: Lili Sun [http://lsun2.blogspot.com/ coding blog]

==Graphics==

===Draw/Impress: SVG Import Filter===

[http://www.w3.org/Graphics/SVG/ SVG (Scalable Vector Graphics)] is a vector graphics format that describes 2D graphics in XML.

There's no native SVG import filter for OOo. There exists an [http://www.ipd.uka.de/~hauma/svg-import/ external one], but unfortunately it has very strong dependencies - [http://java.sun.com/javase/downloads/index.jsp Java 5.0], and [http://xmlgraphics.apache.org/batik/ Batik]. The goal of this task is to create a new implementation that does not require any too big libraries.

A proof of concept implementation written in C++ using the [http://wiki.services.openoffice.org/wiki/Uno UNO] [http://api.openoffice.org/docs/common/ref/com/sun/star/drawing/module-ix.html Drawing API] and a lighweight [http://cairographics.org/libsvg libsvg library] exists [http://svn.gnome.org/viewcvs/ooo-build/trunk/patches/src680/svg-import.diff here], but it needs a lot of work to be really usable. Another problem is that libsvg does not seem to be too actively maintained; so the real implementation should use OOo's [http://wiki.services.openoffice.org/wiki/FastParser internal XML parser].

More information is available in [http://artax.karlin.mff.cuni.cz/~kendy/blog/archives/monthly/2006-10.html#2006-10-02T17_14_44.htm Kendy's blog].

* Required skills/knowledge: C++, XML knowledge is a plus

; Contact
: Jan Holesovsky - kendy at openoffice org
: Fridrich Strba - fridrich_strba at openoffice org

===[[Impress: OpenGL rendered transitions]]===
The goal is to add 3D transitions to the Impress application. Transition is an animation where one page is visible in the beginning and another in the end. It is used during presentation slideshow to switch pages.

In the process of implementing OpenGL transitions an UNO API should be added to slideshow code, so that OpenGL transitions engine might be created as standalone UNO component. Current transitions should be refactored to another UNO component.

The engine will get the previous and next pages and should render the transition at given speed.

The participant should also implement at least 5 OpenGL transitions, rendered by the UNO component.

* Reguired skills/knowledge: C++, OpenGL. familiarity with UNO is welcomed

;Contact:
:mailto:dev@graphics.openoffice.org
:Thorsten Behrens - thb at openoffice org
:Radek Doulik - radekdoulik at openoffice org

==ODF Toolkit==

===[[.net Module AODL: Forms and Fields implementation]]===
=== Tools and best practice samples for ODF creation and manipulation===

We already have some code snippets in Java and C# and looking for help to extend these tool sets or to provide tool sets in other languages. These tool sets are designed to offer basic ODF functionality even outside of OO.o.

* Required skills/knowledge: Java or C# or Perl or C++ ...
* Useful skills: ODF, XML

; Contact
: dev@odftoolkit.openoffice.org,
: Dieter Loeschky at sun.com
: Lars Behrmann at sun.com

==Framework==

===Improving UI editing / coupling===

Currently all dialogs (along with most translated strings) are stored in a rather unusual binary resource file format, that has not had much love in the last decade. We need to write some new code that separates the process of designing & laying out the UI from the code - to allow UE to make our UI more beautiful, and allow future re-factoring. The existing Basic GUI dialog editor and it's XML format should be re-used, a simple C++ compatibility API created, and a number of dialogs converted to the new format.

* Required skills/knowledge: C++
* Useful skills: courage, stickability, X-rated code reading

; Contact
: michael.meeks at novell.com
: hfiguiere at novell.com

==Porting==

===[[MacOSX: Complete User Interface respecting Aqua Human Interface Guidelines]]===

*Concerns: OpenOffice.org 2.x for Mac OS X Aqua only

*Skills: Knowledge of languages C/C++ Mac OS X APIs and Application frameworks like Carbon

Original OpenOffice.org vcl widgets are not Aqua HIG compliant, and we need to implement all controls, respecting Aqua Human Interface Guidelines, some will use HIView, or HITheme or even other part of Carbon API.

*Tasks: some controls are already implemented, but some are still missing.

The job consists in write the code and implement:

- tabs (implement and bind the TabitemValue class, using Carbon API)

- spinbuttons (implement and bind SpinbuttonValue class, using Carbon API)

- comboboxes (implement and use HICombobox)

- listboxes (work already started)

- texts in comboboxes / listboxes (better task definition to be completed)

- other types of controls: highlight, respect dimensions/spacing ..etc

- Windows background (using Aqua theme)

;Proposed by: Eric Bachard
;Contact: mac@porting.openoffice.org
;Mentor: Eric Bachard ( ericb at openoffice dot org )

=== [[MacOSX: Address book integration]] ===

Synopsis: OOo currently is integrated with the Mozilla address book but not with the native Mac OS X address book. This is annoying for Mac OS X user. For better system integration it would be desirable to integrate with the Mac OS X address book.

Concerns: OpenOffice.org 2.x for Mac OS X (both Aqua and X11 versions)

;Skills: Knowledge of languages C/C++, Mac OS X APIs and Application frameworks like Carbon or Cocoa for instance, knowledge of the Mac OS X address book APIs

;Tasks:

Familiarize with the Mac OS X address book APIs

Familiarize with the current OOo Mozilla address book integration

Make a prototype for OOo Mac OS X address book integration

Document all produced code and aspects, Extend the principles to support docuemnt (text/media) Drag'n Drop.

;Contact
mac@porting.openoffice.org

;Mentor: Sebastien Plisson

== Writer ==

===Better "Notes" functionality: [[Notes2]]===

The "Notes" functionality in Writer could be better in terms of usability and does not look very appealing.

* Required skills/knowledge: C++

; Contact
: dev@sw.openoffice.org
: Mathias.Bauer at sun.com

; Resources
[http://blogs.linux.ie/caolan/2007/03/12/notesmarginnotes-in-sw/ hopefully helpful illustrative patch]

[[Notes2]] project wikipage

===RTF Generator===

The current RTF export of OpenOffice.org is not as good as the export to the Word (.doc) format. Parsing the generated Word format stream with a Word tokenizer and handing over the generated events to an RTF generator would lead to an RTF export filter with the same quality as the binary Word export filter. Remark: the tokenizer itself isn't complete today but in its current state covers enough parts of the Word format to make this a valuable project for the planned time span.

* Required skills/knowledge: C++, some knowledge about the Word file format would be a plus

; Contact
: dev@sw.openoffice.org
: Henning.Brinkmann at sun.com

AODL

2007-03-13T10:00:03Z

LarsBehr:

'''AODL (An Open Document Library)'''

AODL is the .net module of the [[ODF_Toolkit|ODF Toolkit]]. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
 
Up to now, the following fundamental operations are supported by AODL: 

<ul>
<li>Creating new documents in the text and the spreadsheet format.</li>
<li>Loading and manipulating documents in the text and spreadsheet (not complete yet) format.</li>
<li>Export loaded or created documents into the HTML format (text and spreadsheet documents).</li>
<li>Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)</li>
</ul>
 
'''Further information:'''
Take a look at this [[AODL features|page]] to see a complete list of existing features. 
The AODL [[AODL FAQ|FAQ]] (where to get the source, requirements, ..) 
AODL code [[AODL examples|examples / snippets]] 
The [[ODF_Toolkit|ODF Toolkit Wiki page]]. 
The ODF Toolkit [http://odftoolkit.openoffice.org project homepage] on the OpenOffice.org website.

AODL FAQ

2007-03-13T09:59:09Z

LarsBehr:

'''''Where can I checkout resp. download the source code or binaries?'''''
 
The source code of AODL is stored within the CVS repository of the ODF Toolkits.
On the following site you can browse the repository online
and will also get information about how to check out the source code.
[http://odftoolkit.openoffice.org/source/browse/odftoolkit/ ODF CVS Repository]
The source code as a downloadable file will follow within the next days and will be
available through the ODF Toolkits project homepage.
[http://odftoolkit.openoffice.org ODF Toolkit]


'''''Must be OpenOffice.org or parts of it installed for using AODL?'''''
 
There is no need of a installation. The whole document handling is implemented
inside AODL without dependicies on OpenOffice.org or it's API. 
The only case where OpenOffice.org has to be installed is when you plan to use
the small printer library which is available within AODL.


'''''Can AODL be used with mono under Linux?'''''
 
Yes, this is possible since there are no Microsoft specific dependicies.


'''''Which version of the .net framwork is required by AODL?'''''
 
AODL will need at minimum version 1.1 of the .net framework.


'''''Is it possible to compile AODL with the Microsoft Visual Studio 2005 C# Express Edition?'''''
 
Yes, you can simply import the existing Visual Studio project file and compile
the whole library. However, the original project file is for Microsoft Visual Studio 2003.


Back to the [[AODL]] Wiki page

ODF Toolkit

2007-03-13T09:54:12Z

LarsBehr:

{|border=1
|+ Project responsibilities
| Project Lead || [[User:Dl|Dieter Loeschky]]
|-
| Co-Lead || [[User:Mib|Michael Brauer]], [[User:Jsc|Jürgen Schmidt]]
|}

The [[Wikipedia:ODF|ODF]] Toolkit Wiki is an extensions to the [http://odftoolkit.openoffice.org odftoolkit.openoffice.org] project. The wiki is the place for more dynamic content and the place for collaboration work.

==Requirements==
The intention of the requirements section is to collect the different requirements for an ODF Toolkit. We expect that especially requirements will be described in more detail and that is the reason why we prefer a separate entry for each requirement. Please follow our recommendation and put new requirements under ODF_Toolkit/Requirements/<new_requirement>. The requirements are collected automatically. Please tag the requirement accordingly, use at least the categories '''ODFToolkit''' and '''Requirement'''.

<DPL>category=ODFToolkit
category=Requirement</DPL> <noinclude>[[Category:ODFToolkit]]</noinclude>

==Things in progress - Efforts==
In this section you can find a list of activities which are currently ongoing. The effort list is collected automatically. Please follow our recommendation and put new efforts under ODF_Toolkit/Efforts/<new_effort> and tag the it accordingly, use at least the categories '''ODFToolkit''' and '''Effort'''.

<DPL>category=ODFToolkit
category=Effort</DPL> <noinclude>[[Category:ODFToolkit]]</noinclude>

==ODF Toolkit Modules==
.net module AODL - a library for working with the OpenDocument format in C#, VisualBasic.net, ... [[AODL|AODL Wiki page]].
 

==[[ODF_Toolkit/FAQ|FAQ]]==
A list of frequently asked questions related to the [http://odftoolkit.openoffice.org ODF Toolkit].

[[Category:Project]]
[[Category:ODFToolkit]]
[[Category:API]]
[[Category:Development]]

ODF Toolkit

2007-03-13T09:53:18Z

LarsBehr:

{|border=1
|+ Project responsibilities
| Project Lead || [[User:Dl|Dieter Loeschky]]
|-
| Co-Lead || [[User:Mib|Michael Brauer]], [[User:Jsc|Jürgen Schmidt]]
|}

The [[Wikipedia:ODF|ODF]] Toolkit Wiki is an extensions to the [http://odftoolkit.openoffice.org odftoolkit.openoffice.org] project. The wiki is the place for more dynamic content and the place for collaboration work.

==Requirements==
The intention of the requirements section is to collect the different requirements for an ODF Toolkit. We expect that especially requirements will be described in more detail and that is the reason why we prefer a separate entry for each requirement. Please follow our recommendation and put new requirements under ODF_Toolkit/Requirements/<new_requirement>. The requirements are collected automatically. Please tag the requirement accordingly, use at least the categories '''ODFToolkit''' and '''Requirement'''.

<DPL>category=ODFToolkit
category=Requirement</DPL> <noinclude>[[Category:ODFToolkit]]</noinclude>

==Things in progress - Efforts==
In this section you can find a list of activities which are currently ongoing. The effort list is collected automatically. Please follow our recommendation and put new efforts under ODF_Toolkit/Efforts/<new_effort> and tag the it accordingly, use at least the categories '''ODFToolkit''' and '''Effort'''.

<DPL>category=ODFToolkit
category=Effort</DPL> <noinclude>[[Category:ODFToolkit]]</noinclude>

==ODF Toolkit Modules==
.net module AODL - a library for working with the OpenDocument format in C#, VisualBasic.net, ... [[AODL|AODL Wiki page]].

==[[ODF_Toolkit/FAQ|FAQ]]==
A list of frequently asked questions related to the [http://odftoolkit.openoffice.org ODF Toolkit].

[[Category:Project]]
[[Category:ODFToolkit]]
[[Category:API]]
[[Category:Development]]

ODF Toolkit

2007-03-13T09:52:59Z

LarsBehr:

{|border=1
|+ Project responsibilities
| Project Lead || [[User:Dl|Dieter Loeschky]]
|-
| Co-Lead || [[User:Mib|Michael Brauer]], [[User:Jsc|Jürgen Schmidt]]
|}

The [[Wikipedia:ODF|ODF]] Toolkit Wiki is an extensions to the [http://odftoolkit.openoffice.org odftoolkit.openoffice.org] project. The wiki is the place for more dynamic content and the place for collaboration work.

==Requirements==
The intention of the requirements section is to collect the different requirements for an ODF Toolkit. We expect that especially requirements will be described in more detail and that is the reason why we prefer a separate entry for each requirement. Please follow our recommendation and put new requirements under ODF_Toolkit/Requirements/<new_requirement>. The requirements are collected automatically. Please tag the requirement accordingly, use at least the categories '''ODFToolkit''' and '''Requirement'''.

<DPL>category=ODFToolkit
category=Requirement</DPL> <noinclude>[[Category:ODFToolkit]]</noinclude>

==Things in progress - Efforts==
In this section you can find a list of activities which are currently ongoing. The effort list is collected automatically. Please follow our recommendation and put new efforts under ODF_Toolkit/Efforts/<new_effort> and tag the it accordingly, use at least the categories '''ODFToolkit''' and '''Effort'''.

<DPL>category=ODFToolkit
category=Effort</DPL> <noinclude>[[Category:ODFToolkit]]</noinclude>

==ODF Toolkit modules==
.net module AODL - a library for working with the OpenDocument format in C#, VisualBasic.net, ... [[AODL|AODL Wiki page]].

==[[ODF_Toolkit/FAQ|FAQ]]==
A list of frequently asked questions related to the [http://odftoolkit.openoffice.org ODF Toolkit].

[[Category:Project]]
[[Category:ODFToolkit]]
[[Category:API]]
[[Category:Development]]

AODL

2007-03-05T06:43:27Z

LarsBehr:

'''AODL (An Open Document Library)'''

AODL is the .net module of the [[ODF_Toolkit|ODF Toolkit]]. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
 
Up to now, the following fundamental operations are supported by AODL: 

<ul>
<li>Creating new documents in the text and the spreadsheet format.</li>
<li>Loading and manipulating documents in the text and spreadsheet (not complete yet) format.</li>
<li>Export loaded or created documents into the HTML format (text and spreadsheet documents).</li>
<li>Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)</li>
</ul>
 
'''Further information:'''
Take a look at this [[AODL features|page]] to see a complete list of existing features. 
The AODL [[AODL FAQ|FAQ]] 
AODL code [[AODL examples|examples / snippets]] 
The [[ODF_Toolkit|ODF Toolkit Wiki page]]. 
The ODF Toolkit [http://odftoolkit.openoffice.org project homepage] on the OpenOffice.org website.

AODL

2007-03-05T06:42:19Z

LarsBehr:

'''AODL (An Open Document Library)'''

AODL is the .net module of the [[ODF_Toolkit|ODF Toolkit]]. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
 
Up to now, the following fundamental operations are supported by AODL: 

<ul>
<li>Creating new documents in the text and the spreadsheet format.</li>
<li>Loading and manipulating documents in the text and spreadsheet (not complete yet) format.</li>
<li>Export loaded or created documents into the HTML format (text and spreadsheet documents).</li>
<li>Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)</li>
</ul>
 
'''Further information:'''
Take a look at this [[AODL features|page]] to see a complete list of existing features. 
The AODL [[AODL FAQ|FAQ]] 
AODL code [[AODL examples|examples / snippets]] 
The [[ODF_Toolkit|ODF Toolkit Wiki page]]. 
The ODF Toolkit [http://odftoolkit.openoffice.org project homepage] at the OpenOffice.org website.

AODL features

2007-03-04T21:44:02Z

LarsBehr:

AODL

2007-03-04T20:42:46Z

LarsBehr:

'''AODL (An Open Document Library)'''

AODL is the .net module of the [[ODF_Toolkit|ODF Toolkit]]. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
 
Up to now, the following fundamental operations are supported by AODL: 

<ul>
<li>Creating new documents in the text and the spreadsheet format.</li>
<li>Loading and manipulating documents in the text and spreadsheet (not complete yet) format.</li>
<li>Export loaded or created documents into the HTML format (text and spreadsheet documents).</li>
<li>Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)</li>
</ul>
 
'''Further information:'''
Take a look at this [[AODL features|page]] to see a nearly complete list of existing features. 
The AODL [[AODL FAQ|FAQ]] 
AODL code [[AODL examples|examples / snippets]] 
The [[ODF_Toolkit|ODF Toolkit Wiki page]]. 
The ODF Toolkit [http://odftoolkit.openoffice.org project homepage] at the OpenOffice.org website.

AODL example 17

2007-03-04T20:39:47Z

LarsBehr:

Create a new TextDocument and use the OpenOfficeLib to do a print out

This example NUnit test will show how to create a new OpenDocument text document by using AODL
and send it to a printer by using the new OpenOfficeLib.

Remarks: The OpenOfficeLib is an add on library for AODL. It's a simple wrapper for the CLI UNO assemblies
which are part of OpenOffice.org since vers. 1.9.x. In contrast to the AODL library the OpenOfficeLib will need an
existing OpenOffice.org installation in order to work!

<pre>
using System;
using NUnit.Framework;
using System.Xml;
using AODL.Document.Content.Tables;
using AODL.Document.TextDocuments;
using AODL.Document.Styles;
using AODL.Document.Content.Text;
using OpenOfficeLib.Connection;
using OpenOfficeLib.Document;
using OpenOfficeLib.Printer;
using unoidl.com.sun.star.lang;
using unoidl.com.sun.star.uno;
using unoidl.com.sun.star.bridge;
using unoidl.com.sun.star.frame;

namespace AODLTest
{
/// <summary>
/// OpenOfficeLibTests
/// </summary>
[TestFixture]
public class OpenOfficeLibTests
{
/// <summary>
/// Creates the new document and print it out.
/// </summary>
[Test (Description="Simple print test. OpenOffice.org installation and printer must exist."), Explicit]
public void CreateNewDocumentAndDoAPrintOut()
{
string fileToPrint = "fileToPrint.odt";

//Create a new text document
TextDocument document = new TextDocument();
document.New();
//Create a standard paragraph using the ParagraphBuilder
Paragraph paragraph = ParagraphBuilder.CreateStandardTextParagraph(document);
//Add some simple text
paragraph.TextContent.Add(new SimpleText(document, "Some simple text!"));
//Add the paragraph to the document
document.Content.Add(paragraph);
//Save empty
document.SaveTo(fileToPrint);

//Now print the new document via the OpenOfficeLib
//Get the Component Context
XComponentContext xComponentContext = Connector.GetComponentContext();
//Get a MultiServiceFactory
XMultiServiceFactory xMultiServiceFactory = Connector.GetMultiServiceFactory(xComponentContext);
//Get a Dektop instance
XDesktop xDesktop = Connector.GetDesktop(xMultiServiceFactory);
//Convert a windows path to an OpenOffice one
fileToPrint = Component.PathConverter(fileToPrint);
//Load the document you want to print
XComponent xComponent = Component.LoadDocument(
(XComponentLoader)xDesktop, fileToPrint, "_blank");
//Print the XComponent
Printer.Print(xComponent);
}
}
}
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 16

2007-03-04T20:33:28Z

LarsBehr:

Create a simple Paragraph using the ParagraphBuilder

<pre>
//Create a new text document
TextDocument document = new TextDocument();
document.New();
//Create a standard paragraph using the ParagraphBuilder
Paragraph paragraph = ParagraphBuilder.CreateStandardTextParagraph(document);
//Add some simple text
paragraph.TextContent.Add(new SimpleText(document, "Some simple text!"));
//Add the paragraph to the document
document.Content.Add(paragraph);
//Save
document.SaveTo("simple.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 15

2007-03-04T20:31:58Z

LarsBehr:

Create a standard Paragraph with formated text

<pre>
//Create a new text document
TextDocument document = new TextDocument();
document.New();
//Create a standard paragraph using the ParagraphBuilder
Paragraph paragraph = ParagraphBuilder.CreateStandardTextParagraph(document);
//Add some formated text
FormatedText formText = new FormatedText(document, "T1", "Some formated text!");
formText.TextStyle.TextProperties.Bold = "bold";
paragraph.TextContent.Add(formText);
//Add the paragraph to the document
document.Content.Add(paragraph);
//Save
document.SaveTo("formated.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 14

2007-03-04T20:28:55Z

LarsBehr:

Create a List with List Item objects

<pre>
//Create a new text document
TextDocument document = new TextDocument();
document.New();
//Create a numbered list
List li = new List(document, "L1", ListStyles.Bullet, "L1P1");
//Create a new list item
ListItem lit = new ListItem(li);
//Create a paragraph
Paragraph paragraph = ParagraphBuilder.CreateStandardTextParagraph(document);
//Add some text
paragraph.TextContent.Add(new SimpleText(document, "First item"));
//Add paragraph to the list item
lit.Content.Add(paragraph);
//Add the list item
li.Content.Add(lit);
//Add the list
document.Content.Add(li);
//Save document
document.SaveTo("list.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 13

2007-03-04T20:23:35Z

LarsBehr:

Using the Header object and fill the heading text using the TextBuilder class

<pre>
string headingText = "Some Heading with\n styles\t,line breaks, tab stops and extra whitspaces";
//Create a new text document
TextDocument document = new TextDocument();
document.New();
//Create a new Heading
Header header = new Header(document, Headings.Heading);
//Create a TextCollection from headingText using the TextBuilder
//You can conert every string incl. control character \n, \t, .. into
//a ItextCollection using the TextBuilder
ITextCollection textCol = TextBuilder.BuildTextCollection(document, headingText);
//Add text collection
header.TextContent = textCol;
//Add header
document.Content.Add(header);
document.SaveTo("HeadingWithControlCharacter.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 12

2007-03-04T20:20:00Z

LarsBehr:

Create any type of hyperlinks by using the XLink class

<pre>
//Create new TextDocument
TextDocument document = new TextDocument();
document.New();
//Create a new Paragraph
Paragraph para = new Paragraph(document, "P1");
//Create some simple text
SimpleText stext = new SimpleText(document, "Some simple text ");
//Create a XLink
XLink xlink = new XLink(document, "http://www.OpenOffice.org", "OpenOffice.org");
//Add the textcontent
para.TextContent.Add(stext);
para.TextContent.Add(xlink);
//Add paragraph to the document content
document.Content.Add(para);
//Save
document.SaveTo("XLink.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 11

2007-03-04T20:17:28Z

LarsBehr:

Creating Footnotes and Endnotes

<pre>
//Create new TextDocument
TextDocument document = new TextDocument();
document.New();
//Create a new Paragph
Paragraph para = ParagraphBuilder.CreateStandardTextParagraph(document);
//Create some simple Text
para.TextContent.Add(new SimpleText(document, "Some simple text. And I have a footnode"));
//Create a Footnote
para.TextContent.Add(new Footnote(document, "Footer Text", "1", FootnoteType.footnode));
//Add the paragraph
document.Content.Add(para);
//Save
document.SaveTo("footnote.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 10

2007-03-04T20:15:56Z

LarsBehr:

Create a Paragraph Collection from a long string by using the ParagraphBuilder

<pre>
//some text e.g read from a TextBox
string someText = "Max Mustermann\nMustermann Str. 300\n22222 Hamburg\n\n\n\n"
+"Heinz Willi\nDorfstr. 1\n22225 Hamburg\n\n\n\n"
+"Offer for 200 Intel Pentium 4 CPU's\n\n\n\n"
+"Dear Mr. Willi,\n\n\n\n"
+"thank you for your request. \tWe can "
+"offer you the 200 Intel Pentium IV 3 Ghz CPU's for a price of "
+"79,80 € per unit."
+"This special offer is valid to 31.10.2005. If you accept, we "
+"can deliver within 24 hours.\n\n\n\n"
+"Best regards \nMax Mustermann";

//Create new TextDocument
TextDocument document = new TextDocument();
document.New();
//Use the ParagraphBuilder to split the string into ParagraphCollection
ParagraphCollection pCollection = ParagraphBuilder.CreateParagraphCollection(
document,
someText,
true,
ParagraphBuilder.ParagraphSeperator);
//Add the paragraph collection
foreach(Paragraph paragraph in pCollection)
document.Content.Add(paragraph);
//save
document.SaveTo("Letter.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 9

2007-03-04T20:12:50Z

LarsBehr:

Accessing and manipulating common styles (style templates)

<pre>
TextDocument document = new TextDocument();
document.New();
//Find a Header template
IStyle style = document.CommonStyles.GetStyleByName("Heading_20_1");
Assert.IsNotNull(style, "Style with name Heading_20_1 must exist");
Assert.IsTrue(style is ParagraphStyle, "style must be a ParagraphStyle");
((ParagraphStyle)style).TextProperties.FontName = FontFamilies.BroadwayBT;
//Create a header that use the standard style Heading_20_1
Header header = new Header(document, Headings.Heading_20_1);
//Add some text
header.TextContent.Add(new SimpleText(document, "I am the header text and my style template was modified :)"));
//Add header to the document
document.Content.Add(header);
//save the document
document.SaveTo("modifiedCommonStyle.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 8

2007-03-04T20:10:59Z

LarsBehr:

Don't do things twice. Create deep clones of any IContent object.

<pre>
TextDocument document = new TextDocument();
document.New();
Paragraph paragraph = ParagraphBuilder.CreateStandardTextParagraph(document);
paragraph.TextContent.Add(new SimpleText(document, "Some text"));
Paragraph paragraphClone = (Paragraph)paragraph.Clone();
ParagraphStyle paragraphStyle = new ParagraphStyle(document, "P1");
paragraphStyle.TextProperties.Bold = "bold";
//Add paragraph style to the document,
//only automaticaly created styles will be added also automaticaly
document.Styles.Add(paragraphStyle);
paragraphClone.ParagraphStyle = paragraphStyle;
//Clone the clone
Paragraph paragraphClone2 = (Paragraph)paragraphClone.Clone();
document.Content.Add(paragraph);
document.Content.Add(paragraphClone);
document.Content.Add(paragraphClone2);
document.SaveTo("clonedParagraphs.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 7

2007-03-04T20:08:54Z

LarsBehr:

Create a simple text table by using the TableBuilder class

<pre>
//Create a new text document
TextDocument document = new TextDocument();
document.New();
//Create a table for a text document using the TableBuilder
Table table = TableBuilder.CreateTextDocumentTable(
document,
"table1",
"table1",
3,
3,
16.99,
false,
false);
//Create a standard paragraph
Paragraph paragraph = ParagraphBuilder.CreateStandardTextParagraph(document);
//Add some simple text
paragraph.TextContent.Add(new SimpleText(document, "Some cell text"));
//Insert paragraph into the first cell
table.RowCollection[0].CellCollection[0].Content.Add(paragraph);
//Add table to the document
document.Content.Add(table);
//Save the document
document.SaveTo("simpleTable.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 6

2007-03-04T20:07:10Z

LarsBehr:

Create a table and use cell merging

<pre>
//Create a new text document
TextDocument document = new TextDocument();
document.New();
//Create a table for a text document using the TableBuilder
Table table = TableBuilder.CreateTextDocumentTable(
document,
"table1",
"table1",
3,
3,
16.99,
false,
false);

//Fill the cells
foreach(Row row in table.RowCollection) {
foreach(Cell cell in row.CellCollection) {
//Create a standard paragraph
Paragraph paragraph = ParagraphBuilder.CreateStandardTextParagraph(document);
//Add some simple text
paragraph.TextContent.Add(new SimpleText(document, "Cell text"));
cell.Content.Add(paragraph);
}
}
//Merge some cells. Notice this is only available in text documents!
table.RowCollection[1].MergeCells(document, 1, 2, true);
//Add table to the document
document.Content.Add(table);
//Save the document
document.SaveTo("simpleTableWithMergedCells.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 5

2007-03-04T20:04:02Z

LarsBehr:

Add graphics to your document

<pre>
TextDocument textdocument = new TextDocument();
textdocument.New();
Paragraph p = ParagraphBuilder.CreateStandardTextParagraph(textdocument);
Frame frame= new Frame(textdocument, "frame1", "graphic1", @"F:\img.jpg");
p.Content.Add(frame);
textdocument.Content.Add(p);
textdocument.SaveTo("grapic.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 4

2007-03-04T20:01:52Z

LarsBehr:

Add a graphic as a illustration to your text document

<pre>
TextDocument textdocument = new TextDocument();
textdocument.New();
Paragraph pOuter = ParagraphBuilder.CreateStandardTextParagraph(textdocument);
DrawTextBox drawTextBox = new DrawTextBox(textdocument);
Frame frameTextBox = new Frame(textdocument, "fr_txt_box");
frameTextBox.DrawName = "fr_txt_box";
frameTextBox.ZIndex = "0";
Paragraph p = ParagraphBuilder.CreateStandardTextParagraph(textdocument);
p.StyleName = "Illustration";
Frame frame = new Frame(textdocument, "frame1", "graphic1", _imagefile);
frame.ZIndex = "1";
p.Content.Add(frame);
p.TextContent.Add(new SimpleText(textdocument, "Illustration"));
drawTextBox.Content.Add(p);
frameTextBox.SvgWidth = frame.SvgWidth;
drawTextBox.MinWidth = frame.SvgWidth;
drawTextBox.MinHeight = frame.SvgHeight;
frameTextBox.Content.Add(drawTextBox);
pOuter.Content.Add(frameTextBox);
textdocument.Content.Add(pOuter);
textdocument.SaveTo("drawTextbox.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 3

2007-03-04T18:32:49Z

LarsBehr:

Add Image Maps to your document

This snippet give you an example how to graphics as Image Maps to your document and how to
define DrawAreaRectangles and DrawAreaCircle regions incl. hyperlinks.

<pre>
string imagePath = @"Z:\Files\new_Class.jpg";
TextDocument document = new TextDocument();
document.New();
//Create standard paragraph
Paragraph paragraphOuter = ParagraphBuilder.CreateStandardTextParagraph(document);
//Create the frame with graphic
Frame frame = new Frame(document, "frame1", "graphic1", imagePath);
//Create a Draw Area Rectangle
DrawAreaRectangle drawAreaRec = new DrawAreaRectangle(
document, "0cm", "0cm", "1.5cm", "2.5cm", null);
drawAreaRec.Href = "http://OpenDocument4all.com";
//Create a Draw Area Circle
DrawAreaCircle drawAreaCircle = new DrawAreaCircle(
document, "4cm", "4cm", "1.5cm", null);
drawAreaCircle.Href = "http://AODL.OpenDocument4all.com";
DrawArea[] drawArea = new DrawArea[2] { drawAreaRec, drawAreaCircle };
//Create a Image Map
ImageMap imageMap = new ImageMap(document, drawArea);
//Add Image Map to the frame
frame.Content.Add(imageMap);
//Add frame to paragraph
paragraphOuter.Content.Add(frame);
//Add paragraph to document
document.Content.Add(paragraphOuter);
//Save the document
document.SaveTo(@"F:\tests\simpleImageMap.odt");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 2

2007-03-04T18:29:21Z

LarsBehr:

Create a spreadsheet document and add a table
<pre>
//Create new spreadsheet document
SpreadsheetDocument spreadsheetDocument = new SpreadsheetDocument();
spreadsheetDocument.New();
//Create a new table
Table table = new Table(spreadsheetDocument, "First", "tablefirst");
//Create a new cell, without any extra styles
Cell cell = table.CreateCell("cell001");
cell.OfficeValueType = "string";
//Set full border
cell.CellStyle.CellProperties.Border = Border.NormalSolid;
//Add a paragraph to this cell
Paragraph paragraph = ParagraphBuilder.CreateSpreadsheetParagraph(spreadsheetDocument);
//Add some text content
paragraph.TextContent.Add(new SimpleText(spreadsheetDocument, "Some text"));
//Add paragraph to the cell
cell.Content.Add(paragraph);
//Insert the cell at row index 2 and column index 3
//All need rows, columns and cells below the given
//indexes will be build automatically.
table.InsertCellAt(2, 3, cell);
//Insert table into the spreadsheet document
spreadsheetDocument.TableCollection.Add(table);
spreadsheetDocument.SaveTo("F:\tests\simple.ods");
</pre>
Back to the [[AODL_examples|AODL examples]] overview.

AODL example 1

2007-03-04T18:22:18Z

LarsBehr:

Create a Spreadsheet document and add a table with formated cells.

<pre>
//Create new spreadsheet document
SpreadsheetDocument spreadsheetDocument = new SpreadsheetDocument();
spreadsheetDocument.New();
//Create a new table
Table table = new Table(spreadsheetDocument, "First", "tablefirst");
//Create a new cell, without any extra styles
Cell cell = table.CreateCell();
//Add a paragraph to this cell
Paragraph paragraph = ParagraphBuilder.CreateSpreadsheetParagraph(spreadsheetDocument);
//Create some Formated text
FormatedText fText = new FormatedText(spreadsheetDocument, "T1", "Some Text");
//fText.TextStyle.TextProperties.Bold = "bold";
fText.TextStyle.TextProperties.Underline = LineStyles.dotted;
//Add formated text
paragraph.TextContent.Add(fText);
//Add paragraph to the cell
cell.Content.Add(paragraph);
//Insert the cell at row index 2 and column index 3
//All need rows, columns and cells below the given
//indexes will be build automatically.
table.InsertCellAt(2, 3, cell);
//Insert table into the spreadsheet document
spreadsheetDocument.TableCollection.Add(table);
spreadsheetDocument.SaveTo("formated.ods");
</pre>

Back to the [[AODL_examples|AODL examples]] overview.

AODL example 1

2007-03-04T18:20:41Z

LarsBehr:

AODL examples

2007-03-04T18:13:23Z

LarsBehr: AODL code examples and snippets

<ol>
<li>Create a Spreadsheet document and add a table with formated cells. [[AODL example 1|Show example]]</li>
<li>Create a spreadsheet document and add a table. [[AODL example 2|Show example]]</li>
<li>Add Image Maps to your document. [[AODL example 3|Show example]]</li>
<li>Add a graphic as Illustration to you document. [[AODL example 4|Show example]]</li>
<li>Add graphics to your document. [[AODL example 5|Show example]]</li>
<li>Create a table and use cell merging. [[AODL example 6|Show example]]</li>
<li>Create a simple text table by using the TableBuilder class. [[AODL example 7|Show example]]</li>
<li>Don't do things twice. Create deep clones of any IContent object. [[AODL example 8|Show example]]</li>
<li>Accessing and manipulating common styles (style templates). [[AODL example 9|Show example]]</li>
<li>Create a Paragraph Collection from a long string by using the ParagraphBuilder. [[AODL example 10|Show example]]</li>
<li>Creating Footnotes and Endnotes. [[AODL example 11|Show example]]</li>
<li>Create any type of hyperlinks by using the XLink class. [[AODL example 12|Show example]]</li>
<li>Using the Header object and fill the heading text using the TextBuilder class. [[AODL example 13|Show example]]</li>
<li>Create a List with List Item objects. [[AODL example 14|Show example]]</li>
<li>Create a standard Paragraph with formated text. [[AODL example 15|Show example]]</li>
<li>Create a simple Paragraph using the ParagraphBuilder. [[AODL example 16|Show example]]</li>
<li>Create a new TextDocument and use the OpenOfficeLib to do a print out. [[AODL example 17|Show example]]</li>
</ol>
 
Back to [[AODL]] Wiki page.

AODL FAQ

2007-03-04T18:05:01Z

LarsBehr: AODL FAQ

'''''Must be OpenOffice.org or parts of it installed for using AODL?'''''
 
There is no need of a installation. The whole document handling is implemented
inside AODL without dependicies on OpenOffice.org or it's API. 
The only case where OpenOffice.org has to be installed is when you plan to use
the small printer library which is available within AODL.


'''''Can AODL be used with mono under Linux?'''''
 
Yes, this is possible since there are no Microsoft specific dependicies.


'''''Which version of the .net framwork is required by AODL?'''''
 
AODL will need at minimum version 1.1 of the .net framework.


'''''Is it possible to compile AODL with the Microsoft Visual Studio 2005 C# Express Edition?'''''
 
Yes, you can simply import the existing Visual Studio project file and compile
the whole library. However, the original project file is for Microsoft Visual Studio 2003.


Back to the [[AODL]] Wiki page

AODL

2007-03-04T18:00:32Z

LarsBehr:

'''AODL (An Open Document Library)'''

AODL is the .net module of the [[ODF_Toolkit|ODF Toolkit]]. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
 
Up to now, the following fundamental operations are supported by AODL: 

<ul>
<li>Creating new documents in the text and the spreadsheet format.</li>
<li>Loading and manipulating documents in the text and spreadsheet (not complete yet) format.</li>
<li>Export loaded or created documents into the HTML format (text and spreadsheet documents).</li>
<li>Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)</li>
</ul>
 
'''Futher information:'''
Take a look at this [[AODL features|page]] to see a nearly complete list of existing features. 
The AODL [[AODL FAQ|FAQ]] 
AODL code [[AODL examples|examples / snippets]] 
The [[ODF_Toolkit|ODF Toolkit Wiki page]]. 
The ODF Toolkit [http://odftoolkit.openoffice.org project homepage] at the OpenOffice.org website.

AODL features

2007-03-04T17:59:09Z

LarsBehr: AODL Feature list

'''AODL features list'''

<ul>
<li> Reading, editing, creating and saving documents in the OpenDocument text format (TextDocument class).</li>
<li> Reading, editing, creating and saving documents in the OpenDocument spreadsheet format (SpreadsheetDocument class).</li>
<li> ParagraphBuilder class, this class offer several methods for the creation of often used Paragraphs types.</li>
<li> TableBuilder class, this class offer several methods for the creation of often used Table types.</li>
<li> TextBuilder class, this class offer several methods for the simple creation of ITextCollections that will be used within a Paragraph.</li>
<li> SizeConverter class, this class offer size conversation and size type conversation methods for height and width properties of AODL OpenDocument objects.</li>
<li> Colors class, this class offer the possibility to convert any .net system color to the corresponding color used in any document in the OpenDocument format.</li>
<li> Support for common styles. These are e.g used by OpenOffice as style templates.</li>
<li> Reading and writing of the documents metadata.</li>
<li> Full Paragraph support incl. Paragraphstyle and Paragraphproperties.</li>
<li> Full Header support incl. Headerstyle and Proeperties.</li>
<li> List support (number and bullet) support incl. Liststyle and Listproperties.</li>
<li> Full Table of Contents support incl. Sectionstyles.</li>
<li> Full Table support with nested table up to any depth and cellmerging support.</li>
- Full support for Rows incl. Rowstyle and Rowproperties.
- Full support for Columns incl. Columnstyle and Columnproperties.
- Full support for Cells incl. Cellstyle and Cellproperties.
<li> Text support incl. Textstyle and textproperties.</li>
- Simple Text
- Formated text
- Footnotes and Endnotes
<li> Textcontrol Whitespaces, Tabstops and Linebreaks.</li>
<li> XLink support (Hyperlinks for www, email, ftp,.. ).</li>
<li> Full Bookmark support (Standard, End and Start).</li>
<li> Graphic support, graphics could be used as simple embed graphic or as a Illustration with a sorounding DrawTextBox.</li>
<li> Drawframe support. The draw frame is the standard container object for draw objects and graphics. Incl. Graphicstyle and Graphicproperties.</li>
<li> Imagemap support with DrawAreaRectangle and DrawAreaCircle.</li>
<li> DrawTextBox support.</li>
<li> Officescripts support. Office scripts could be used within a image map.</li>
<li> Deep cloning of AODL content objects. Deep clones from most of the IContent implementations like Tables, Paragraphs could be simply created by calling the clone method.</li>
<li> The Unknown content pattern. The unknown content implementation is available for Styles, Content and Text. All content that will be read from a OpenDocument file which isn't implemented yet will be mapped to a UnknownContent, UnknownTextContent resp. a UknownStyle object. All these implementation has a public property Node which made it easy to analyze the OpenDocument format inside. At least this solution make it possible to load and write files back without loosing any style or content information.</li>
<li> OpenDocument Importer interface. This interface let you easily writing your own importer implementations. Existing standard implementation of IImporter</li>
- PlainTextImporter (TextDocument only)
- CsvImporter (SpreadsheetDocument only)
- OpenDocumentImporter all document types.
- PDF export for text documents (early beta and TextDocument only)
<li> OpenDocument Exporter interface. This interface let you easily writing your own exporter implementations. Existing standard implementation of IExporter</li>
- OpenDocumentExporter all document types.</li>
- HtmlExporter all document types.</li>
<li> Helper class LinesStyles (possible Linestyles), Border (possible Border) and FontFamilies (about 100 fonts).</li>
<li> Print documents via the included OpenOfficeLib (This is feature is embed in seperate dll and is the only feature which need an existing OpenOffice installation.)</li>
<li> Master style pages (early beta)</li>
</ul>

AODL

2007-03-04T17:52:20Z

LarsBehr:

'''AODL (An Open Document Library)'''

AODL is the .net module of the [[ODF_Toolkit|ODF Toolkit]]. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
 
Up to now, the following fundamental operations are supported by AODL: 

<ul>
<li>Creating new documents in the text and the spreadsheet format.</li>
<li>Loading and manipulating documents in the text and spreadsheet (not complete yet) format.</li>
<li>Export loaded or created documents into the HTML format (text and spreadsheet documents).</li>
<li>Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)</li>
</ul>
 
'''Futher information:'''
Take a look at this [[AODL features|page]] to see a nearly complete list of existing features. 
The AODL [[AODL features|FAQ]] 
AODL code [[AODL examples|examples / snippets]] 
The [[ODF_Toolkit|ODF Toolkit Wiki page]]. 
The ODF Toolkit [http://odftoolkit.openoffice.org project homepage] at the OpenOffice.org website.

AODL

2007-03-04T17:35:26Z

LarsBehr:

'''AODL (An Open Document Library)'''

AODL is the .net module of the ODF Toolkit. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
 
Up to now, the following fundamental operations are supported by AODL: 

<ul>
<li>Creating new documents in the text and the spreadsheet format.</li>
<li>Loading and manipulating documents in the text and spreadsheet (not complete yet) format.</li>
<li>Export loaded or created documents into the HTML format (text and spreadsheet documents).</li>
<li>Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)</li>
</ul>
 
'''Futher information:'''
Take a look at this page to see a nearly complete list of existing features. 
The AODL FAQ 
AODL code samples / snippets

AODL

2007-03-04T17:35:08Z

LarsBehr:

'''AODL (An Open Document Library)'''

AODL is the .net module of the ODF Toolkit. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
 
Up to now, the following fundamental operations are supported by AODL: 

<ul>
<li>Creating new documents in the text and the spreadsheet format.</li>
<li>Loading and manipulating documents in the text and spreadsheet (not complete yet) format.</li>
<li>Export loaded or created documents into the HTML format (text and spreadsheet documents).</li>
<li>Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)</li>
</ul>

'''Futher information:'''
Take a look at this page to see a nearly complete list of existing features. 
The AODL FAQ 
AODL code samples / snippets

AODL

2007-03-04T17:33:51Z

LarsBehr:

'''AODL (An Open Document Library)'''

AODL is the .net module of the ODF Toolkit. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
Up to now, the following fundamental operations are supported by AODL. 

<ul>
<li>Creating new documents in the text and the spreadsheet format.</li>
<li>Loading and manipulating documents in the text and spreadsheet (not complete yet) format.</li>
<li>Export loaded or created documents into the HTML format (text and spreadsheet documents).</li>
<li>Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)</li>
</ul>

'''Futher information:'''
 
Take a look at this page to see a nearly complete list of existing features. 
The AODL FAQ 
AODL code samples / snippets

AODL

2007-03-04T17:31:32Z

LarsBehr: AODL

'''AODL (An Open Document Library)'''

AODL is the .net module of the ODF Toolkit. The library is completly written in pure C# and can be used
to extend your .net based software to support the OpenDocument Format. To use AODL within your projects respectively
software there is no need of a deep knowlegde of the OpenDocument Format itself. It would be helpfull to understand
what's going behind the scenes and for writing your own extensions, but as mentioned before this isn't a fundamental requirement.
Up to now, the following fundamental operations are supported by AODL.

- Creating new documents in the text and the spreadsheet format.
- Loading and manipulating documents in the text and spreadsheet (not complete yet) format.
- Export loaded or created documents into the HTML format (text and spreadsheet documents).
- Export loaded or created documents into the PDF Format. (this is in an early state of implementation and only available for text documents)

'''Futher information:'''
Take a look at this page to see a nearly complete list of existing features.
The AODL FAQ
AODL code samples / snippets