Apache OpenOffice Wiki - User contributions [en]

Hu.openoffice.org/Szabad diploma - OOo

2010-11-05T13:58:04Z

Timarandras: deprecated

Spellchecker Integration into Installation Set

2010-10-11T09:52:30Z

Timarandras: /* Changes in cvs module setup_native */ - updated

How to integrate a [[Extension_Dictionaries| spellchecker extension]] into OpenOffice.org / StarOffice installation sets.

Assuming you provide a spellchecker, dictionary, ... for language xy and already created an extension file dict_xy.oxt . Then your next task is, to add this file into the OpenOffice.org installation set. And the solution for this task is described here. A prerequisite is, that you delivered your spellchecker extension into a directory, where it is found during packaging process. This can be the pck-directory, where all other spellchecker extensions are located at the moment. After you did so, you have to make changes in the'' cvs modules “scp2” and “setup_native” to prepare the packaging process.

== Changes in cvs module scp2 ==

In the cvs module scp2 you have to define the file, so that it is included into the packaging process, and you have to define a new module, to which this file has to be assigned. For Unix platforms this module is used, to create a Unix package, like a rpm or a Solaris package.
The file definition happens in

''scp2/source/ooo/file_ooo.scp''

For language “xy” you will have to make a file definition like this:

#ifndef WITHOUT_MYSPELL_DICTS
File gid_File_Extension_Dictionary_Xy
Dir = gid_Brand_Dir_Share_Extension_Install;
Name = "dict-xy.oxt";
Styles = (PACKED);
UnixRights = 444;
End
#endif

The module definition happens in the file

''scp2/source/ooo/module_ooo.scp''

The definition looks like this for language “xy”:

Module gid_Module_Root_Extension_Dictionary_Xy
MOD_NAME_DESC ( MODULE_EXTENSION_DICTIONARY_XY );
Files = (gid_File_Extension_Dictionary_Xy);
InstallOrder = "2000";
Sortkey = "<number>";
Spellcheckerlanguage = "xy";
PackageInfo = "packinfo_office.txt";
ParentID = gid_Module_Dictionaries;
Styles = ();
End

Text displayed in the Windows installer defined in

''scp2/source/ooo/module_ooo.ulf''

The definition looks like this for language “xy”:

[STR_NAME_MODULE_EXTENSION_DICTIONARY_XY]
en-US = "Xy"

[STR_DESC_MODULE_EXTENSION_DICTIONARY_XY]
en-US = "Xy spelling dictionary and/or hyphenation patterns and/or thesaurus"

== Changes in cvs module setup_native ==

In the cvs module setup_native you have to assign the module defined in scp2 to a package (see line PackageInfo = “package_office.txt” in the module definition) and you have to define, for which installation sets in which languages your new extension shall be included. So the first file you have to adapt is the file

''setup_native/source/packinfo/packinfo_office.txt''

Dont be worried about the complexity of the package definition. There are some dependencies, that have to be defined for each package. Luckily they are always the same for all packages containing extensions, so you can simply copy an existing definition, like the one for “gid_Module_Root_Extension_Dictionary_En” and only change the language code:

Start
module = "gid_Module_Root_Extension_Dictionary_Xy"
script = "shellscripts_extensions.txt"
solarispackagename = "%PACKAGEPREFIX%WITHOUTDOTUNIXPRODUCTNAME%BRANDPACKAGEVERSION-dict-xy"
solarisrequires = "%SOLSUREPACKAGEPREFIX-ure (Name="UNO Runtime Environment"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core01 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core02 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core03 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core04 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core05 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core06 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core07 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %PACKAGEPREFIX%WITHOUTDOTUNIXPRODUCTNAME%BRANDPACKAGEVERSION (Name="Brand module for %PRODUCTNAME %PRODUCTVERSION")"
packagename = "%UNIXPRODUCTNAME%BRANDPACKAGEVERSION-dict-xy"
requires = "%UREPACKAGEPREFIX-ure,%BASISPACKAGEPREFIX%OOOBASEVERSION-core01,%BASISPACKAGEPREFIX%OOOBASEVERSION-core02,%BASISPACKAGEPREFIX%OOOBASEVERSION-core03,%BASISPACKAGEPREFIX%OOOBASEVERSION-core04,%BASISPACKAGEPREFIX%OOOBASEVERSION-core05,%BASISPACKAGEPREFIX%OOOBASEVERSION-core06,%BASISPACKAGEPREFIX%OOOBASEVERSION-core07,%UNIXPRODUCTNAME%BRANDPACKAGEVERSION"
linuxpatchrequires = ""
copyright = "1999-2008 by OpenOffice.org"
solariscopyright = "solariscopyrightfile"
vendor = "OpenOffice.org"
description = "Xy dictionary for %PRODUCTNAME %PRODUCTVERSION"
destpath = "/opt"
packageversion = "%PACKAGEVERSION"
End

Add the same name to
''setup_native/source/packinfo/package_names.txt''

%PACKAGEPREFIX%SOLARISBRANDPACKAGENAME%BRANDPACKAGEVERSION-dict-xy Xy dictionary for %PRODUCTNAME %PRODUCTVERSION

After you defined the package in this way, the last step is the assignment to the product languages. This happens in

''setup_native/source/packinfo/spellchecker_selection.txt''

You find something similar to this:

# This file defines the languages of the spellchecker, that are
# included into the language specific installation sets.
# First column: Language in the installation set.
# Second column: Assigned spellchecker languages. Comma separated list.

af = "af,en-US"
cs = "cs,en-US"
da = "da,de,en-US"
de = "de,en-US,fr,it"
en-US = "en-US,es,fr"
es = "en-US,es,fr,pt"
et = "en-US,et"
fr = "en-US,es,fr"
gl = "en-US,pt,es,gl"
hu = "de,en-US,hu"
it = "de,en-US,fr,it"
ja = "en-US"
ko = "en-US"
lt = "en-US,lt"
ne = "en-US,ne"
nl = "en-US,fr,de,nl"
pl = "de,en-US,pl,ru"
pt-BR = "en-US,es,pt"
ru = "de,en-US,ru"
sk = "en-US,sk"
sl = "en-US,sl"
sv = "de,en-US,sv"
sw = "en-US,sw"
th = "en-US,th"
vi = "en-US,fr,vi"
zh-TW = "en-US"
zh-CN = "en-US"
zu = "en-US,zu"

If you want, that your spellckecker in language “xy” is required for installation sets containing language “es”, you can simply add “xy” to the comma separated list for “es”:

''Old: es = "en-US,es,fr,pt"''

''New: es = "en-US,es,fr,pt,xy”''

You can add “xy” to as many languages as you like. And if it not already exists, you can also create a new line for language “xy” and define which spellchecker extensions shall be added into installation sets containing language “xy”.

That is all you have to do. Now you only have to build cvs module “scp2” and to deliver “scp2” and “setup_native”. Then you can start creation of installation sets in module “instsetoo_native”.

== License for your dictionary ==

If your dictionary specifies license text, registration of the extension will fail. Extension will be packed into installer set and installed, but will not be registred with unopkg so it will not be visible from OpenOffice.org.

Only dictionaries that do not require user license agreement can be integrated into installation set.

[[Category:Extensions]][[Category:Build_System]]

Spellchecker Integration into Installation Set

2010-10-11T09:50:23Z

Timarandras: /* Changes in cvs module scp2 */ - updated

How to integrate a [[Extension_Dictionaries| spellchecker extension]] into OpenOffice.org / StarOffice installation sets.

Assuming you provide a spellchecker, dictionary, ... for language xy and already created an extension file dict_xy.oxt . Then your next task is, to add this file into the OpenOffice.org installation set. And the solution for this task is described here. A prerequisite is, that you delivered your spellchecker extension into a directory, where it is found during packaging process. This can be the pck-directory, where all other spellchecker extensions are located at the moment. After you did so, you have to make changes in the'' cvs modules “scp2” and “setup_native” to prepare the packaging process.

== Changes in cvs module scp2 ==

In the cvs module scp2 you have to define the file, so that it is included into the packaging process, and you have to define a new module, to which this file has to be assigned. For Unix platforms this module is used, to create a Unix package, like a rpm or a Solaris package.
The file definition happens in

''scp2/source/ooo/file_ooo.scp''

For language “xy” you will have to make a file definition like this:

#ifndef WITHOUT_MYSPELL_DICTS
File gid_File_Extension_Dictionary_Xy
Dir = gid_Brand_Dir_Share_Extension_Install;
Name = "dict-xy.oxt";
Styles = (PACKED);
UnixRights = 444;
End
#endif

The module definition happens in the file

''scp2/source/ooo/module_ooo.scp''

The definition looks like this for language “xy”:

Module gid_Module_Root_Extension_Dictionary_Xy
MOD_NAME_DESC ( MODULE_EXTENSION_DICTIONARY_XY );
Files = (gid_File_Extension_Dictionary_Xy);
InstallOrder = "2000";
Sortkey = "<number>";
Spellcheckerlanguage = "xy";
PackageInfo = "packinfo_office.txt";
ParentID = gid_Module_Dictionaries;
Styles = ();
End

Text displayed in the Windows installer defined in

''scp2/source/ooo/module_ooo.ulf''

The definition looks like this for language “xy”:

[STR_NAME_MODULE_EXTENSION_DICTIONARY_XY]
en-US = "Xy"

[STR_DESC_MODULE_EXTENSION_DICTIONARY_XY]
en-US = "Xy spelling dictionary and/or hyphenation patterns and/or thesaurus"

== Changes in cvs module setup_native ==

In the cvs module setup_native you have to assign the module defined in scp2 to a package (see line PackageInfo = “package_office.txt” in the module definition) and you have to define, for which installation sets in which languages your new extension shall be included. So the first file you have to adapt is the file

''setup_native/source/packinfo/packinfo_office.txt''

Dont be worried about the complexity of the package definition. There are some dependencies, that have to be defined for each package. Luckily they are always the same for all packages containing extensions, so you can simply copy an existing definition, like the one for “gid_Module_Root_Extension_Dictionary_En” and only change the language code:

Start
module = "gid_Module_Root_Extension_Dictionary_Xy"
script = "shellscripts_extensions.txt"
solarispackagename = "%PACKAGEPREFIX%WITHOUTDOTUNIXPRODUCTNAME%BRANDPACKAGEVERSION-dict-xy"
solarisrequires = "%SOLSUREPACKAGEPREFIX-ure (Name="UNO Runtime Environment"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core01 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core02 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core03 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core04 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core05 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core06 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %BASISPACKAGEPREFIX%WITHOUTDOTOOOBASEVERSION-core07 (Name="Core module for %PRODUCTNAME %PRODUCTVERSION"), %PACKAGEPREFIX%WITHOUTDOTUNIXPRODUCTNAME%BRANDPACKAGEVERSION (Name="Brand module for %PRODUCTNAME %PRODUCTVERSION")"
packagename = "%UNIXPRODUCTNAME%BRANDPACKAGEVERSION-dict-xy"
requires = "%UREPACKAGEPREFIX-ure,%BASISPACKAGEPREFIX%OOOBASEVERSION-core01,%BASISPACKAGEPREFIX%OOOBASEVERSION-core02,%BASISPACKAGEPREFIX%OOOBASEVERSION-core03,%BASISPACKAGEPREFIX%OOOBASEVERSION-core04,%BASISPACKAGEPREFIX%OOOBASEVERSION-core05,%BASISPACKAGEPREFIX%OOOBASEVERSION-core06,%BASISPACKAGEPREFIX%OOOBASEVERSION-core07,%UNIXPRODUCTNAME%BRANDPACKAGEVERSION"
linuxpatchrequires = ""
copyright = "1999-2008 by OpenOffice.org"
solariscopyright = "solariscopyrightfile"
vendor = "OpenOffice.org"
description = "Xy dictionary for %PRODUCTNAME %PRODUCTVERSION"
destpath = "/opt"
packageversion = "%PACKAGEVERSION"
End

After you defined the package in this way, the last step is the assignment to the product languages. This happens in

''setup_native/source/packinfo/spellchecker_selection.txt''

You find something similar to this:

# This file defines the languages of the spellchecker, that are
# included into the language specific installation sets.
# First column: Language in the installation set.
# Second column: Assigned spellchecker languages. Comma separated list.

af = "af,en-US"
cs = "cs,en-US"
da = "da,de,en-US"
de = "de,en-US,fr,it"
en-US = "en-US,es,fr"
es = "en-US,es,fr,pt"
et = "en-US,et"
fr = "en-US,es,fr"
gl = "en-US,pt,es,gl"
hu = "de,en-US,hu"
it = "de,en-US,fr,it"
ja = "en-US"
ko = "en-US"
lt = "en-US,lt"
ne = "en-US,ne"
nl = "en-US,fr,de,nl"
pl = "de,en-US,pl,ru"
pt-BR = "en-US,es,pt"
ru = "de,en-US,ru"
sk = "en-US,sk"
sl = "en-US,sl"
sv = "de,en-US,sv"
sw = "en-US,sw"
th = "en-US,th"
vi = "en-US,fr,vi"
zh-TW = "en-US"
zh-CN = "en-US"
zu = "en-US,zu"

If you want, that your spellckecker in language “xy” is required for installation sets containing language “es”, you can simply add “xy” to the comma separated list for “es”:

''Old: es = "en-US,es,fr,pt"''

''New: es = "en-US,es,fr,pt,xy”''

You can add “xy” to as many languages as you like. And if it not already exists, you can also create a new line for language “xy” and define which spellchecker extensions shall be added into installation sets containing language “xy”.

That is all you have to do. Now you only have to build cvs module “scp2” and to deliver “scp2” and “setup_native”. Then you can start creation of installation sets in module “instsetoo_native”.

== License for your dictionary ==

If your dictionary specifies license text, registration of the extension will fail. Extension will be packed into installer set and installed, but will not be registred with unopkg so it will not be visible from OpenOffice.org.

Only dictionaries that do not require user license agreement can be integrated into installation set.

[[Category:Extensions]][[Category:Build_System]]

Base újdonságai a 3.3-s változatban

2010-08-19T07:50:27Z

Timarandras:

== Base általában ==
=== Elsődleges kulcs felismerő heurisztikus algoritmus felülbírálatának engedélyezhetősége ===
Új opció „Támogatja az elsődleges kulcsokat” az adatbázis kapcsolat „Speciális beállítások” alatt, ezzel lehetővé válik a Base által használt heurisztikus elsődleges kulcs felismerő algoritmusának felülbírálata.

Ez az új opció az ODBC, JDBC, és ADO adatbázis-kapcsolatoknál érhető el.

[[Image:Spec_tul.PNG]]

Amikor adatbázishoz olyan általános csatolókon keresztül csatlakozunk, mint az ODBC, JDBC, vagy az ADO, a Base heurisztikus algoritmust használ, annak kiderítésére, hogy az adatbázis támogatja-e az elsődleges kulcsokat, mindezt azért, mert ezen csatolók egyike sem rendelkezik specifikus támogatással ezen információ lekérdezésére.

Mivel a heurisztikus algoritmus néha hibázik, mostantól új opció „ Támogatja az elsődleges kulcsokat”, található a Szerkesztés>Speciális tulajdonságok>Speciális beállítások alatt. Az opció három állású jelölő négyzet, kijelölt állapot feltételezi az elsődleges kulcs támogatását, a kijelölés nélküli az elsődleges kulcs nem támogatott, a harmadik állapot a „nem meghatározott”, amelyik az alap beállított állapot, „alkalmazd a heurisztikus algoritmust” opciót jelenti.

Ne feledje, ez csak azt jelenti, hogy a heurisztikus algoritmus alkalmazásának a felül írása. Ha bejelöli ezt, és az adatbázis nem támogatja az elsődleges kulcsokat, arra számíthat, hogy a Base hibajelzéseket küld vagy megfagy, mivel arra számít, hogy az elsődleges kulcsok támogatottak. Például ha elsődleges kulcsot próbál meg létrehozni a tábla tervezőben.

=== Csak olvasható adatbázis regisztrálásának támogatása ===
Mostantól a Base támogatja a csak olvasható adatbázisok regisztrálását.

Az adatbázis regisztrálására általában az Eszközök>Beállítások>OpenOffice.org Base>Adatbázisok alatt történik. A regisztrációs adatok az OpenOffice.org konfigurációs fájljaiban rögzítettek, ami azt is lehetővé teszi, hogy kiegészítő beállítások részenként is alkalmazhatók (kiterjesztéseken keresztül). Ha ezek a beállítási részek csak olvashatónak kerültek beállításra, a konfigurációs mechanizmuson keresztül, a felhasználói felület e beállításokat figyelembe veszi, nem engedélyezi a regisztrációs bejegyzés módosítását (szerkesztését, eltávolítását).

=== Adatbázis illesztő program kibővítése kiterjesztéssel ===
Részletes információ itt:

http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/Database/Extending_Database_Drivers

A fenti specifikációból kivonat:

Az SDBC illesztő programok, kibővíthetők [http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/Extensions/Extensions kiterjesztésekkel].

A legtöbb illesztő program nem támogatja az olyan speciális tulajdonságokat, mint a nézetek szerkesztése, vagy a kulcsok hozzáadása vagy eldobása. Ezért az alábbi interfészek a kiterjesztés segítségével megvalósíthatók:

* [http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/tools/XViewSupport.html com.sun.star.sdb.tools.XViewSupport]
* [http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/tools/XTableRename.html com.sun.star.sdb.tools.XTableRename]
* [http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/tools/XTableAlteration.html com.sun.star.sdb.tools.XTableAlteration]
* [http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/tools/XKeyAlteration.html com.sun.star.sdb.tools.XKeyAlteration]
* [http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/tools/XIndexAlteration.html com.sun.star.sdb.tools.XIndexAlteration] .

A szükséges tulajdonságok engedélyezésére a kiterjesztésben, az illesztő program konfigurációs bejegyzésének a kibővítésére van szükség. A konfigurációs bejegyzés ellenőrzésére a tulajdonságok bejegyzés alatt kerül sor, ha a szolgáltatás létrehozható a neve kerül felhasználásra. Az alábbiakban található a konfigurációs bejegyzés és a szolgáltatás név egyeztető táblázata:

Konfiguráció neve A megvalósítandó interfész neve

ViewSupportServiceName [http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/tools/XViewSupport.html com.sun.star.sdb.tools.XViewSupport]

TableAlterationServiceName [http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/tools/XTableAlteration.html com.sun.star.sdb.tools.XTableAlteration]

TableRenameServiceName [http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/tools/XTableRename.html com.sun.star.sdb.tools.XTableRename]

IndexAlterationServiceName [http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/tools/XIndexAlteration.html com.sun.star.sdb.tools.XIndexAlteration]

KeyAlterationServiceName [http://api.openoffice.org/docs/common/ref/com/sun/star/sdb/tools/XKeyAlteration.html com.sun.star.sdb.tools.XKeyAlteration]

Annak engedélyezésére, hogy a fájl formátum specifikációban előírt helytől eltérő helyről is beolvasható legyen a lekérdezés, űrlap vagy jelentés, a kiterjesztés olyan szolgáltatást hozhat létre, amely az alábbi megnevezett interfészeket valósíthatja meg. A megnevezett konfigurációs bejegyzések:

* CommandDefinitionSupplier
* FormSupplier
* ReportSupplier 

amelyek mindegyike az alabbi interfészeket kell, hogy megvalósítsa:

* [http://api.openoffice.org/docs/common/ref/com/sun/star/container/XNameAccess.html com.sun.star.container.XNameAccess]
* [http://api.openoffice.org/docs/common/ref/com/sun/star/container/XNameContainer.html com.sun.star.container.XNameContainer]
* [http://api.openoffice.org/docs/common/ref/com/sun/star/ucb/XContent.html com.sun.star.ucb.XContent]
* [http://api.openoffice.org/docs/common/ref/com/sun/star/container/XChild.html com.sun.star.container.XChild]
* [http://api.openoffice.org/docs/common/ref/com/sun/star/container/XContainer.html com.sun.star.container.XContainer]
* [http://api.openoffice.org/docs/common/ref/com/sun/star/container/XContainerApproveBroadcaster.html com.sun.star.container.XContainerApproveBroadcaster]
* [http://api.openoffice.org/docs/common/ref/com/sun/star/lang/XInitialization.html com.sun.star.lang.XInitialization]

== Űrlapok ==
=== Ctrl+F5 gyorsbillentyű ide-oda kapcsol a dokumentum és a legközelebbi vezérlőelem között ===
Ctrl+F5, amit korábban arra használtunk, hogy az első űrlapvezérlő elem kapja meg a fókuszt, ezt a legtöbb felhasználó nehezen értette meg, hogy miért így van, megváltozott.

Mostantól a kurzor pozícióhoz legközelebb álló vezérlőelemre áll ha az nincs a vezérlőelemben. Egyébként visszaadja a fókuszt a dokumentum nézetnek.

=== Az űrlap vezérlőelelmek az őket tartalmazó dokumentum szövegével megegyezően formázódnak ===
Ez az új tulajdonság nem kapcsolódik szorosan a Base-hez, de érdekes lehet.

A vezérlőelemek szövegének formázása megváltozott, igaz ez a változás csak néhány vezérlőelemre és néhány dokumentum típusra korlátozódik.

Az OOo alkalmazások a képernyőn látható szöveget általában az úgynevezett referencia egység beállításai szerint formázzák. Ez lehet a dokumentum részére kiválasztott nyomtató, vagy egy virtuális egység (amelyet dokumentumonként állítanak be).

Az űrlap vezérlő elemek eddig ebben nem vettek részt, mindig az aktuális képernyő szerint formázták a szövegüket. Ennek következtében ha a vezérlő elem a szövegbe beillesztésre került, a dokumentum elrendezése megváltozott ha más eszközön néztük meg (nyomtatási kép, nyomtató, PDF export), de akkor is ha más nagyítás mellett néztük a képernyőn.

Mostantól, a nem adatbeviteli űrlap vezérlőelemek szövegei (rádiógomb, címkék, jelölőnégyzetek, csoportpanel, nyomógombok) a dokumentum referencia egység beállításai szerint formázódnak, így biztosítva a jobb beilleszkedést a dokumentum szövegébe.

Ez a tulajdonság alkalmazásonként kapcsolható be, pontosabban modulonként. A felhasználói felületen keresztül ez nem állítható.

A konfigurációs beállításoknál a /org.openoffice.Office.Common/Forms/ControlLayout kiterjesztésre került, például a munkafüzeteknél, a …..../ControlLayout/com.sun.star.sheet.SpreadsheetDocument/UseDocumentTextMetrics csomópont szabályozza azt, hogy a vezérlőelemek szöveg formázása bekapcsolt-e.

Alapértelmezettként a dokumentum referencia egysége bekapcsolt, a szöveges dokumentumoknál, rajzoknál, és bemutatóknál, és kikapcsolt az összes más dokumentum típusnál (munkafüzet, adatbázis űrlap, jelentés).

=== A szöveg (jellegű) űrlap vezérlő elemeknél új tulajdonság „Függőleges igazítás” ===
Az űrlapoknál a szöveg vezérlő elemek (szövegdoboz, stb.), mostantól támogatja a függőleges igazítást, amely eddig a nem szövegbevitelre használt más vezérlőelemeknél, mint például a címkék, eddig is rendelkezésre állt.

== [[Image:Szovegdoboz.PNG]] ==

== Jelentés tervező ==
=== Mező hozzáadása párbeszéd ablak elérhető a billentyűzetről is ===
A jelentés tervezőben a mező hozzáadása párbeszéd ablak a ALT+F8 gyorsbillentyűvel is elérhető.

[[Image:Rpt_mezo_hozzaad.PNG]]

== Tábla tervező ==
=== Az adatbázis csatolók új metaadat csomópontja az adatbázis oszlopleírások megtekintésére ===
Mostantól lehetőség van új tulajdonság meghatározására drivers xcu fájlban. Alapértelmezettként engedélyezve van a MySQL (JDBC) és az Ado kapcsolatokra (beleértve az Access-t is, az Access esetében ez csak olvasható, nem változtatható meg).

Amikor ez engedélyezett, a tábla tervezőben látható az oszlopleírás a normál esetben látható leírás mellett, amely súgó szövegként működik. Az oszlopleírás felhasználásra kerül súgó szövegként ha a normál leírás üres, egyébként a normál leírás alkalmazódik.

[[Image:Kategoriak.PNG]]

Hu.openoffice.org/Minőségbiztosítás

2010-08-08T16:42:51Z

Timarandras:

Az OpenOffice.org minőségbiztosításának támogatására, a tesztelésére
egy automatizált eszköz került bevezetésre az elmúlt év során, a VCLtesttool.
Ennek alkalmazására készülünk a magyar változat esetében is.

Az OOo 3.0.1_090109 változat teszteléséről készült [http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Minőségbiztosítás/Tesztelés Minőségbiztosítás - Tesztelés] összefoglaló, ahol az alábbiakban leírt testtool használatáról és a tesztelési eredményekről készült összefoglaló olvasható.

Az alábbi összefoglaló az OOo honlapján és a wikiben található információkat
foglalja össze.

A '''VCLTesttool''' egy különálló program az OOo felhasználói felület (GUI)
automatizált tesztelésére. A testtool TCP/IP interfészen keresztül
kommunikál, és a összes a gépre, ill. helyi hálózatra telepített OOo
tesztelésére alkalmas. A teszteket Basicben írt scriptek tartalmazzák,
amelyek buildenként letölthetők (link alul). A testtool scriptek akkor
működnek, ha az összes erőforrás (felhasználói felületi elem) rendelkezésre
áll. Használható MWS-ek és CWS-ek tesztelésére is.

A teszteket négy kategóriába sorolják:

0: Az összes build és minden változat esetében futtatandó tesztek

1: Az első build esetében futtatandó tesztek (plusz a 0-s összes)

2: A második build esetében futtatandó tesztek (plusz a 0-s összes)

3: A harmadik build esetében futtatandó tesztek (plusz a 0-s összes)

Nekünk a cat0 tesztek elégségesek lehetnek, a saját változat
tesztelésekor, majdnem az összes menüelemet és párbeszédablakot
megnyitják. Ha nagy probléma nélkül lefutnak, akkor nem lehet baj.

A tesztek, öt perctől majd egy óra hosszúságúak.

(A QUASTe-n láthatók az idők, az összes teszt ~3 nap alatt lemehet.)

A testtool beállítható úgy, hogy képernyőképet készít (BMP formátumban
~500 kB/kép átlagosan) minden megnyitott párbeszédablakról, ez használható
annak ellenőrzésére, hogy a fordítás minden ponton megtörtént-e, igaz
elég sok emberi erőforrást igényel, manuális feldolgozást - minden
képernyőképet át kell nézni. Ehhez a .testtolrc vagy a testtol.ini fájlba kell
betenni a következő sorokat:

<nowiki>[Screenshot]</nowiki>
'''Current'''<nowiki>=1</nowiki>
'''All'''<nowiki>=1</nowiki>

A képernyőképek nem az eredménykönyvtárba, hanem a felhasználó profilkönyvtárába kerülnek, pl: ~/.openoffice.org/3/user/work/

A results fájlban ennek kell megjelennie:

** There will be screenshots taken from every dialog

3 tesztet lefuttatva tesztelve a Writer, Math és Calc egy részét.
750MB méretű képernyő kép készült.
(pl. Calc teszt első fele 815 képernyő képet készített,
minden függvényről külön képernyőkép)

'''A testtool használata'''

A testtool indítása után, beállítások az Extra>Settings menüpont alatt,
a tesztelendő OOo program könyvtár, a scriptek könyvtárának, és a logok
könyvtárának beállítása.

Teszt script megnyitás File>Open, .bas kiterjesztésűek a tesztek, .res
kiterjesztésűek az eredmény fájlok, egy teszt fájl betöltése, F5
futtatás, de előtte győződj meg arról, hogy a tesztelendő OOo nem fut.
(win alatt gyorsindító legyen kikapcsolva)

Ha képernyővédő valakinek fut, akkor az is legyen kikapcsolva
(az OOo fog képernyővédőként futni.)

''' Ha az OOo beindul nézz a címsorra:'''

<nowiki>„Untitled 1 - OpenOffice.org Writer TTS:localhost[12479]”</nowiki>

Ne dolgozz, amíg a teszt fut, ne használd az egeret, a teszt leállását okozhatja.

'''A teszt eredmények elemzése:'''

Ne legyen narancs vagy piros szín az eredmény fájlban.

A teszt végének így kell kinéznie:

Date : 09/05/2006; Time: 02:57:20 PM; Duration : 0h 16m 33s

***************************************************
** No errors have occurred
** No warnings have occurred
** No warnings occurred during initialization
***************************************************

Ha hibát találsz egy tesztben futtasd újra, és ha reprodukálható
eredményt kapsz akkor lépj.

'''Linkek:'''

VCLTesttool letölthető innen, külön az összes támogatott platformra:

http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html

De az OOo telepíthető a testtollal, opcionálisan választható, így a
Basis/program könyvtárba települ.
Winre minimum kell: a testtool.exe és a testtool.ini, (linuxra: testtool
script és a .testtoolrc).

Wiki, az általános információkkal:
http://wiki.services.openoffice.org/wiki/VCLTesttool

A saját gépeden az eredmények közötti gyors keresést segíti, az alábbi
Java-program:

http://vcltesttoolglue.sourceforge.net/README.html

Általános információ:

http://qa.openoffice.org/qatesttool/OOo_testtool.pdf

Teszt scriptek írása:

http://qa.openoffice.org/qatesttool/OOo_tt_CookBook.pdf

A meglévő scriptek, buildenként, innen letölthetők:

http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/

Másik lehetőség a Mercurial (hg) használata:

hg clone http://hg.services.openoffice.org/DEV300 <munkakönyvtár>
cd <munkakönyvtár>

A megfelelő milestone (pl. OOO330_m3) checkout-olása:

hg update -rOOO330_m3

Az eredményeket ide lehet feltenni: http://quaste.services.openoffice.org/

A magyar hibák bejelenthetők az OpenScope.org-on is. [http://bug.openscope.org/secure/CreateIssue.jspa?pid=10006&issuetype=1 Bejelentés]

Infók a QUASTe-ről: [[QUASTe]]

Kiegészítő információ: [[VCLTesttool]]

[[Category:Magyar]]

Hu.openoffice.org/Minőségbiztosítás

2010-08-08T16:41:03Z

Timarandras:

Az OpenOffice.org minőségbiztosításának támogatására, a tesztelésére
egy automatizált eszköz került bevezetésre az elmúlt év során, a VCLtesttool.
Ennek alkalmazására készülünk a magyar változat esetében is.

Az OOo 3.0.1_090109 változat teszteléséről készült [http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Minőségbiztosítás/Tesztelés Minőségbiztosítás - Tesztelés] összefoglaló, ahol az alábbiakban leírt testtool használatáról és a tesztelési eredményekről készült összefoglaló olvasható.

Az alábbi összefoglaló az OOo honlapján és a wikiben található információkat
foglalja össze.

A '''VCLTesttool''' egy különálló program az OOo felhasználói felület (GUI)
automatizált tesztelésére. A testtool TCP/IP interfészen keresztül
kommunikál, és a összes a gépre, ill. helyi hálózatra telepített OOo
tesztelésére alkalmas. A teszteket Basicben írt scriptek tartalmazzák,
amelyek buildenként letölthetők (link alul). A testtool scriptek akkor
működnek, ha az összes erőforrás (felhasználói felületi elem) rendelkezésre
áll. Használható MWS-ek és CWS-ek tesztelésére is.

A teszteket négy kategóriába sorolják:

0: Az összes build és minden változat esetében futtatandó tesztek

1: Az első build esetében futtatandó tesztek (plusz a 0-s összes)

2: A második build esetében futtatandó tesztek (plusz a 0-s összes)

3: A harmadik build esetében futtatandó tesztek (plusz a 0-s összes)

Nekünk a cat0 tesztek elégségesek lehetnek, a saját változat
tesztelésekor, majdnem az összes menüelemet és párbeszédablakot
megnyitják. Ha nagy probléma nélkül lefutnak, akkor nem lehet baj.

A tesztek, öt perctől majd egy óra hosszúságúak.

(A QUASTe-n láthatók az idők, az összes teszt ~3 nap alatt lemehet.)

A testtool beállítható úgy, hogy képernyőképet készít (BMP formátumban
~500 kB/kép átlagosan) minden megnyitott párbeszédablakról, ez használható
annak ellenőrzésére, hogy a fordítás minden ponton megtörtént-e, igaz
elég sok emberi erőforrást igényel, manuális feldolgozást - minden
képernyőképet át kell nézni. Ehhez a .testtolrc vagy a testtol.ini fájlba kell
betenni a következő sorokat:

<nowiki>[Screenshot]</nowiki>
'''Current'''<nowiki>=1</nowiki>
'''All'''<nowiki>=1</nowiki>

A képernyőképek nem az eredménykönyvtárba, hanem a felhasználó profilkönyvtárába kerülnek, pl: ~/.openoffice.org/3/user/work/

A results fájlban ennek kell megjelennie:
<nowiki>** There will be screenshots taken from every dialog</nowiki>

3 tesztet lefuttatva tesztelve a Writer, Math és Calc egy részét.
750MB méretű képernyő kép készült.
(pl. Calc teszt első fele 815 képernyő képet készített,
minden függvényről külön képernyőkép)

'''A testtool használata'''

A testtool indítása után, beállítások az Extra>Settings menüpont alatt,
a tesztelendő OOo program könyvtár, a scriptek könyvtárának, és a logok
könyvtárának beállítása.

Teszt script megnyitás File>Open, .bas kiterjesztésűek a tesztek, .res
kiterjesztésűek az eredmény fájlok, egy teszt fájl betöltése, F5
futtatás, de előtte győződj meg arról, hogy a tesztelendő OOo nem fut.
(win alatt gyorsindító legyen kikapcsolva)

Ha képernyővédő valakinek fut, akkor az is legyen kikapcsolva
(az OOo fog képernyővédőként futni.)

''' Ha az OOo beindul nézz a címsorra:'''

<nowiki>„Untitled 1 - OpenOffice.org Writer TTS:localhost[12479]”</nowiki>

Ne dolgozz, amíg a teszt fut, ne használd az egeret, a teszt leállását okozhatja.

'''A teszt eredmények elemzése:'''

Ne legyen narancs vagy piros szín az eredmény fájlban.

A teszt végének így kell kinéznie:

Date : 09/05/2006; Time: 02:57:20 PM; Duration : 0h 16m 33s

<nowiki>***************************************************</nowiki>

<nowiki>** No errors have occurred</nowiki>

<nowiki>** No warnings have occurred</nowiki>

<nowiki>** No warnings occurred during initialization</nowiki>

<nowiki>***************************************************</nowiki>

Ha hibát találsz egy tesztben futtasd újra, és ha reprodukálható
eredményt kapsz akkor lépj.

'''Linkek:'''

VCLTesttool letölthető innen, külön az összes támogatott platformra:

http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html

De az OOo telepíthető a testtollal, opcionálisan választható, így a
Basis/program könyvtárba települ.
Winre minimum kell: a testtool.exe és a testtool.ini, (linuxra: testtool
script és a .testtoolrc).

Wiki, az általános információkkal:
http://wiki.services.openoffice.org/wiki/VCLTesttool

A saját gépeden az eredmények közötti gyors keresést segíti, az alábbi
Java-program:

http://vcltesttoolglue.sourceforge.net/README.html

Általános információ:

http://qa.openoffice.org/qatesttool/OOo_testtool.pdf

Teszt scriptek írása:

http://qa.openoffice.org/qatesttool/OOo_tt_CookBook.pdf

A meglévő scriptek, buildenként, innen letölthetők:

http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/

Másik lehetőség a Mercurial (hg) használata:

hg clone http://hg.services.openoffice.org/DEV300 <munkakönyvtár>
cd <munkakönyvtár>

A megfelelő milestone (pl. OOO330_m3) checkout-olása:

hg update -rOOO330_m3

Az eredményeket ide lehet feltenni: http://quaste.services.openoffice.org/

A magyar hibák bejelenthetők az OpenScope.org-on is. [http://bug.openscope.org/secure/CreateIssue.jspa?pid=10006&issuetype=1 Bejelentés]

Infók a QUASTe-ről: [[QUASTe]]

Kiegészítő információ: [[VCLTesttool]]

[[Category:Magyar]]

Hu.openoffice.org/Minőségbiztosítás

2010-08-08T14:25:31Z

Timarandras: screenshot könyvtár

Az OpenOffice.org minőségbiztosításának támogatására, a tesztelésére
egy automatizált eszköz került bevezetésre az elmúlt év során, a VCLtesttool.
Ennek alkalmazására készülünk a magyar változat esetében is.

Az OOo 3.0.1_090109 változat teszteléséről készült [http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Minőségbiztosítás/Tesztelés Minőségbiztosítás - Tesztelés] összefoglaló, ahol az alábbiakban leírt testtool használatáról és a tesztelési eredményekről készült összefoglaló olvasható.

Az alábbi összefoglaló az OOo honlapján és a wikiben található információkat
foglalja össze.

A '''VCLTesttool''' egy különálló program az OOo felhasználói felület (GUI)
automatizált tesztelésére. A testtool TCP/IP interfészen keresztül
kommunikál, és a összes a gépre, ill. helyi hálózatra telepített OOo
tesztelésére alkalmas. A teszteket Basicben írt scriptek tartalmazzák,
amelyek buildenként letölthetők (link alul). A testtool scriptek akkor
működnek, ha az összes erőforrás (felhasználói felületi elem) rendelkezésre
áll. Használható MWS-ek és CWS-ek tesztelésére is.

A teszteket négy kategóriába sorolják:

0: Az összes build és minden változat esetében futtatandó tesztek

1: Az első build esetében futtatandó tesztek (plusz a 0-s összes)

2: A második build esetében futtatandó tesztek (plusz a 0-s összes)

3: A harmadik build esetében futtatandó tesztek (plusz a 0-s összes)

Nekünk a cat0 tesztek elégségesek lehetnek, a saját változat
tesztelésekor, majdnem az összes menüelemet és párbeszédablakot
megnyitják. Ha nagy probléma nélkül lefutnak, akkor nem lehet baj.

A tesztek, öt perctől majd egy óra hosszúságúak.

(A QUASTe-n láthatók az idők, az összes teszt ~3 nap alatt lemehet.)

A testtool beállítható úgy, hogy képernyőképet készít (BMP formátumban
~500 kB/kép átlagosan) minden megnyitott párbeszédablakról, ez használható
annak ellenőrzésére, hogy a fordítás minden ponton megtörtént-e, igaz
elég sok emberi erőforrást igényel, manuális feldolgozást - minden
képernyőképet át kell nézni. Ehhez a .testtolrc vagy a testtol.ini fájlba kell
betenni a következő sorokat:

<nowiki>[Screenshot]</nowiki>
'''Current'''<nowiki>=1</nowiki>
'''All'''<nowiki>=1</nowiki>

A képernyőképek nem az eredménykönyvtárba, hanem a felhasználó profilkönyvtárába kerülnek, pl: ~/.openoffice.org/3/user/work/

A results fájban ennek kell megjelennie:
** There will be screenshots taken from every dialog

3 tesztet lefuttatva tesztelve a Writer, Math és Calc egy részét.
750MB méretű képernyő kép készült.
(pl. Calc teszt első fele 815 képernyő képet készített,
minden függvényről külön képernyőkép)

'''A testtool használata'''

A testtool indítása után, beállítások az Extra>Settings menüpont alatt,
a tesztelendő OOo program könyvtár, a scriptek könyvtárának, és a logok
könyvtárának beállítása.

Teszt script megnyitás File>Open, .bas kiterjesztésűek a tesztek, .res
kiterjesztésűek az eredmény fájlok, egy teszt fájl betöltése, F5
futtatás, de előtte győződj meg arról, hogy a tesztelendő OOo nem fut.
(win alatt gyorsindító legyen kikapcsolva)

Ha képernyővédő valakinek fut, akkor az is legyen kikapcsolva
(az OOo fog képernyővédőként futni.)

''' Ha az OOo beindul nézz a címsorra:'''

<nowiki>„Untitled 1 - OpenOffice.org Writer TTS:localhost[12479]”</nowiki>

Ne dolgozz, amíg a teszt fut, ne használd az egeret, a teszt leállását okozhatja.

'''A teszt eredmények elemzése:'''

Ne legyen narancs vagy piros szín az eredmény fájlban.

A teszt végének így kell kinéznie:

Date : 09/05/2006; Time: 02:57:20 PM; Duration : 0h 16m 33s

<nowiki>***************************************************</nowiki>

<nowiki>** No errors have occurred</nowiki>

<nowiki>** No warnings have occurred</nowiki>

<nowiki>** No warnings occurred during initialization</nowiki>

<nowiki>***************************************************</nowiki>

Ha hibát találsz egy tesztben futtasd újra, és ha reprodukálható
eredményt kapsz akkor lépj.

'''Linkek:'''

VCLTesttool letölthető innen, külön az összes támogatott platformra:

http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html

De az OOo telepíthető a testtollal, opcionálisan választható, így a
Basis/program könyvtárba települ.
Winre minimum kell: a testtool.exe és a testtool.ini, (linuxra: testtool
script és a .testtoolrc).

Wiki, az általános információkkal:
http://wiki.services.openoffice.org/wiki/VCLTesttool

A saját gépeden az eredmények közötti gyors keresést segíti, az alábbi
Java-program:

http://vcltesttoolglue.sourceforge.net/README.html

Általános információ:

http://qa.openoffice.org/qatesttool/OOo_testtool.pdf

Teszt scriptek írása:

http://qa.openoffice.org/qatesttool/OOo_tt_CookBook.pdf

A meglévő scriptek, buildenként, innen letölthetők:

http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/

Másik lehetőség a Mercurial (hg) használata:

hg clone http://hg.services.openoffice.org/DEV300 <munkakönyvtár>
cd <munkakönyvtár>

A megfelelő milestone (pl. OOO330_m3) checkout-olása:

hg update -rOOO330_m3

Az eredményeket ide lehet feltenni: http://quaste.services.openoffice.org/

A magyar hibák bejelenthetők az OpenScope.org-on is. [http://bug.openscope.org/secure/CreateIssue.jspa?pid=10006&issuetype=1 Bejelentés]

Infók a QUASTe-ről: [[QUASTe]]

Kiegészítő információ: [[VCLTesttool]]

[[Category:Magyar]]

Hu.openoffice.org/Minőségbiztosítás

2010-08-08T07:21:04Z

Timarandras:

Az OpenOffice.org minőségbiztosításának támogatására, a tesztelésére
egy automatizált eszköz került bevezetésre az elmúlt év során, a VCLtesttool.
Ennek alkalmazására készülünk a magyar változat esetében is.

Az OOo 3.0.1_090109 változat teszteléséről készült [http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Minőségbiztosítás/Tesztelés Minőségbiztosítás - Tesztelés] összefoglaló, ahol az alábbiakban leírt testtool használatáról és a tesztelési eredményekről készült összefoglaló olvasható.

Az alábbi összefoglaló az OOo honlapján és a wikiben található információkat
foglalja össze.

A '''VCLTesttool''' egy különálló program az OOo felhasználói felület (GUI)
automatizált tesztelésére. A testtool TCP/IP interfészen keresztül
kommunikál, és a összes a gépre, ill. helyi hálózatra telepített OOo
tesztelésére alkalmas. A teszteket Basicben írt scriptek tartalmazzák,
amelyek buildenként letölthetők (link alul). A testtool scriptek akkor
működnek, ha az összes erőforrás (felhasználói felületi elem) rendelkezésre
áll. Használható MWS-ek és CWS-ek tesztelésére is.

A teszteket négy kategóriába sorolják:

0: Az összes build és minden változat esetében futtatandó tesztek

1: Az első build esetében futtatandó tesztek (plusz a 0-s összes)

2: A második build esetében futtatandó tesztek (plusz a 0-s összes)

3: A harmadik build esetében futtatandó tesztek (plusz a 0-s összes)

Nekünk a cat0 tesztek elégségesek lehetnek, a saját változat
tesztelésekor, majdnem az összes menüelemet és párbeszédablakot
megnyitják. Ha nagy probléma nélkül lefutnak, akkor nem lehet baj.

A tesztek, öt perctől majd egy óra hosszúságúak.

(A QUASTe-n láthatók az idők, az összes teszt ~3 nap alatt lemehet.)

A testtool beállítható úgy, hogy képernyőképet készít (BMP formátumban
~500 kB/kép átlagosan) minden megnyitott párbeszédablakról, ez használható
annak ellenőrzésére, hogy a fordítás minden ponton megtörtént-e, igaz
elég sok emberi erőforrást igényel, manuális feldolgozást - minden
képernyőképet át kell nézni. Ehhez a .testtolrc vagy a testtol.ini fájlba kell
betenni a következő sorokat:

<nowiki>[Screenshot]</nowiki>
'''Current'''<nowiki>=1</nowiki>
'''All'''<nowiki>=1</nowiki>

A results fájban ennek kell megjelennie:
** There will be screenshots taken from every dialog

3 tesztet lefuttatva tesztelve a Writer, Math és Calc egy részét.
750MB méretű képernyő kép készült.
(pl. Calc teszt első fele 815 képernyő képet készített,
minden függvényről külön képernyőkép)

'''A testtool használata'''

A testtool indítása után, beállítások az Extra>Settings menüpont alatt,
a tesztelendő OOo program könyvtár, a scriptek könyvtárának, és a logok
könyvtárának beállítása.

Tesz script megnyitás File>Open, .bas kiterjesztésűek a tesztek, .res
kiterjesztésűek az eredmény fájlok, egy teszt fájl betöltése, F5
futtatás, de előtte győződj meg arról, hogy a tesztelendő OOo nem fut.
(win alatt gyorsindító legyen kikapcsolva)

Ha képernyővédő valakinek fut akkor az is legyen kikapcsolva
(az OOo fog képernyő védőként futni.)

''' Ha az OOo beindul nézz a címsorra:'''

<nowiki>„Untitled 1 - OpenOffice.org Writer TTS:localhost[12479]”</nowiki>

Ne dolgozz amíg a teszt fut, ne használd az egeret, a teszt leállását okozhatja.

'''A teszt eredmények elemzése:'''

Ne legyen narancs vagy piros szín az eredmény fájlban.

A teszt végének így kell kinéznie:

Date : 09/05/2006; Time: 02:57:20 PM; Duration : 0h 16m 33s

<nowiki>***************************************************</nowiki>

<nowiki>** No errors have occurred</nowiki>

<nowiki>** No warnings have occurred</nowiki>

<nowiki>** No warnings occurred during initialization</nowiki>

<nowiki>***************************************************</nowiki>

Ha hibát találsz egy tesztben futtasd újra, és ha reprodukálható
eredményt kapsz akkor lépj.

'''Linkek:'''

VCLTesttool letölthető innen, külön az összes támogatott platformra:

http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html

De az OOo telepíthető a testtollal, opcionálisan választható, így a
Basis/program könyvtárba települ.
Winre minimum kell: a testtool.exe és a testtool.ini, (linuxra: testtool
script és a .testtoolrc).

Wiki, az általános információkkal:
http://wiki.services.openoffice.org/wiki/VCLTesttool

A saját gépeden az eredmények közötti gyors keresést segíti, az alábbi
Java-program:

http://vcltesttoolglue.sourceforge.net/README.html

Általános információ:

http://qa.openoffice.org/qatesttool/OOo_testtool.pdf

Teszt scriptek írása:

http://qa.openoffice.org/qatesttool/OOo_tt_CookBook.pdf

A meglévő scriptek, buildenként, innen letölthetők:

http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/

Másik lehetőség a Mercurial (hg) használata:

hg clone http://hg.services.openoffice.org/DEV300 <munkakönyvtár>
cd <munkakönyvtár>

A megfelelő milestone (pl. OOO330_m3) checkout-olása:

hg update -rOOO330_m3

Az eredményeket ide lehet feltenni: http://quaste.services.openoffice.org/

A magyar hibák bejelenthetők az OpenScope.org-on is. [http://bug.openscope.org/secure/CreateIssue.jspa?pid=10006&issuetype=1 Bejelentés]

Infók a QUASTe-ről: [[QUASTe]]

Kiegészítő információ: [[VCLTesttool]]

[[Category:Magyar]]

Hu.openoffice.org/Minőségbiztosítás

2010-08-08T07:18:16Z

Timarandras: aktualizálás

Az OpenOffice.org minőségbiztosításának támogatására, a tesztelésére
egy automatizált eszköz került bevezetésre az elmúlt év során, a VCLtesttool.
Ennek alkalmazására készülünk a magyar változat esetében is.

Az OOo 3.0.1_090109 változat teszteléséről készült [http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Minőségbiztosítás/Tesztelés Minőségbiztosítás - Tesztelés] összefoglaló, ahol az alábbiakban leírt testtool használatáról és a tesztelési eredményekről készült összefoglaló olvasható.

Az alábbi összefoglaló az OOo honlapján és a wikiben található információkat
foglalja össze.

A '''VCLTesttool''' egy különálló program az OOo felhasználói felület (GUI)
automatizált tesztelésére. A testtool TCP/IP interfészen keresztül
kommunikál, és a összes a gépre, ill. helyi hálózatra telepített OOo
tesztelésére alkalmas. A teszteket Basicben írt scriptek tartalmazzák,
amelyek buildenként letölthetők (link alul). A testtool scriptek akkor
működnek, ha az összes erőforrás (felhasználói felületi elem) rendelkezésre
áll. Használható MWS-ek és CWS-ek tesztelésére is.

A teszteket négy kategóriába sorolják:

0: Az összes build és minden változat esetében futtatandó tesztek

1: Az első build esetében futtatandó tesztek (plusz a 0-s összes)

2: A második build esetében futtatandó tesztek (plusz a 0-s összes)

3: A harmadik build esetében futtatandó tesztek (plusz a 0-s összes)

Nekünk a cat0 tesztek elégségesek lehetnek, a saját változat
tesztelésekor, majdnem az összes menüelemet és párbeszédablakot
megnyitják. Ha nagy probléma nélkül lefutnak, akkor nem lehet baj.

A tesztek, öt perctől majd egy óra hosszúságúak.

(A QUASTe-n láthatók az idők, az összes teszt ~3 nap alatt lemehet.)

A testtool beállítható úgy, hogy képernyőképet készít (BMP formátumban
~500 kB/kép átlagosan) minden megnyitott párbeszédablakról, ez használható
annak ellenőrzésére, hogy a fordítás minden ponton megtörtént-e, igaz
elég sok emberi erőforrást igényel, manuális feldolgozást - minden
képernyőképet át kell nézni. Ehhez a .testtolrc vagy a testtol.ini fájlba kell
betenni a következő sorokat:

<nowiki>[Screenshot]</nowiki>
'''Current'''<nowiki>=1</nowiki>
'''All'''<nowiki>=1</nowiki>

A results fájban ennek kell megjelennie:
** There will be screenshots taken from every dialog

3 tesztet lefuttatva tesztelve a Writer, Math és Calc egy részét.
750MB méretű képernyő kép készült.
(pl. Calc teszt első fele 815 képernyő képet készített,
minden függvényről külön képernyőkép)

'''A testtool használata'''

A testtool indítása után, beállítások az Extra>Settings menüpont alatt,
a tesztelendő OOo program könyvtár, a scriptek könyvtárának, és a logok
könyvtárának beállítása.

Tesz script megnyitás File>Open, .bas kiterjesztésűek a tesztek, .res
kiterjesztésűek az eredmény fájlok, egy teszt fájl betöltése, F5
futtatás, de előtte győződj meg arról, hogy a tesztelendő OOo nem fut.
(win alatt gyorsindító legyen kikapcsolva)

Ha képernyővédő valakinek fut akkor az is legyen kikapcsolva
(az OOo fog képernyő védőként futni.)

''' Ha az OOo beindul nézz a címsorra:'''

<nowiki>„Untitled 1 - OpenOffice.org Writer TTS:localhost[12479]”</nowiki>

Ne dolgozz amíg a teszt fut, ne használd az egeret, a teszt leállását okozhatja.

'''A teszt eredmények elemzése:'''

Ne legyen narancs vagy piros szín az eredmény fájlban.

A teszt végének így kell kinéznie:

Date : 09/05/2006; Time: 02:57:20 PM; Duration : 0h 16m 33s

<nowiki>***************************************************</nowiki>

<nowiki>** No errors have occurred</nowiki>

<nowiki>** No warnings have occurred</nowiki>

<nowiki>** No warnings occurred during initialization</nowiki>

<nowiki>***************************************************</nowiki>

Ha hibát találsz egy tesztben futtasd újra, és ha reprodukálható
eredményt kapsz akkor lépj.

'''Linkek:'''

VCLTesttool letölthető innen, külön az összes támogatott platformra:

http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html

De az OOo telepíthető a testtollal, opcionálisan választható, így a
Basis/program könyvtárba települ.
Winre minimum kell: a testtool.exe és a testtool.ini, (linuxra: testtool
script és a .testtoolrc).

Wiki, az általános információkkal:
http://wiki.services.openoffice.org/wiki/VCLTesttool

A saját gépeden az eredmények közötti gyors keresést segíti, az alábbi
Java-program:

http://vcltesttoolglue.sourceforge.net/README.html

Általános információ:

http://qa.openoffice.org/qatesttool/OOo_testtool.pdf

Teszt scriptek írása:

http://qa.openoffice.org/qatesttool/OOo_tt_CookBook.pdf

A meglévő scriptek, buildenként, innen letölthetők:

http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/

Másik lehetőség a Mercurial (hg) használata:

hg clone http://hg.services.openoffice.org/DEV300 <munkakönyvtár>
cd <munkakönyvtár>

A megfelelő milestone (pl. OOO330_m3) checkout-olása:

hg update -rOOO330_m3

Az eredményeket ide lehet feltenni: http://quaste.services.openoffice.org/

A magyar hibák bejelenthetők az OpenScope.org-on is. [http://bug.openscope.org/secure/CreateIssue.jspa?pid=10006&issuetype=1|Bejelentés]

Infók a QUASTe-ről: [[QUASTe]]

Kiegészítő információ: [[VCLTesttool]]

[[Category:Magyar]]

Hu.openoffice.org/Minőségbiztosítás

2010-08-05T13:02:16Z

Timarandras: updated with screenshot info

Az OpenOffice.org minőségbiztosításának támogatására, a tesztelésére
egy automatizált eszköz került bevezetésre az elmúlt év során a VCLtesttool.
Ennek alkalmazására készülünk a magyar változat esetében is.

Az OOo 3.0.1_090109 változat teszteléséről készült [http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Minőségbiztosítás/Tesztelés Minőségbiztosítás - Tesztelés] összefoglaló, ahol az alábbiakban leírt testtool használatáról és a tesztelési eredményekről készült összefoglaló olvasható.

Az alábbi összefoglaló az OOo honlapján és a wikiben található információkat
foglalja össze.

A '''VCLTesttool''' egy különálló program az OOo felhasználói felület (GUI)
automatizált tesztelésére. A testtool TCP/P interfészen keresztül
kommunikál, és a összes a gépre, ill. helyi hálózatra telepített OOo
tesztelésére alkalmas. A teszteket Basicben írt scriptek tartalmazzák,
amelyek buildenként letölthető (link alul). A testtool scriptek akkor
működnek, ha az összes erőforrás (felhasználófelületi elem rendelkezésre
áll.) Használható MWS-ek és CWS-ek tesztelésére is.

A teszteket négy kategóriába sorolják:

0: Az összes build és minden változat esetében futtatandó tesztek

1: Az első build esetében futtatandó tesztek (plusz a 0-s összes)

2: A második build esetében futtatandó tesztek (plusz a 0-s összes)

3: A harmadik build esetében futtatandó tesztek (plusz a 0-s összes)

Nekünk a cat0 tesztek elégségesek lehetnek, a saját változat
tesztelésekor, majdnem az összes menüelemet és párbeszédablakot
megnyitják. Ha nagy probléma nélkül lefutnak akkor nem lehet baj.

A tesztek, öt perctől majd egy óra hosszúságúak.

(A QUASTe-n láthatók az idők, az összes teszt ~3 nap alatt lemehet)

A testtool beállítható úgy, hogy képernyő képet készít (BMP formában ~
500 kB/kép átlagosan) minden megnyitott dialógus ablakról, ez használható
annak ellenőrzésére, hogy a fordítás minden ponton megtörtént-e, igaz
elég sok emberi erőforrást igényel, manuális feldolgozást - minden
képernyőképet át kell nézni. Ehhez a testtolrc vagy a testtol.ini fájlba kell
betenni egy új sort:

Screenshot=1

A results fájban ennek kell megjelennie:
** There will be screenshots taken from every dialog

3 tesztet lefuttatva tesztelve a Writer, Math és Calc egy részét.
750MB méretű képernyő kép készült.
(pl. Calc teszt első fele 815 képernyő képet készített,
minden függvényről külön képernyőkép)

'''A testtool használata'''

A testtool indítása után, beállítások az Extra>Settings menüpont alatt,
a tesztelendő OOo program könyvtár, a scriptek könyvtárának, és a logok
könyvtárának beállítása.

Tesz script megnyitás File>Open, .bas kiterjesztésűek a tesztek, .res
kiterjesztésűek az eredmény fájlok, egy teszt fájl betöltése, F5
futtatás, de előtte győződj meg arról, hogy a tesztelendő OOo nem fut.
(win alatt gyorsindító legyen kikapcsolva)

Ha képernyővédő valakinek fut akkor az is legyen kikapcsolva
(az OOo fog képernyő védőként futni.)

''' Ha az OOo beindul nézz a címsorra:'''

<nowiki>„Untitled 1 - OpenOffice.org Writer TTS:localhost[12479]”</nowiki>

Ne dolgozz amíg a teszt fut, ne használd az egeret, a teszt leállását okozhatja.

'''A teszt eredmények elemzése:'''

Ne legyen narancs vagy piros szín az eredmény fájlban.

A teszt végének így kell kinéznie:

Date : 09/05/2006; Time: 02:57:20 PM; Duration : 0h 16m 33s

<nowiki>***************************************************</nowiki>

<nowiki>** No errors have occurred</nowiki>

<nowiki>** No warnings have occurred</nowiki>

<nowiki>** No warnings occurred during initialization</nowiki>

<nowiki>***************************************************</nowiki>

Ha hibát találsz egy tesztben futtasd újra, és ha reprodukálható
eredményt kapsz akkor lépj.

'''Linkek:'''

VCLTesttool letölthető innen, külön az összes támogatott platformra:

http://qa.openoffice.org/ooQAReloaded/AutomationTeamsite/ooQA-TeamAutomationBin.html

De az OOo telepíthető a testtollal, opcionálisan választható, így a
Basis/program könyvtárba települ.
Winre minimum kell: a testtool.exe és a testtool.ini, (linuxra: testtool
script és a .testtoolrc).

Wiki, az általános információkkal:
http://wiki.services.openoffice.org/wiki/VCLTesttool

A saját gépeden az eredmények közötti gyors keresést segíti, az alábbi
Java-program:

http://vcltesttoolglue.sourceforge.net/README.html

Általános információ:

http://qa.openoffice.org/qatesttool/OOo_testtool.pdf

Teszt scriptek írása:

http://qa.openoffice.org/qatesttool/OOo_tt_CookBook.pdf

A meglévő scriptek, buildenként, innen letölthetők:

http://ooopackages.good-day.net/pub/OpenOffice.org/qa/testautomation/

Másik lehetőség a cvs a régebbi változatokhoz:

cvs checkout -r DEV300_m29 -d testautomation_m29 testautomation

vagy svn-el a m32 óta:

svn checkout

svn://svn.services.openoffice.org/ooo/tags/DEV300_m32/testautomation

http://wiki.services.openoffice.org/wiki/OOo_and_Subversion

!!FIXME: most már hg van (hg.services.openoffice.org)

Az eredményeket ide lehet feltenni:

http://quaste.services.openoffice.org/

Infók a QUASTe-ről:

http://wiki.services.openoffice.org/wiki/QUASTe

Kiegészítő információ:

http://qa.openoffice.org/files/documents/77/3247/essen2006testtool2.pdf

[[Category:Magyar]]

Debugging

2010-03-27T10:01:27Z

Timarandras: /* How do I use the debug console ? */ fixed broken link

__TOC__
{{Template:Documentation/Linux|This section assumes use of [[wikipedia:GNU Debugger|gdb]], from the console. There are also specific notes on [[Windows Debugging]] or [[MacOSX_Debug_OpenOffice.org_using_XCode|graphical tools on Mac OS X]] and hints on [[Debug Build Problems|Build Problems Debugging]].}}

== Building with debugging symbols ==

OO.o includes a way to add debugging code in per module, via
the <code>build debug=true</code> command in each module.
This also adds lots of runtime assertions,
churning warnings etc. in addition to debug symbols - which
can be useful. To do just a plain build with debug symbols
though use <code>build debug=true dbg_build_only=true</code>
or in later versions use <code>build debug=true dbglevel=2</code> for max
output and dbglevel=1 or 0 for less output.

You can also configure OO.o with --enable-symbols to build with symbolic generation.

== gdb invocation ==

If you debug with gdb, you may find that execution stops due to signals at inappropriate locations, especially if running against libgcj and need to debug ignoring its [http://gcc.gnu.org/java/gdb.html garbage-collection]. Best invocation is...

<pre>
gdb ./soffice.bin
(gdb) handle SIGPWR nostop noprint
(gdb) handle SIGXCPU nostop noprint
(gdb) handle SIG33 nostop noprint
(gdb) run -norestore -writer
</pre>

replace -writer with -draw/-impress/-calc/... as appropriate. The -norestore option prevents display of the crash reporter (as one frequently kills office during debugging).

== The recommended .gdbinit file ==

You can add the <tt>handle</tt> commands from above to your <tt>~/.gdbinit</tt> to save some typing. Also you can define there macros to print the content of strings even in cases where dbg_dump() does not work. The following is such recommended <tt>~/.gdbinit</tt> file:

<pre>
set history filename ~/.gdbhistory
set history save on

handle SIGPWR nostop noprint
handle SIGXCPU nostop noprint
handle SIG33 nostop noprint

tabset 4

# define "pu" command to display sal_Unicode *
def pu
set $uni = $arg0
set $len = $arg1
set $i = 0
printf "\""
while (*$uni && $i++<$len && $i<255)
if (*$uni < 0x80)
printf "%c", *(char*)$uni++
else
printf "\\x%x", *(short*)$uni++
end
end
printf "\"\n"
end

# define "pus" command to display rtl_uString
def pus
set $ns = $arg0
if ($ns.buffer)
pu $ns.buffer $ns.length
else
print "Invalid/non-initialized rtl_uString."
end
end

# define "pou" command to display rtl::OUString
def pou
set $ns = $arg0
if ($ns.pData)
pus $ns.pData
else
print "Invalid/non-initialized OUString."
end
end

# define "ptu" command to display tools (Uni)String
def ptu
set $ns = $arg0
if ($ns.mpData)
pu $ns.mpData->maStr $ns.mpData->mnLen
else
print "Invalid/non-initialized tools String."
end
end
</pre>

With this, you can use <tt>pou the_OUString</tt> in gdb to print <tt>OUString</tt> named <tt>the_OUString</tt>, similarly <tt>pus the_rtl_uString</tt> for <tt>rtl_uString</tt> and <tt>pu the_p_sal_Unicode</tt> for <tt>sal_Unicode *</tt>. For tools's UniString (or just String for historical reasons) you can use <tt>ptu the_String</tt>

== Starting at the beginning ==

We start in 'main' with a sal wrapper, that calls
vcl/source/app/svmain.cxx (SVMain). It invokes Main on
pSVData->mpApp; but pSVData is an in-line local. To
debug this use the pImplSVData global variable. eg:

p pImplSVData->maAppData

This 'Main' method is typically: <code>desktop/source/app/app.cxx (Main).</code>

== Examining strings ==

We have [[Hacking#Can_I_get_a_char_.2A.2C_please.3F|already]] seen that OO.o has
its own set of string classes, none of which gdb understands.
You need to use:
<code>(gdb) print dbg_dump(sWhatEver)</code> to print the contents
of a UniString/ByteString/rtl::OUString/rtl::OString regardless
of the type when debugging C++ code. See Caolan's
[http://www.skynet.ie/~caolan/TechTexts/GdbUnicodePrinting.html write-up]
for details.

the functions <code>dbg_dump()</code> may not be available in gdb due to link. Just copy them in your current source file from '/sal/rtl/source/debug_print' and add the associated includes <code>#include <rtl/strbuf.hxx> #include <rtl/ustring.hxx></code>. gdb should recognize them now.

Another way is to use the macros from the [[Debugging#The_recommended_.gdbinit_file|recommended .gdbinit file]]. Unfortunately, so far works only for OUString, sal_Unicode *, and rtl_uString.

== Getting the build order right ==

The build dependencies of the modules are clearly crucial to
getting a clean build. When you type 'build' in a module, first
build examines prj/build.list, eg.<code>neon/prj/build.lst</code>:

xh neon : soltools external expat NULL

this specifies that 'soltools', 'external' and 'expat' have to
be satisfactorily built and delivered before neon can be built.
Occasionally these rules get broken, and people don't notice for
a while.

== It crashes, but only in gdb ==

What fun — you symlinked desktop/unxlngi4.pro/bin/soffice to
soffice.bin in your install tree didn't you. That works fine
if you just run it, but it seems gdb unpacks the symlink and
passes a fully qualified path as argv[0], which defeats the
hunting for the binary in the path, so it assigns the program
base path as <code>/opt/OpenOffice/OOO_STABLE_1/desktop/unxlngi4.pro/bin</code>
and starts looking for (eg. applicat.rdb) in there. Of course
when it fails to find any setup information, it silently
crashes somewhere else yards away from the original problem.

== It crashes, but doesn't crash ==

For various reasons signal handlers are trapped and life
can get rather confusing; thus it's best for builders to
apply something like this:

<pre>
--- sal/osl/unx/signal.c
+++ sal/osl/unx/signal.c
@@ -188,6 +188,8 @@ static sal_Bool InitSignal()
bSetILLHandler = sal_True;
}

+ bSetSEGVHandler = bSetWINCHHandler = bSetILLHandler = bDoHardKill = sal_False;
+
SignalListMutex = osl_createMutex();

act.sa_handler = SignalHandlerFunction;
</pre>

== I can't find the code from the trace ==

Some methods, are described as having a special linkage, such that
they can be used in callbacks; these typically have a prefix:
'LinkStub', so search for the latter part of the identifier in a
freetext search. eg.
<pre>
IMPL_LINK( Window, ImplHandlePaintHdl, void*, EMPTYARG )
</pre>

builds the 'LinkStubImplHandlePaintHdl' method.

== How can I re-build just the files I see in the trace ==

Often when you run gdb on a build without debugging symbols, you get an unhelpful gdb trace, but yet you can't afford the time/space to recompile all of OO.o with debugging symbols. Thus we have created a small perl helper, which will hunt for and touch files containing the symbols from your trace. This sub-set can then be re-built with debugging enabled for a better trace next time around:

<pre>
gdb ./soffice.bin
...
bt
#0 0x40b4e0a1 in kill () from /lib/libc.so.6
#1 0x409acfe6 in raise () from /lib/libpthread.so.0
#2 0x447bcdbd in SfxMedium::DownLoad(Link const&) () from ./libsfx641li.so
#3 0x447be151 in SfxMedium::SfxMedium(String const&, unsigned short, unsigned char, SfxFilter const*, SfxItemSet*) ()
from ./libsfx641li.so
#4 0x448339d3 in getCppuType(com::sun::star::uno::Reference<com::sun::star::document::XImporter> const*) () from ./libsfx641li.so
...
quit
cd base/OOO_STABLE_1/sfx2
ootouch SfxMedium
build debug=true
</pre>

Thus, all files referencing or implementing anything with SfxMedium will be touched, and hence rebuilt with debugging symbols.

[http://go-oo.org/developers/ooo-build/bin/ootouch ootouch] is not available upstream: it is available through ooo-build.

== How can I re-build all the files in one source directory ==

If you want to recompile the code in just your current directory, you can
use the killobj dmake target to remove the object files:

<pre>
dmake killobj
dmake
</pre>

== It always crashes in sal_XErrorHdl ==

You are a victim of asynchronous X error reporting;
<code>export SAL_SYNCHRONIZE=1</code> will make all the X traffic
synchronous, and report the error by the method that caused it,
it'll also make OO.o far slower, and the timing different.

== It silently fails to load my word file ==

Caolan suggests: put breakpoints in ww8par.cxx top and tail of
SwWW8ImplReader::LoadDoc, and confirm that the document gets as far
as the import filter.

A handy human place to put a breakpoint is in
SwWW8ImplReader::ReadPlainChars, you can see chunks of text as
they are read in. Alternatively SwWW8ImplReader::AppendTxtNode as
each paragraph is inserted.

== How do I use the debug console ? ==

So OO.o contains some hefty debugging infrastructure; pictured
[http://web.archive.org/web/20051219073043/go-oo.org/images/debug-window.png here]

Enabling it is pretty easy - what you need is a so-called [[Non_Product_Build|Non-Product Build]].

By default, an OpenOffice.org build is a Product Build, i.e. ready for release after completion. If you specify the <code>--enable-dbgutil</code> switch during <code>configure</code>, then your environment will be prepared for a [[Non_Product_Build|Non-Product Build]] - with lots of additional diagnostic tools.

Note that libraries from product and non-product builds are usually incompatible, so don't mix them in the same installation.

For available tools in non-product builds, have a look at the various <code>DBG_foo</code> macros in <code>tools/debug.hxx</code>, or, if you already are knowledgeable about this, let others participate by writing your knowledge down here.

To actually fire up the debug settings dialog, press <ctrl><alt><shift>-D.

== Draw/Impress text edit debugging ==

When running a [[Non_Product_Build|Non-Product Build]], live edit mode in Draw/Impress text boxes has an extra debug hotkey: pressing <ctrl><alt>-F2 writes information about the currently edited text into a debug.log file (currently Windows-only).

== Excel Interop debugging ==

To dump the contents of binary MS Excel files while loading them into OpenOffice.org, first get a local copy of the code module "oox". Then:
* XLS files (BIFF2-BIFF8): define the environment variable <code>OOO_BIFFDUMPER</code> pointing to file://..../oox/source/dump/biffdumper.ini (full path needed). Then run <code>soffice.bin foo.xls</code> and you should get a foo.xls.dump directory in the same directory with the debug data in it. The new directory will contain the complete storage structure with all original streams, and the decoded streams with ".dump" suffix.
* XLSX, XLSM, XLSB files: define the environment variable <code>OOO_XLSBDUMPER</code> pointing to file://..../oox/source/dump/xlsbdumper.ini (full path needed). Then run <code>soffice.bin foo.xlsb</code>. XML streams will be pretty-printed, and known binary streams (e.g. the VBA project, and the streams used in XLSB format) are decoded.
* also PPTX, PPTM files are supported: define the environment variable <code>OOO_PPTXDUMPER</code> pointing to file://..../oox/source/dump/pptxdumper.ini (full path needed). Then run <code>soffice.bin foo.pptx</code>.

Note: this requires a debug build of the <code>oox</code> module. To easily get such a build, execute the following within your <code>sc</code> directory: <code>build -- killobj ; build debug=true</code>

== The trace shows a crash in 'poll' ==

OO.o is a fairly threaded program, you're probably just looking at the wrong thread: there are not likely to be bugs in poll. Use <code>thread apply all backtrace</code> to get a backtrace of all threads - this will most likely fail. When it does do: <code>thread 1</code> then <code>bt</code> - most crashers occur in the 'main' thread.

== What does this trace mean ? ==

There are several typical stack-traces that come up again
and again, one would be:

<pre>#15 0x4164a501 in raise () from /lib/tls/libc.so.6
#16 0x4164bcd9 in abort () from /lib/tls/libc.so.6
#17 0x415fb5a5 in std::set_unexpected ()
from /home/mnagashree/m72install/program/libstdc++.so.5
#18 0x415fb5e2 in std::terminate ()
from /home/mnagashree/m72install/program/libstdc++.so.5
#19 0x415fb69c in __cxa_rethrow ()
</pre>

This section of trace means (essentially) that an
exception was thrown - but there was no-one trying to
catch it. Often this means there was a missing
'try {} catch()' clause in one of the calling frames.

A great way to debug exceptions is to add a breakpoint
in catch/throw, do this with <code>catch throw</code> or
<code>catch catch</code> in gdb.

== Useful places to put breakpoints ==

If you have compiled with debugging enabled: <code>build debug=true</code> it is possible that you get some nice churning debug / assertion failure - and you want to get a pleasant & detailed stack-trace: to do that do
<code>break osl_assertFailedLine</code>.

== STLport and checking iterators ==

The STL is a powerful tool but it also makes it easy - in the grand old C/C++ tradition - to shoot one selves in the foot, as we all know. STL containers and algorithms are now pervasive in OOo, so there is a need to validate the use of STL constructs in OO.o to find hidden problems.

Fortunately the [http://www.stlport.org/ STLport library] - the default STL implementation for OO.o - has a powerful debug mode, and it's easy to use. Since SRC680 m128 it is possible to use the environment variable <code>USE_STLP_DEBUG</code> to switch on the STLport debug mode, since SRC680 m150 it works for Windows, too

The most useful part of the STLport debug mode is iterator checking. Doing the OO.o smoke test and some little additional random testing we already found a number of questionable STL constructs.

Only code paths which are exercised will be tested by the STLport debug mode, though. If STLport finds a questionable STL usage it will throw an assertion and terminate. It is usually quite easy to extract a precise stack trace.

Some notes:
* STLport debug mode iterators are no pointers! We've cleaned up all occurrences of the lazy - and wrong - usages of iterators as pointers in SRC680 m128/m150, but maybe something new has already crept in. This clean up also helps with other STL implementations, like the one which comes with gcc-4.x
* A complete recompile is necessary, the debug modes renders all objects with STL constructs binary incompatible
* The STLport debug mode breaks the complexity assertions of the STL. Theoretically some operations should be much slower in debug mode than in product mode. In practice I didn't notice a real slowdown of OO.o.

[[Category:Development]][[Category:Build_System]]

Windows Debugging

2010-03-25T13:10:33Z

Timarandras: updated link to sysinternals tools

This is [[Windows]]-specific debugging information. There are also generic notes on [[Debugging]].
[[Category:Development]]
[[Category:Windows]]
== General notes ==

You want to debug soffice.bin, as soffice.exe loads that in a separate process. You can copy soffice.bin to sofficebin.exe if it has to be called ".exe" for your debugger.

== Debugging with Visual Studio ==

=== Debugging a non-debug exe ===

Problems tend to raise exceptions, you want to catch them before the exception happens. Run sofficebin.exe in the debugger and look at the Output window. Exceptions look like this:

First-chance exception at 0x7c81eb33 in sofficebin.exe: Microsoft C++ exception: com::sun::star::uno::RuntimeException @ 0x00e1e690.

0x7c81eb33 is the address of the instruction following the call to raise the exception. Go to this address in the disassembler, find the instruction before (which will be a call instruction), and set a break point there.

Then when an exception occurs, you can see in the call stack where it is coming from.

=== Visualizers for STL containers ===

See [[VisualStudioVisualizer]] for examples how to "visualize" the contents of STL containers and iterators in the Visual Studio debugger.

== Debugging with gdb ==

This is currently not working. Trying to debug soffice.bin ends up with a segmentation fault. Any suggestions appreciated!

== Stderr and stdout ==

Using normal command-line in Windows, you cannot see the standard out or standard error. The trick is to start OOo (soffice.exe) from cygwin. You can easily pipe stderr (<tt>soffice.exe 2> log.txt</tt>) or stdout (<tt>soffice.exe >log.txt</tt>) to a file.

== Other useful stuff ==

* [http://technet.microsoft.com/en-us/sysinternals/bb896645.aspx Process Monitor]

[[Category:Development|Debugging on Windows]]

Hu.openoffice.org/Magyar Ispell hibabejelentés

2009-11-08T11:55:22Z

Timarandras: version update (1.5)

[[Category:felül]]
[[Category:Magyar]]

Ezen az oldalon a [http://magyarispell.sourceforge.net Magyar Ispell szótár] 1.5-ös verziójának hibáit, hiányzó szavait lehet jelezni.

Magyar Ispell dictionary bug report page: leave a message about your problem with Hungarian spell checking dictionary [http://magyarispell.sourceforge.net Magyar Ispell].

== Használat ==
A + fülre kattintva lehet új témakört kezdeni. Kettősponttal vagy -pontokkal kezdve a bejegyzésünket, a válasz szintjét lehet jelölni. A hibás vagy hiányzó szót külön sorba, szóközzel kezdve adjuk meg, hogy ilyen keretben jelenjen meg:
példa

A bejegyzéseink végét mindig négy hullámvonallal zárjuk le, ennek hatására megjelenik a nevünk és az aktuális dátum: <pre>~~~~</pre>

A [[Talk:Hu.openoffice.org/Magyar_Ispell_hibabejelent%C3%A9s|vitalapon]] találjuk a visszautasított javaslatokat.

==Fel nem ismert szavak==

Kármán Tódor (vagy manapság: Kármán Irén)
szöveghű, formahű
ligandum, detergens, tautomer, elektroforézis, nukleofil
lantanidák, aktinidák
[[User:Joghurt|Joghurt]] 00:09, 4 June 2008 (CEST)

Bercsényi
Irinyi
Háros
Lehár
Szinyei(-Merse)
Tildi
[[User:Joghurt|Joghurt]] 12:24, 7 November 2008 (CET)

===Földrajzi nevek===

Kaszásdűlő
Nagyhideg-hegy

==== ISO 3166 ====
Anguilla
Aruba
Belize
Bissau-Guinea
Bissau-guineai
Bolivári
Bouvet-sziget
Burkina Faso
Caicos-szigetek
Cocos
Dahomey
Darussalam
Déli-Sandwich-szigetek
Futuna
Grenadines-szigetek
Guadeloupe
Guam
Guernsey
Hasemita
Heard-sziget
Jamahiriya
Johnston-atoll
Keeling
Kitts
Malvinas
Man
San Marinó
Martinique
Mauritius-i
Mayen-sziget
Mayotte
McDonald-szigetek
Midway-atoll
Miquelon
Nauru
Nevis
Niue
Niuei
Norfolk-sziget
Palau
Palaui
Pitcairn-szigetek
Príncipe
Saint-Pierre
Seychelles-szigetek
Svalbard-szigetek
Szaudi-iraqi
Szikkim
Szomáli Demokratikus Köztársaság
Tokelau-szigetek
Vanuatu
Wake-sziget

--[[User:Kkemenczy|Kkemenczy]] 13:33, 17 September 2007 (CEST)

===Nyelvek===
====ISO 639====
acsehnéz
acsoli
adangme
afar
afrihili
afro-ázsiai
ainu
ajmara
akan
akkád
aleman
aleut
algonkin
alsónémet
alsószász
amhara
angiká
arapaho
asszami
asztúriai
atapaszka
ausztroázsiai
avadhí
avesztai
bali
bambara
bamileke
basza
batak
bedzsa
beludzs
bemba
bhasa
bhódzspuri
bihári
bikol
bini
biszlama
blin
bokmal
bradzs
bugisz
conga
cornwalli
creek
csagatáj
csami
csamorro
csejenn
cseva
csibcsa
csicseva
csimsi
csinúk
csippevéj
csoktó
csuang
csvana
dargva
dayak
delavár
dimilí
dimli
divehi
djula
dogri
dogrib
duala
dzongkha
dzsuang
edo
efik
ekajuk
elámi
erzija
eve
evondo
északszoto
fang
filipino
főníciai
friuli
ful
fülöp-szigeteki
ga
ganda
gayo
gbaya
geez
gikuju
Gilbert-szigeti
gorontalo
grebo
guarani
gudzsaráti
guichin
haida
hausza
herero
hiligaynon
himacsali
hiri-motu
hmong
hupa
iban
ido
idzso
igbo
ilokano
inari
indoárja
indo-európai
ingus
interlingua
interlingva
inuktitut
inupiak
jao
ji
jingpo
joruba
judeoarab
judeoperzsa
jupik
kabil
kaddó
kalaallisut
kamba
kannada
kanuri
karacsáj-balkár
karakalpak
karen
kasub
kavi
kecsua
khaszi
khotani
kikuju
kimbundu
kinyarvanda
kirdkí
kirmándzskí
klingon
ko
koiszan
koltta
kongo
kosrae
kónkáni
közép-utó
kpelle
krí
kru
kuanyama
kumük
kurukh
kutenai
kúsita
kwanyama
ladino
lahndá
lamba
land
lao
lezg
limburgi
lingala
lojban
lozi
luba-katanga
luba-lulua
luiseno
lulei
luo
lushai
macedoromán
madurai
magahí
mahaók
maithili
makassari
malagas
malajálam
maldív
mandar
manding
manipuri
manobo
manx
mapucse
mapundungu
maráthi
marwari
maszai
mende
mikmak
minangkabau-maláj
mirandese
moldáv
mongo
mon-khmer
mossi
munda
nauru
navaho
ndebele
ndonga
newari
nias
niger-kordofáni
niue
nílus-szaharai
nogaj
núbiai
nzime
nyamvezi
nyandzsa
nyankore
nyasa
nynorsk
nyoro
ojrát
okcitán
orija
oromo
oszag
otomi
ozsibva
óegyiptomi
ófrancia
óír
pahlavi
palau
pampanga
pandzsábi
pangaszinam
papiamentu
pasto
pedi
pidzsin
ponapei
prákrit
radzsasztáni
rapanui
rarotonga
romani
sepedi
shan
siksika
sino-tibeti
sona
sumér
szalis
szandave
szango
szantáli
szaszak
szebuano
szelkup
szerer
szidámo
szimhala
szindhi
szogd
szomáli
szongai
szoninke
szoto
szranan
szukuma
szuszu
szvázi
tagalog
tamasek
telugu
temne
terena
tetum
tigré
tigrinya
tiv
tlingit
tokelau
tonga
tongo
tukíz
tumbuka
tupi
tuvai
tuvalu
türkmen
tvi
ugariti
umbundu
vai
vakas
valamo
vasho
venda
volapük
vót
waray
wolof
xhosza
yap
zande
zapoték
zázá
zázáki
zenaga
zunyi

--[[User:Kkemenczy|Kkemenczy]] 13:33, 17 September 2007 (CEST)

Ezek egy része nem jó (pl. türkmen→türkmén, sumér→sumer), és sok a gyanús alak (maszai→maszáj?).
Nagy része viszont egy külön idegen szavak modulba mehet, mert elég ritkák. (A Hunspell 1.2.2 már támogatja a
külön modulok egyidejű használatát, és az OpenOffice.org-ba is szeretném ezt megoldani a
közeljövőben.) [[User:Nemeth|Nemeth]] 10:03, 22 February 2008 (CET)

===Pénznemek===
====ISO 4217====
anga
ariary
arubai
austral
baht
balboa
Belize-i
boliviano
bolívar
bosznia-hercegovinai
cedi
colón
córdoba
cruzado
cruzeiro
dirham
dram
ECU
ekwele
emírségekbeli
equadori
florin
fomento
gourde
guarani
guilder
Guinea-Bissau-i
hrivnya
Szent Ilona-i
jamaikai
jordán
jüan
karbovanec
kelet-karib
kina
kip
komorei
kuna
kwacha
kwanza
kyat
lari
lek
lempira
leone
Leone-i
leu
lev
leva
lilangeni
litas
loti
maldív-szigeteki
maloti
manat
naira
nakfa
ngultrum
ouguiya
pa
pataca
peso
pol
pot
Príncipe-i
pula
quetzal
rand
reajustado
real
rial
riál
Rica-i
riel
ringgit
riyál
rodéziai
Salvador-i
Seychelles-szigeteki
sol
sucre
syli
Szaud-arábiai
szom
szomoni
szurinámi
taka
tala
talonas
tenge
Tobago-i
tolár
tugrik
vanuatui
vatu
vietnámi
won
zlotyi

--[[User:Kkemenczy|Kkemenczy]] 13:33, 17 September 2007 (CEST)

===Vegyes===
klakk (régies: fizetett taps)

kihúnyásuk helyett „kihunyásük”-öt javasol
:A prefixumok kezelésének hiánya a toldalékolt alakoknál, ami az utóbbi pár változatban került bele a Hunspellbe sejtésem szerint. Pontosabban a kettős toldalékolásnál (-ás-uk) jelentkezik ez a hiányosság. [[User:Nemeth|Nemeth]] 01:54, 9 May 2007 (CEST)

sárülés
elfogadja, pedig sérülést akartam írni. áé tévesztés gyakori. [[User:Timarandras|Timarandras]] 11:50, 23 May 2007 (CEST)
: Ha sikerülne az Aspell hiányzó tulajdonságainak megvalósítása a Hunspellben, amit tervezek, akkor a billentyűzet kiosztása is tárolásra kerülne, és akkor azt a REP-hez hasonlóan fehasználnám az összetett szavak ellenőrzésénél. [[User:Nemeth|Nemeth]] 10:58, 14 June 2007 (CEST)
:: Sikerült, de mégsem használtam fel, mert túl sok helyes alakzatot tiltanánk le vele. [[User:Nemeth|Nemeth]] 18:25, 11 September 2007 (CEST)

[[User:Timarandras|Timarandras]] 20:31, 21 August 2007 (CEST)

gyorsítótárazva

--[[User:Kkemenczy|Kkemenczy]] 13:36, 17 September 2007 (CEST)

előtető
rtg.
dugalj
szelemen
felületkezelve
növényegészségügyi
[[User:Fg|Fg]] 15:15, 1 February 2008 (CET)
: növény-egészségügyi (7 szótag, 3-as összetétel) [[User:Timarandras|Timarandras]] 13:16, 6 February 2008 (CET)

előttre
[[User:Timarandras|Timarandras]] 13:16, 6 February 2008 (CET)

koordinátarendszer

Itt kötőjelezést javasol, noha ez igazából kéttagú szóösszetétel.

[[User:Joghurt|Joghurt]] 12:23, 22 May 2009 (UTC)

Dictionaries

2009-11-08T11:44:13Z

Timarandras: /* Hungarian (Hungary) */ updated

This page lists spell checker dictionaries, hyphenation files, and thesauri for OpenOffice.org 2.x.

'''IMPORTANT NOTE: From OpenOffice.org 3.0 on the dictionary wizard is no longer available -- Dictionaries are now available via [http://extensions.services.openoffice.org/dictionary the extensions repository]'''. See [[Extension Dictionaries]] for how to create dictionary extensions. As an end-user this page is now only useful for those using OpenOffice.org < 3.0, though it still has a role for aiding Linux distribution packagers in collecting what un-bundled linguistic extensions are available.

'''To install a new dictionary in Vanilla OpenOffice.org 2.x, call "File -> Wizards -> Install new dictionaries" in OpenOffice.org. Then exit and re-start OpenOffice.org, including the Quickstarter (if used).''' Most of the files on this page are available for installation via the wizard. If not, download the Pack file, and use the "off-line language installation" option of [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/dicooo/DicOOo.sxw DicOOo wizard].

One user notes: If you have the "wrong" dictionary installed and spell check and other features cannot be supported, you will not receive any warning or notification. At best you can type some gibberish and see if it is underlined, if auto-correct is enabled. Download dictionaries (from the new extensions mechanisms detailed below, not the Web site listed in the help), and change settings in the various dialogues (sorry, not sure which one, there are several language related dialogues) until things work again. However, this didn't work for me but if you have the settings of the majority (eg US English) maybe you won't have to bother.

'''OpenOffice.org dictionaries in Fedora.'''
In Fedora to install OpenOffice.org, you can use the "Add/Remove Software" application, or you can do this from the command line with e.g. "yum install openoffice.org-writer". Additional language support can then be installed using something like "yum install openoffice.org-langpack-fr" to install French language support which will automatically include spell-checking support where available. A list of currently installed and available language packs can be seen using "yum list openoffice.org-langpack*". Additional dictionaries can also be installed separately using yum, e.g. yum install hunspell-fr.

'''OpenOffice.org dictionaries wizard in Ubuntu.'''

If the window is too small when using the File>Wizards>Install new dictionaries then make sure visual effects (compiz) are disabled (that is: change from "Extra" or "Normal" to "None" in Ubuntu System | Settings | Appearance | Visual Effect tab).
In order to use this wizard in '''Ubuntu''' (tested on Kubuntu 7.10) you need to have the package '''openoffice.org''' installed in addition to standard installation of open-office.org-writer and open-office.org-calc. You can do this by typing '''sudo apt-get install openoffice.org'''

'''Adding Resources'''

Please use [http://extensions.services.openoffice.org/ the extensions repository] -- the resources listed on this page refer to ftp.services.openoffice.org, which will not be maintained anymore.

'''OpenOffice.org dictionaries in Gentoo.'''

To install a dictionary, execute the following command as root:

emerge myspell-<lang>

Start OpenOffice. Open Tools -> Options -> Language Settings -> Languages. From the drop-down menu under "Default languages for documents" select a language whose dictionary you've installed.--[[User:Dnt2wiki|Dnt2wiki]] 19:33, 30 September 2008 (CEST)

'''All Language Packs: [http://de.openoffice.org/downloads/quick.html?platform=dicooofull PackFull] (58MB) Sep 14 2007''' Download the pack_full zip if you want to redistribute all available dictionaries in your network. Download page is in German, just click the button "Download starten" to get the file. A mirror will be chosen automatically.

'''Tools for dictionary developers''':
 Spellchecker: [http://hunspell.sourceforge.net Hunspell].
 Hyphenator: [http://sourceforge.net/project/showfiles.php?group_id=143754&package_id=231949 Hyphen].
 Thesaurus: [http://lingucomponent.openoffice.org/MyThes-1.zip OpenOffice.org MyThes].
 Grammar checker: [http://www.languagetool.org LanguageTool] and [http://extensions.services.openoffice.org/project/lightproof Lightproof].

More information on the file formats of dictionaries can be found on the [http://lingucomponent.openoffice.org/ Lingucomponent Project homepage].

== Afrikaans (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/af_ZA.zip Spelling] 2006-01-17
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/af_ZA-pack.zip Pack] 2006-01-17
* [http://translate.org.za/download/spellchecker/afrikaans/ Spelling, Pack, Word lists (Experimental/Development)]

== Amharic (Ethiopia) ==
* [http://hunspell.sourceforge.net/am-demo.tar.gz Spelling] 2004-12-28

== Arabic (North Africa and Middle East) ==
* [http://downloads.sourceforge.net/ayaspell/hunspell-ar_20080110.tar.gz Spelling] (hunspell-ar from [http://ayaspell.sourceforge.net/ ayaspell project]) 2008-01-10
* [ftp://foolab.org/pub/software/arspell/20060329/ar.zip Spelling] (Simple word list) 2006-03-29
* [http://hunspell.sourceforge.net/buckwalter_morphan_1_hunspell_patch.tar.gz Spelling] (Conversion of Buckwalter's Arabic morphological analyser) 2006-02-08

== Armenian (Eastern) ==
* [http://downloads.sourceforge.net/armspell/myspell-hy-0.10.1.tar.gz Spelling] ([http://sf.net/projects/armspell Armspell Project], 0.10.1 - 2007-08-18)

== Azerbaijani (Azerbaijan, Iran) ==
* [http://hunspell.sourceforge.net/az-demo.tar.gz Spelling] 2004-08-17

== Basque ==
* [http://www.euskara.euskadi.net/r59-738/es/contenidos/informacion/euskarazko_softwarea/es_9568/lista.html Spelling] 2006-10-06 (note: use ANY country code in dictionary.lst, see documentation. anther note: license is absent in the package, so at least some distributions avoid including of this package. Consider adding AUTHORS and License files in this package.)

== Belarusian (Belarus ) ==
* [http://pravapis.info/spell/dict/ooo-official.zip Spelling(official orthography)] 2008-11-17
* [http://pravapis.info/spell/dict/ooo-classic.zip Spelling(classic orthography)] 2008-11-17

== Bengali (Bangladesh, India) ==
* [http://www.ankur.org.bd/downloads/spell_check/hunspell/hunspell-bn-BD-0.02.tar.bz2 Spelling] (version 0.02) 2008-02-01 ([http://ankur.org.bd/wiki/Documentation#OpenOffice.org ankur.org.bd])

== Bulgarian (Bulgaria) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/dictionaries-bg Extension]
* [http://sourceforge.net/project/showfiles.php?group_id=52198 Spelling] 2007-12-11
* [http://sourceforge.net/project/showfiles.php?group_id=52198 Hyphenation] 2007-12-11
* [http://sourceforge.net/project/showfiles.php?group_id=52198 Thesaurus] 2007-12-11

== Catalan ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ca_ES.zip Spelling] 2002-10-15
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ca_ES-pack.zip Pack] 2002-10-15

== Chichewa (Malawi) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ny_MW.zip Spelling] 2005-01-08

== Coptic (North Africa) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/copt_dict Extension]
* [http://www.moheb.de/coptic_proofing.html Spelling] 2006-05-29

== Croatian (Croatia) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hr_HR.zip Spelling] 2006-06-07
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hr_HR-pack.zip Pack] 2006-06-07

== Czech (Czech Republic) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/cs_CZ.zip Spelling] 2003-01-01
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_cs_CZ.zip Hyphenation] 2003-12-27
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_cs_CZ.zip Thesaurus] (for OpenOffice.org 1.x) 2004-08-20
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_cs_CZ_v2.zip Thesaurus] (for OpenOffice.org 2.x) 2007-09-26
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/cs_CZ-pack.zip Pack] 2004-08-20

== Danish (Denmark) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_da_DK.zip Hyphenation] 2007-09-03
* [http://www.stavekontrolden.dk Pack] 2008-02-20

== Dutch (Netherlands) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/nl_NL.zip Spelling] 2007-06-07 (OpenTaal 1.00G) Note: this is not the [http://extensions.services.openoffice.org/project/dict-nl latest version]
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_nl_NL.zip Hyphenation] 2005-06-17
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/nl_NL-pack.zip Pack] 2005-07-20 (contains older spelling dictionary)

== English (AU,CA,GB,NZ,US,ZA) ==
* Spelling:

** [http://en-gb.pyxidium.co.uk/dictionary/en_GB.zip English (United Kingdom)] 2006-11-30
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_US.zip English (United States)] 2006-02-07
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_AU.zip English (Australia)] 2003-03-29 by Kelvin Eldridge (Australian dictionary creator and maintainer). Latest dictionary (2008-12-18) available from Kelvin's site [http://www.JustLocal.com.au www.JustLocal.com.au]. Scroll to the bottom of the page and click on Australian spell check dictionary files. Also OpenOffice.org 3 version. Commercial software fee payable.
** [http://chenopod.net/dnw/en_AU.zip English (Australia)] 2008-09-25 (OpenSource, no charge, updated 2 Oct. 2008)
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_CA.zip English (Canada)] 2002-03-15
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_NZ.zip English (New Zealand)] 2002-05-18
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_ZA.zip English (South Africa)] 2006-01-20
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_GB-oed.zip English (OED English)] 2005-06-13
* Hyphenation:
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_en_GB.zip English (United Kingdom)] 2002-07-27
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_en_US.zip English (United States)] 2002-07-27
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_en_CA.zip English (Canada)] 2002-07-27
* Thesaurus:
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_en_US_v2.zip English (United States & United Kingdom)], requires OpenOffice.org 2.x or later, 2006-03-06
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_EN-pack.zip Pack] 2003-11-05

== Esperanto (anywhere) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/eo.zip Spelling] 2004-11-29
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/eo-pack.zip Pack] 2004-11-29

== Estonian (Estonia) ==
* [http://www.meso.ee/~jjpp/speller Spelling] 2003-06-02
* [http://www.meso.ee/~jjpp/speller Hyphenator]

== Faroese (Faroe Islands) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fo_FO.zip Spelling] 2005-03-07
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fo_FO-pack.zip Pack] 2005-01-15

== Persian (Iran) ==
*[http://hunspell.sourceforge.net/fa-demo.tar.gz Spelling] 2005-07-26

== Fijian (Fiji) ==
* [http://www.iosn.net/pacific-islands/usp-microgrants/fijian-spellchecker See iosn.net] 2005-08-11

== Finnish (Finland) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fi_FI.zip Spelling] 2002-11-20
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_fi_FI.zip Hyphenation] 2004-04-10
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fi_FI-pack.zip Pack] 2004-04-11

'''NOTE: Hunspell is not capable of handling Finnish language properly, so these dictionaries should not be used. Instead, [http://voikko.sourceforge.net/ Voikko] project should be used, either via [http://www.abisource.com/projects/enchant/ Enchant] (a recommended spell-checking library for any project, supports also hunspell) or directly in OOo via openoffice.org-voikko provided by the project also.'''

== French (France, ...) ==

'''[http://www.dicollecte.org/ The French project: Dicollecte]'''

About the new french spelling, please read: [http://en.wikipedia.org/wiki/Reforms_of_French_orthography Reforms of French orthography (en)], [http://www.renouvo.org/regles.php Réforme de l'orthographe (fr)] and [http://www.orthographe-recommandee.info/index.htm Orthographe recommandée (fr)]

{| width="66%" cellpadding="0" cellspacing="0"
|-
! bgcolor="#c0e0ce" style="padding: 6px 10px 3px 10px; text-align: left;" | '''OpenOffice.org 3.x''' extensions
|-
| style="border: 2px solid #c0e0ce; padding: 10px" bgcolor="#f0fff0" |
{| border="0" cellpadding="0" cellspacing="0" style=" background-color: #f0fff0"
|-
| * [http://extensions.services.openoffice.org/project/french-dictionary-classic-reform1990 Classic & Reform 1990 Spelling ]
|-
| * [http://extensions.services.openoffice.org/project/french-dictionary-classic Classic Spelling]
|-
| * [http://extensions.services.openoffice.org/project/french-dictionary-reform1990 Reform 1990 Spelling]
|}
|}

{| width="66%" cellpadding="0" cellspacing="0"
|-
! bgcolor="#ddddff" style="padding: 6px 10px 3px 10px; text-align: left;" | '''OpenOffice.org 2.x'''
|-
| style="border: 2px solid #ddddff; padding: 10px" bgcolor="#f3f3ff" |
{| border="0" cellpadding="0" cellspacing="0" style=" background-color: #f3f3ff"
|-
| * [http://www.dicollecte.org/download.php?prj=fr Latest dictionaries]
|-
| * You can also get them in OOo with Menu File -> Wizards -> Install new dictionaries
|}
|}

{| width="66%" cellpadding="0" cellspacing="0"
|-
! bgcolor="#faf9b2" style="padding: 6px 10px 3px 10px; text-align: left;" | '''Deprecated dictionaries'''
|-
| style="border: 2px solid #faf9b2; padding: 10px" bgcolor="#ffffec" |
{| border="0" cellpadding="0" cellspacing="0" style=" background-color: #ffffec"
|-
| * [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fr_FR-pack.zip Pack] (old versions) 2005-06-09
|}
|}

== Frisian (Netherlands) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fy_NL.zip Spelling] (version 0.12) 2007-11-28
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fy_NL-pack.zip Pack] (version 0.11) 2007-02-22

== Friulian (Italy) ==
* [http://digilander.libero.it/paganf/coretors/myspell-fur-12092005.zip Spelling] 2005-09-12 [http://digilander.libero.it/paganf/coretors/dizionaris.html home page]



== Galician (Spain) ==

Made by Frco. Javier Rial in [http://www.mancomun.org Mancomun.org]

* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/gl_ES.zip Spelling] 2008-05-16 Hunspell version.
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/gl_ES-pack.zip Pack] 2008-05-16 Hunspell version.

* [http://extensions.services.openoffice.org/project/Extension_Corrector_galego_OOo Extensión co corrector de Hunspell para o OpenOffice.org 3] (2008-05-15).

* [http://extensions.services.openoffice.org/project/Extension_Guionizador_galego_OOo Extensión co guionizador para o OpenOffice.org 3] (2009-02-09).

== Gascon (France) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/gsc_FR.zip Spelling] 2007-08-16 Contributed by [http://www.pernoste.com Per Noste]
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/gsc_FR-pack.zip Pack] 2007-08-16

Requires OOo 2.1 or later

== German (Germany, ...) ==
* '''OpenOffice.org 3.x Extensions (Spelling dictionaries, Hyphenation, Thesaurus)''':
** [http://extensions.services.openoffice.org/project/dict-de-DE_frami Extension "German (de-DE-frami) dictionaries: spell checking, hyphenation, thesaurus" for locale Germany de-DE] (recommended), by Franz Michael Baumann, an extended version of Björn Jacke's dictionary, 2009-02-21
** [http://extensions.services.openoffice.org/project/dict-de_CH_frami Extension "German (de-CH-frami) dictionaries: spell checking, hyphenation, thesaurus" for locale Switzerland de-CH] (recommended), by Franz Michael Baumann, an extended version of Björn Jacke's dictionary, 2009-02-21
** [http://extensions.services.openoffice.org/project/dict-de_AT_frami Extension "German (de-AT-frami) dictionaries: spell checking, hyphenation, thesaurus" for locale Austria de-AT] (recommended), by Franz Michael Baumann, an extended version of Björn Jacke's dictionary, 2009-02-21
** [http://extensions.services.openoffice.org/project/dict-de Extension "German dictionary, hyphenation patterns and thesaurus" for locales de-DE, de-AT and de-CH], by Björn Jacke, 2008-07-09
* '''Spelling Dictionaries:''' The new orthography dictionary with compound word support is shipped with OpenOffice.org since version 2.0.2. Its quality currently suffers from OpenOffice.org [http://qa.openoffice.org/issues/show_bug.cgi?id=64400 issue 64400].
** Recommended version (requires OpenOffice.org 2.0.2 or later):
*** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/de_DE_frami.zip German (Germany], [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/de_CH_frami.zip Switzerland], [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/de_AT_frami.zip Austria]) by Franz Michael Baumann, an extended version of Björn Jacke's dictionary, 2009-02-21
** Others versions:
*** [http://www.j3e.de/hunspell/ German (Germany, Switzerland, Austria)] by [http://www.j3e.de/ Björn Jacke] latest snapshots of the hunspell dictionary derived from [http://www.j3e.de/ispell/igerman98/ igerman98], requires OpenOffice.org 2.0.2 or later
*** [http://www.j3e.de/myspell/ German (Germany)] by [http://www.j3e.de Björn Jacke] This is a dictionary in myspell format used up to OpenOffice.org 2.0.1, 2003-06-17
*** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/de_DE_comb.zip German (Germany - mit Komposita, alte & neue Rechtschreibung gemischt)] by [http://tkltrans.sourceforge.net/spell.htm Eleonora] This is a dictionary in myspell format used up to OpenOffice.org 2.0.1, 2005-06-10
*** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/de_DE_neu.zip German (Germany - mit Komposita, neue Rechtschreibung)] by [http://tkltrans.sourceforge.net/spell.htm Eleonora] This is a dictionary in myspell format used up to OpenOffice.org 2.0.1, 2005-06-10
* '''Hyphenation:'''
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_de_DE.zip German (Germany)] 2006-01-20
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_de_CH.zip German (Switzerland)] 2006-01-20
* '''Thesaurus''' (get the latest version from [http://www.openthesaurus.de OpenThesaurus]):
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_de_DE_v2.zip German (Germany)], requires OpenOffice.org 2.x or later, 2008-01-05
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_de_CH_v2.zip German (Switzerland)], requires OpenOffice.org 2.x or later, 2008-01-05
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/de_DE-pack.zip Pack] 2005-11-02

== Greek (Greece) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/el_GR.zip Spelling] 2004-12-20
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_el_GR.zip Hyphenation] 2005-10-18
* [http://www.ellak.gr/pub/oo_extras/th_el.zip Thesaurus] 2007-04-12
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/el_GR-pack.zip Pack] 2004-09-01

== Gujarati (India) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/gu_IN.zip Spelling] 2006-10-15

== Hawaiian (United States) ==
* [http://borel.slu.edu/ispell/haw_US.zip Spelling] 2009-04-06

== Hebrew (Israel) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/he_IL.zip Spelling] 2005-01-12

== Hindi (India) ==
* [http://hunspell.sourceforge.net/hi-demo.tar.gz Spelling] 2005-01-27
* [http://devendraparakh.port5.com/ HindiWriter] includes a Hindi Spell Checker(engine and dictionary) that works with OpenOffice.org 2.0 for Windows.
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hi_IN.zip Pack] 2007-02-19

== Hungarian (Hungary) ==
* Extensions:
** [http://extensions.services.openoffice.org/project/hu_dicts Hungarian Dictionary Pack] for OpenOffice 3.0 or later. Contains Hungarian spellchecking dictionary, hyphenation patterns & thesaurus.
** [http://extensions.services.openoffice.org/project/lightproof Lightproof] grammar checker (Hungarian rules are included)
* Spelling:
** [http://dfn.dl.sourceforge.net/project/magyarispell/Magyar%20Ispell/1.5/hu_HU-1.5.tar.gz Magyar Ispell v1.5] requires OpenOffice.org 2.1 or later, 2009-09-18. [http://magyarispell.sourceforge.net Magyar Ispell dictionary]. [[Magyar Ispell hibabejelentés|Bug report page]].
** [http://tkltrans.sourceforge.net/tklspell/hu_HU_comb.zip Hungarian_2] requires OpenOffice.org 2.0.2 or later, 2006-11-05. This dictionary contains around 700 thousand manually collected compound words.
** [http://downloads.sourceforge.net/magyarispell/hu_HU-0.99.4.zip Hungarian] compatible with MySpell 2004-04-02
* [http://downloads.sourceforge.net/magyarispell/hyph_hu.zip Hyphenation] 2006-12-13
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_hu_HU.zip Thesaurus] 2003-09-29, NOTE: works with OpenOffice.org 1.x only!
* Pack:
** [http://downloads.sourceforge.net/magyarispell/hu_HU-1.3-pack.zip Pack] requires OpenOffice.org 2.0.2 or later, 2008-03-15
** [http://downloads.sourceforge.net/magyarispell/hu_HU-1.3-pack-for_OOo_2.1_or_newer.zip Pack] requires OpenOffice.org 2.1 or later (for Unicode non-standard hyphenation) 2008-03-15
** [http://downloads.sourceforge.net/magyarispell/hu_HU-0.99.4-pack.zip Pack] 2004-04-02

== Icelandic (Iceland) ==
* [http://hunspell.sourceforge.net/is_IS.zip Spelling] 2006-09-28
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_is_IS.zip Hyphenation] 2003-09-20
* [http://hunspell.sourceforge.net/is_IS-pack.zip Pack] 2006-09-28

== Indonesian (Indonesia) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/id_ID.zip Spelling] 2004-08-12 (NOTE: relicensed under GPL/LGPL/MPL tri-license, see https://addons.mozilla.org/en-US/firefox/addon/6818)
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_id_ID.zip Hyphenation] 2004-08-12
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/id_ID-pack.zip Pack] 2004-08-12

== Interlingua (x-register) ==

* [http://download.savannah.nongnu.org/releases/interlingua/ia_myspell.zip Spelling] 2005-01-01
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_ia.zip Hyphenation] 2005-03-07
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ia-pack.zip Pack] 2003-08-07

== Irish (Ireland) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ga_IE.zip Spelling] (version 4.3) 2007-10-29 [http://borel.slu.edu/ispell/index.html home page]
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_ga_IE.zip Hyphenation] (version 1.0) 2004-02-20 [http://borel.slu.edu/fleiscin/index.html home page]
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_ga_IE_v2.zip Thesaurus] (version 1.001) 2007-10-01 [http://borel.slu.edu/lsg/index.html home page]
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ga_IE-pack.zip Pack] 2006-07-31

== Italian (Italy) ==
You can find how to install Italian dictionaries in the dictionary home page (Italian language only).

Per sapere come fare ad installare i dizionari qui sotto riportati andare all'home page dello strumento linguistico desiderato (solo in lingua italiana).

* '''Spelling''':
** [http://prdownloads.sf.net/linguistico/italiano_2_4_2007_09_01.zip?download Italian dictionary (dizionario italiano)] (2.4 2007-09-01) [http://linguistico.sf.net/wiki/doku.php?id=dizionario_italiano home page]
** [http://prdownloads.sf.net/linguistico/cognomi_italiani_03_01__2009_06_26.zip?download Italian surname dictionary (dizionario dei cognomi italiani)] (3.01 2009-06-26) [http://linguistico.sf.net/wiki/doku.php?id=dizionario_cognomi_italiani home page]

* '''Hyphenation''':
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_it_IT.zip Hyphenation] 2007-11-27

* '''Thesaurus''':
** [http://downloads.sf.net/linguistico/thesaurus2_it_02_09_l_2008_11_29.zip?download Thesaurus OOo 2.x] (2.09.l 2008-11-29) - only for OpenOffice.org >= 2.0 [http://linguistico.sf.net/wiki/doku.php?id=thesaurus_italiano home page]
** [http://prdownloads.sf.net/linguistico/thesaurus_it_01_00_2005_07_26.zip?download Thesaurus OOo 1.1.x] (1.00 2005-07-26) - only for OpenOffice.org 1.1.x [http://linguistico.sf.net/wiki/doku.php?id=thesaurus_italiano home page]
*** [http://prdownloads.sf.net/linguistico/thesaurus_it_01_00_2005_07_26_src.zip?download Thesaurus source] (1.00 2005-07-26) - only for OOo 1.1.x [http://linguistico.sf.net/wiki/doku.php?id=thesaurus_italiano home page]
*** [http://prdownloads.sf.net/linguistico/thescoder-0.6.zip?download ThesCoder 0.60], program to make the OOo 1.1.x thesaurus binary [http://linguistico.sf.net/wiki/doku.php?id=thescoder home page]

* '''Extensions''':
** [http://prdownloads.sf.net/linguistico/Dizionari.IT_20081129.oxt?download Estensione Dizionario IT] (20081129 2008-11-29) - only for OOo >= 3.0 [http://linguistico.sf.net/wiki/doku.php?id=estensione:estensione_dizionario_it home page]
** [http://prdownloads.sf.net/linguistico/Cognomi.IT_20090626.oxt?download Estensione Cognomi IT] (20090626 2009-06-26) - only for OOo >= 3.0 [http://linguistico.sf.net/wiki/doku.php?id=estensione:estensione_cognomi_it home page]

* '''Package''':
** [http://prdownloads.sf.net/linguistico/it_IT-OOo2-pack_01_07__2008_11_29.zip?download Pack OOo 2.x] (01.07 2008-11-29) - only for OOo >= 2.0 [http://linguistico.sf.net/wiki/doku.php?id=pacchetto_strumenti_linguistici home page]
** [http://prdownloads.sf.net/linguistico/it_IT-OOo1-pack_1_1_beta_2006_07_23.zip?download Pack OOo 1.1.x] (1.1 beta 2006-07-23) - only for OOo 1.1.x [http://linguistico.sf.net/wiki/doku.php?id=pacchetto_strumenti_linguistici home page]



== Kashubian (Poland) ==
* [http://hunspell.sourceforge.net/csb-demo.tar.gz Spelling] 2005-03-04

== Khmer (Cambodia) ==
* [http://www.sbbic.org/en/node/159 KhmerOS Spelling] 2008-05-12
* [http://www.sbbic.org/en/node/159 Spelling] 2006-09-01
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/km_spellchecker Extension]

== Kinyarwanda (Rwanda) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/rw_RW.zip Spelling] 2005-01-08

== Kiswahili (East Africa) ==
* [http://www.it46.se/downloads/openoffice/dictionary/dictionary_myspell_sw_TZ_1.1.tar.gz Spelling] (extended word list) 2005-08-19
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/sw_KE.zip Spelling] 2004-05-16
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/sw_KE-pack.zip Pack] 2004-05-16

== Kurdish (Turkey, Syria) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ku_TR.zip Spelling] 2005-01-21
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ku-pack.zip Pack] 2005-01-21

== Latin (x-register) ==
* Spelling:

**[http://www.drouizig.org/Saozneg/Misc/misc-Latinspellchecker.html COL1.0ß] 2006-01-27 by Marjorie Burghart
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/la-pack.zip Pack] 2002-05-05

== Latvian (Latvia) ==
* [ftp://ftp.stardiv.de/pub/OpenOffice.org/contrib/dictionaries/lv_LV.zip Spelling] v.0.8b1 2009-05-09

== Lingala (Democratic Republic of the Congo) ==
* [http://softlayer.dl.sourceforge.net/sourceforge/lingala/ln_CD.zip Spelling] 2009-04-03

== Lithuanian (Lithuania) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/lt_LT.zip Spelling] 2003-12-31
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_lt_LT.zip Hyphenation] 2004-01-10
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/lt_LT-pack.zip Pack] 2004-04-05

== Luxembourgish (Luxembourg) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/lb-dict Extension]
* [http://www.spellchecker.lu/ Spellchecker.lu] Project Website, in Luxembourgish
* [http://downloads.spellchecker.lu/packages/OOo2/ OOo2 Pack] Notes: updated regularly, needs OOo >= 2.0.2
* [http://downloads.spellchecker.lu/packages/OOo3/ OOo3 Extension] Notes: updated regularly

== Malagasy (Madagascar) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/mg_MG.zip Spelling] 2005-01-09

== Malay (Malaysia) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ms_MY.zip Spelling] 2005-01-17
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ms_MY-pack.zip Pack] 2005-01-17

== Māori (Aotearoa) ==
[http://papakupu.maori.nz/ Te Papakupu Māori] should be considered the source for Māori dictionaries from now on.
The following packages are being auto-generated:
* [http://packages.papakupu.maori.nz/hunspell/ Spelling] dictionary for Hunspell, includes regional dialects.
* [http://packages.papakupu.maori.nz/hunspell-hyphen/ Hyphenation] rules for Hunspells' Hyphen.
* [http://packages.papakupu.maori.nz/mythes/ Thesaurus] for MyThes.
* [http://packages.papakupu.maori.nz/openoffice2/ OpenOffice.org 2 Pack] includes spelling dictionary, no regional dialects. Beta version also includes hyphenation rules and thesaurus.
* [http://extensions.services.openoffice.org/project/maori-papakupu OpenOffice.org 3 Extension] includes spelling dictionary, hyphenation rules, and thesaurus, no regional dialects.
* [http://packages.papakupu.maori.nz/ Everything else] For all supported software including the above.

Contact me if you would like tailored packages auto-generated for upstream projects.

-- [[User:Kiharoa|Kiharoa]]

== Macedonian (Former Yugoslav Republic of Macedonia) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/mk_MK.zip Spelling] 2005-11-26

== Marathi (India) ==
* [http://ftp.stardiv.de/pub/OpenOffice.org/contrib/dictionaries/mr_IN.zip Spelling] 2006-09-26
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/dicooo/mr_IN_pack.zip Pack] 2006-09-26

== Malayalam (India) ==
* [http://ftp.twaren.net/Unix/NonGNU/smc/Spellchecker/ooo-hunspell-ml-0.1.tar.bz2 Spelling] 2008-05-19
* [http://git.savannah.gnu.org/cgit/smc.git/tree/hyphenation Hyphenation] 2008-05-19

== Mongolian (Mongolia) ==

* [http://www.openoffice.org/issues/show_bug.cgi?id=92263 Spelling] 2008-07-29 (see the attachment)


== Ndebele (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/nr_ZA.zip Spelling] 2006-01-20
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/nr_ZA-pack.zip Pack] 2006-01-20
* [http://translate.org.za/download/spellchecker/ndebele/ Spelling, Pack, Word lists (Experimental/Development)]

== Nepali (Nepal) ==
* [http://nepalinux.org/downloads/ne_NP_dict.zip Spelling] 2006-10-17
* [http://nepalinux.org/downloads/thes_np_NP_v2.zip Thesaurus] requires OpenOffice.org 2.x or later, 2006-12-20

== Northern Sotho (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ns_ZA.zip Spelling] 2006-01-20
* [http://translate.org.za/download/spellchecker/northern_sotho/ Spelling, Pack, Word lists (Experimental/Development)]

== Norwegian (Norway) ==
* Spelling:
** [http://alioth.debian.org/frs/download.php/2357/no_NO-pack2-2.0.10.zip Norwegian Bokmål & Nynorsk (Norway) pack for OOo '''2.x'''] 2008-03-10
** [http://alioth.debian.org/frs/download.php/2358/no_NO-pack1-2.0.10.zip Norwegian Bokmål & Nynorsk (Norway) pack for OOo '''1.x'''] 2008-03-10
** Older versions:
*** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/nb_NO.zip Norwegian Bokmål (Norway)] 2006-05-08
*** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/nn_NO.zip Norwegian Nynorsk (Norway)] 2006-05-08
*** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/no_NO-pack.zip Pack] 2005-01-12
*** [http://alioth.debian.org/frs/?group_id=30577 All older versions, including sources]

== Occitan (France) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/oc_FR.zip Spelling (Languedocien)] 2006-09-22

== Oriya (India) ==
* [http://hunspell.sourceforge.net/or-demo.tar.gz Spelling] 2005-01-25

== Papiamentu (Netherlands Antilles) ==
* no information yet

== Persian (Iran) ==
* [http://hunspell.sourceforge.net/fa_IR.tar.bz2 Spelling] 2007-08-16

== Polish (Poland) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/pl-dict Extension]
* [http://pl.openoffice.org/pliki/pl_PL.zip Spelling] 2006-12-02
* [http://pl.openoffice.org/pliki/hyph_pl_PL.zip Hyphenation] 2006-07-26
* [http://pl.openoffice.org/pliki/thes_pl_PL_v2.zip Thesaurus] requires OpenOffice.org 2.x or later, 2006-12-23
* [http://pl.openoffice.org/pliki/pl_PL-pack.zip Pack] 2006-12-23
* [http://pl.openoffice.org/pliki/thes_pl_PL.zip Thesaurus] only for OpenOffice.org 1.x, 2006-12-23

== Portuguese (Portugal + Brasil) ==
* Spelling:
** [http://natura.di.uminho.pt/download/sources/Dictionaries/myspell Portuguese (Portugal)] 2006-10-26
** [http://www.openoffice.org.br/?q=verortografico Portuguese (Brazil)] 2006-10-17
* Hyphenation:
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_pt_PT.zip Portuguese (Portugal)] 2002-10-21
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_pt_BR.zip Portuguese (Brazil)] 2002-10-21
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/pt_PT-pack.zip Pack] 2003-12-30

== Punjabi (India) ==
* [http://hunspell.sourceforge.net/pa-demo.tar.gz Spelling] 2005-01-25

== Quechua (Bolivia) ==
* [http://hunspell.sourceforge.net/qu_BO-pack.zip Pack] (Spelling) 2007-05-09
== Quichua (Ecuador) ==
* [http://hunspell.sourceforge.net/qu_EC-pack.zip Pack] AWAITING STORAGE (Spelling) 2009-03-02

== Romanian (Romania) ==
'''OpenOffice.org 3.x extensions:''' [http://extensions.services.openoffice.org/project/dictionaries-ro-contemporary Contemporary], [http://extensions.services.openoffice.org/project/dictionaries-ro-classic Classic]

'''''Extensii OpenOffice.org 3.0:'''''
[http://extensions.services.openoffice.org/project/dictionaries-ro-contemporary Dicţionare contemporane (â din a / după 1993)], [http://extensions.services.openoffice.org/project/dictionaries-ro-classic Dicţionare clasice (î din i / ante 1993)]. ''Ambele extensii cuprind un corector ortografic, un dicţionar de sinonime, şi un dicţionar de despărţire în silabe. În cazul în care se dorește compatibilitatea cu utilizatorii care folosesc platforme cu suport incomplet pentru limba română (precum Windows XP), se recomandă folosirea dicționarelor împreună cu extensia '' [http://extensions.services.openoffice.org/project/RomanianDiacritics Diacritice românești]. ''Această extensie permite introducerea caracterelor diacritice românești și conversia textului dintr-un format de caractere în altul. Suport pentru [http://extensions.services.openoffice.org/project/AutocorrectRomanian autocorectare] este de asemenea disponibil ''

'''Source Code and OpenOffice.org 2.x Dictionaries:
'''
* [http://downloads.sourceforge.net/rospell/ro_RO.3.2.zip Spelling] 2008-07-06 - latest release
* [http://downloads.sourceforge.net/rospell/hyph_ro_RO.3.3-test3.zip Hyphenation] 2008-10-12
* [http://downloads.sourceforge.net/rospell/th_ro_RO.3.3-test3.zip Thesaurus] 2008-09-21

'''Previous releases:
'''
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ro_RO-pack.zip Pack] 2004-04-05
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ro_RO.zip Spelling] 2005-02-27
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_ro_RO.zip Hyphenation] 2005-02-21
* [http://www.archeus.ro/Download/OpenOffice/CorectorOrtografic/1.1/ro_RO.zip Spelling (Experimental)] 2007-05-12 - see [http://www.archeus.ro/lingvistica/CorectorOrtografic description (romanian)]
* [http://downloads.sourceforge.net/rospell/ro_RO.3.1.zip Spelling] 2008-04-09

== Russian (Russia) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/dict_ru_RU Extension]
OpenOffice.org 2.x:
* Spelling:
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ru_RU.zip Russian (Russia)] 2004-04-06
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ru_RU_ye.zip Russian ye (Russia)] 2003-09-11
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ru_RU_yo.zip Russian yo (Russia)] 2004-04-06
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_ru_RU.zip Hyphenation] 2002-07-27
* [http://download.i-rs.ru/pub/openoffice/dict/thes_ru_RU_v2.zip Thesaurus] 2007-06-13
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ru_RU-pack.zip Pack] 2004-04-06

== Sami ==
* [http://divvun.no/static_files/smi.zip Spelling] 2008-05-23
* [http://divvun.no/static_files/smi-pack.zip Pack] 2008-05-23

== Scottish Gaelic (Scotland) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/gd_GB.zip Spelling] 2005-01-08

== Serbian (Serbia, Republic Srpska) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/dict-sr Extension]
* [http://ooo.matf.bg.ac.rs/dict-sr/sr-20090213.zip Spelling] 2009-02-13
* [http://ooo.matf.bg.ac.rs/dict-sr/hyph_sr-20090213.zip Hyphenation] 2009-02-13

Spelling dictionary includes both Cyrillic (sr) and Latin (sh) wordlist.

== Setswana (Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/tn_ZA.zip Spelling] 2004-05-16
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/tn_ZA-pack.zip Pack] 2004-05-16
* [http://translate.org.za/download/spellchecker/tswana/myspell-tn_ZA-20060123.zip Spelling (Experimental)] 2006-01-23
* [http://translate.org.za/download/spellchecker/tswana/myspell-pack-tn-ZA-20060123.zip Pack (Experimental)] 2006-01-23
* [http://translate.org.za/download/spellchecker/tswana/ Spelling, Pack, Word lists (Experimental/Development)]

== Slovak (Slovakia) ==

* [http://www.sk-spell.sk.cx/file_download/63/hunspell-sk-20090330.zip Spelling] 2009-03-30 (see [http://www.sk-spell.sk.cx/hunspell-sk hunspell-sk])
* [http://www.sk-spell.sk.cx/thesaurus/download/OOo-Thesaurus2-sk_SK.zip Thesaurus] 2009-03-30 (weekly updated; see: [http://www.sk-spell.sk.cx/thesaurus/ OpenThesaurus-SK - Slovenský synonymický slovník])
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_sk_SK.zip Hyphenation] 2003-12-27
* [http://www.sk-spell.sk.cx/file_download/62/acor_sk.oxt Slovak autocorrection] 2008-06-01
* [http://extensions.services.openoffice.org/node/1144 Slovak dictionary plug-in for OpenOffice.org 3] 2009-03-30

For other information/files please check [http://www.sk-spell.sk.cx/ sk-spell project] or [http://www.sk-spell.sk.cx/openofficeorg-sk openoffice.org-sk]






== Slovenian (Slovenia) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/sl_SI.zip Spelling] 2007-01-27
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_sl_SI.zip Hyphenation] 2007-01-27
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/sl_SI-pack.zip Pack] 2007-01-27
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_sl_SI_v2.zip Thesaurus] 2008-01-26 ([http://www.tezaver.si experimental - click here for updates])

== Southern Sotho (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/st_ZA.zip Spelling] 2006-01-20
* [http://translate.org.za/download/spellchecker/southern_sotho/ Spelling, Pack, Word lists (Experimental/Development)]

== Spanish (Spain, ...) ==
* Spelling:
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/es_ES.zip Spanish (Spain-etal)] 2005-05-10
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/es_MX.zip Spanish (Mexico)] 2005-05-05
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/Math_es_ES.zip Math_es_ES] 2004-04-05
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_es_ES.zip Hyphenation] 2004-08-10
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/es_ES-pack.zip Pack] 2005-01-18

For IE7Pro Spellchecker
* [http://erwin.ried.cl/files/articles/_public/esp_ie7pro_2007_04_09.rar Spanish (Spain-etal) Autoinstaller]

== Swazi/Swati (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ss_ZA.zip Spelling] 2006-07-05
* [http://translate.org.za/download/spellchecker/swati/ Spelling, Pack, Word lists (Experimental/Development)]

== Swedish (Sweden) ==
* [http://extensions.services.openoffice.org/project/dict-sv Spelling]
* [http://extensions.services.openoffice.org/project/SweThes Thesaurus]
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_sv_SE.zip Hyphenation] 2003-08-14

The above requires OpenOffice.org 3.0.0 or later.

== Tagalog (Philippines) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/tl_PH.zip Spelling] 2005-01-08

== Tamil (India) ==
* [http://hunspell.sourceforge.net/ta-demo.tar.gz Spelling] 2004-08-25

== Tetum (Indonesia) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/tet_ID.zip Spelling] 2005-01-08

== Thai (Thailand) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/th_TH.zip Spelling] 2006-12-12

== Tsonga (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ts_ZA.zip Spelling] 2006-01-23
* [http://translate.org.za/download/spellchecker/tsonga/ Spelling, Pack, Word lists (Experimental/Development)]

== Ukrainian (Ukraine) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/uk_UA.zip Spelling] 2009-01-25
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_uk_UA.zip Hyphenation] 2003-09-03
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/uk_UA-pack.zip Pack] 2005-11-06

== Urdu (Pakistan, India) ==
* [http://ftp.stardiv.de/pub/OpenOffice.org/contrib/dictionaries/ur_PK.zip Spelling] 2007-01-26
also bound to Urdu (India)

== Uzbek (Uzbekistan) ==
* [http://hunspell.sourceforge.net/uz-demo.tar.gz Spelling] (Cyrillic) 2005-04-27

== Venda (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ve_ZA.zip Spelling] 2006-07-06
* [http://translate.org.za/download/spellchecker/venda/ Spelling, Pack, Word lists (Experimental/Development)]

== Vietnamese (Vietnam) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/Vietnamese_SpellChecker Extension]
* [http://hunspell-spellcheck-vi.googlecode.com/files/vi_VN.zip Spelling] 2008-06-04
* [http://hunspell-spellcheck-vi.googlecode.com/files/PackVietnamese.zip Pack] 2008-06-04
* [http://hunspell-spellcheck-vi.googlecode.com/ Project Forge]

== Wayunaiki (Venezuela) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/??_VE.zip Spelling (Experimental/Development)] 2006-??-??

== Welsh (Wales) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/cy_GB.zip Spelling] 2004-04-25
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/cy_GB-pack.zip Pack] 2004-04-30

== Xhosa (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/xh_ZA.zip Spelling] 2006-01-23
* [http://translate.org.za/download/spellchecker/xhosa/ Spelling, Pack, Word lists (Experimental/Development)]

== Zulu (Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/zu_ZA.zip Spelling] 2006-01-20
* [http://translate.org.za/download/spellchecker/zulu/ Spelling, Pack, Word lists (Experimental/Development)]

[[Category:Localization]]

Dictionaries

2009-11-08T11:29:34Z

Timarandras: added Lightproof

This page lists spell checker dictionaries, hyphenation files, and thesauri for OpenOffice.org 2.x.

'''IMPORTANT NOTE: From OpenOffice.org 3.0 on the dictionary wizard is no longer available -- Dictionaries are now available via [http://extensions.services.openoffice.org/dictionary the extensions repository]'''. See [[Extension Dictionaries]] for how to create dictionary extensions. As an end-user this page is now only useful for those using OpenOffice.org < 3.0, though it still has a role for aiding Linux distribution packagers in collecting what un-bundled linguistic extensions are available.

'''To install a new dictionary in Vanilla OpenOffice.org 2.x, call "File -> Wizards -> Install new dictionaries" in OpenOffice.org. Then exit and re-start OpenOffice.org, including the Quickstarter (if used).''' Most of the files on this page are available for installation via the wizard. If not, download the Pack file, and use the "off-line language installation" option of [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/dicooo/DicOOo.sxw DicOOo wizard].

One user notes: If you have the "wrong" dictionary installed and spell check and other features cannot be supported, you will not receive any warning or notification. At best you can type some gibberish and see if it is underlined, if auto-correct is enabled. Download dictionaries (from the new extensions mechanisms detailed below, not the Web site listed in the help), and change settings in the various dialogues (sorry, not sure which one, there are several language related dialogues) until things work again. However, this didn't work for me but if you have the settings of the majority (eg US English) maybe you won't have to bother.

'''OpenOffice.org dictionaries in Fedora.'''
In Fedora to install OpenOffice.org, you can use the "Add/Remove Software" application, or you can do this from the command line with e.g. "yum install openoffice.org-writer". Additional language support can then be installed using something like "yum install openoffice.org-langpack-fr" to install French language support which will automatically include spell-checking support where available. A list of currently installed and available language packs can be seen using "yum list openoffice.org-langpack*". Additional dictionaries can also be installed separately using yum, e.g. yum install hunspell-fr.

'''OpenOffice.org dictionaries wizard in Ubuntu.'''

If the window is too small when using the File>Wizards>Install new dictionaries then make sure visual effects (compiz) are disabled (that is: change from "Extra" or "Normal" to "None" in Ubuntu System | Settings | Appearance | Visual Effect tab).
In order to use this wizard in '''Ubuntu''' (tested on Kubuntu 7.10) you need to have the package '''openoffice.org''' installed in addition to standard installation of open-office.org-writer and open-office.org-calc. You can do this by typing '''sudo apt-get install openoffice.org'''

'''Adding Resources'''

Please use [http://extensions.services.openoffice.org/ the extensions repository] -- the resources listed on this page refer to ftp.services.openoffice.org, which will not be maintained anymore.

'''OpenOffice.org dictionaries in Gentoo.'''

To install a dictionary, execute the following command as root:

emerge myspell-<lang>

Start OpenOffice. Open Tools -> Options -> Language Settings -> Languages. From the drop-down menu under "Default languages for documents" select a language whose dictionary you've installed.--[[User:Dnt2wiki|Dnt2wiki]] 19:33, 30 September 2008 (CEST)

'''All Language Packs: [http://de.openoffice.org/downloads/quick.html?platform=dicooofull PackFull] (58MB) Sep 14 2007''' Download the pack_full zip if you want to redistribute all available dictionaries in your network. Download page is in German, just click the button "Download starten" to get the file. A mirror will be chosen automatically.

'''Tools for dictionary developers''':
 Spellchecker: [http://hunspell.sourceforge.net Hunspell].
 Hyphenator: [http://sourceforge.net/project/showfiles.php?group_id=143754&package_id=231949 Hyphen].
 Thesaurus: [http://lingucomponent.openoffice.org/MyThes-1.zip OpenOffice.org MyThes].
 Grammar checker: [http://www.languagetool.org LanguageTool] and [http://extensions.services.openoffice.org/project/lightproof Lightproof].

More information on the file formats of dictionaries can be found on the [http://lingucomponent.openoffice.org/ Lingucomponent Project homepage].

== Afrikaans (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/af_ZA.zip Spelling] 2006-01-17
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/af_ZA-pack.zip Pack] 2006-01-17
* [http://translate.org.za/download/spellchecker/afrikaans/ Spelling, Pack, Word lists (Experimental/Development)]

== Amharic (Ethiopia) ==
* [http://hunspell.sourceforge.net/am-demo.tar.gz Spelling] 2004-12-28

== Arabic (North Africa and Middle East) ==
* [http://downloads.sourceforge.net/ayaspell/hunspell-ar_20080110.tar.gz Spelling] (hunspell-ar from [http://ayaspell.sourceforge.net/ ayaspell project]) 2008-01-10
* [ftp://foolab.org/pub/software/arspell/20060329/ar.zip Spelling] (Simple word list) 2006-03-29
* [http://hunspell.sourceforge.net/buckwalter_morphan_1_hunspell_patch.tar.gz Spelling] (Conversion of Buckwalter's Arabic morphological analyser) 2006-02-08

== Armenian (Eastern) ==
* [http://downloads.sourceforge.net/armspell/myspell-hy-0.10.1.tar.gz Spelling] ([http://sf.net/projects/armspell Armspell Project], 0.10.1 - 2007-08-18)

== Azerbaijani (Azerbaijan, Iran) ==
* [http://hunspell.sourceforge.net/az-demo.tar.gz Spelling] 2004-08-17

== Basque ==
* [http://www.euskara.euskadi.net/r59-738/es/contenidos/informacion/euskarazko_softwarea/es_9568/lista.html Spelling] 2006-10-06 (note: use ANY country code in dictionary.lst, see documentation. anther note: license is absent in the package, so at least some distributions avoid including of this package. Consider adding AUTHORS and License files in this package.)

== Belarusian (Belarus ) ==
* [http://pravapis.info/spell/dict/ooo-official.zip Spelling(official orthography)] 2008-11-17
* [http://pravapis.info/spell/dict/ooo-classic.zip Spelling(classic orthography)] 2008-11-17

== Bengali (Bangladesh, India) ==
* [http://www.ankur.org.bd/downloads/spell_check/hunspell/hunspell-bn-BD-0.02.tar.bz2 Spelling] (version 0.02) 2008-02-01 ([http://ankur.org.bd/wiki/Documentation#OpenOffice.org ankur.org.bd])

== Bulgarian (Bulgaria) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/dictionaries-bg Extension]
* [http://sourceforge.net/project/showfiles.php?group_id=52198 Spelling] 2007-12-11
* [http://sourceforge.net/project/showfiles.php?group_id=52198 Hyphenation] 2007-12-11
* [http://sourceforge.net/project/showfiles.php?group_id=52198 Thesaurus] 2007-12-11

== Catalan ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ca_ES.zip Spelling] 2002-10-15
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ca_ES-pack.zip Pack] 2002-10-15

== Chichewa (Malawi) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ny_MW.zip Spelling] 2005-01-08

== Coptic (North Africa) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/copt_dict Extension]
* [http://www.moheb.de/coptic_proofing.html Spelling] 2006-05-29

== Croatian (Croatia) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hr_HR.zip Spelling] 2006-06-07
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hr_HR-pack.zip Pack] 2006-06-07

== Czech (Czech Republic) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/cs_CZ.zip Spelling] 2003-01-01
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_cs_CZ.zip Hyphenation] 2003-12-27
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_cs_CZ.zip Thesaurus] (for OpenOffice.org 1.x) 2004-08-20
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_cs_CZ_v2.zip Thesaurus] (for OpenOffice.org 2.x) 2007-09-26
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/cs_CZ-pack.zip Pack] 2004-08-20

== Danish (Denmark) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_da_DK.zip Hyphenation] 2007-09-03
* [http://www.stavekontrolden.dk Pack] 2008-02-20

== Dutch (Netherlands) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/nl_NL.zip Spelling] 2007-06-07 (OpenTaal 1.00G) Note: this is not the [http://extensions.services.openoffice.org/project/dict-nl latest version]
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_nl_NL.zip Hyphenation] 2005-06-17
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/nl_NL-pack.zip Pack] 2005-07-20 (contains older spelling dictionary)

== English (AU,CA,GB,NZ,US,ZA) ==
* Spelling:

** [http://en-gb.pyxidium.co.uk/dictionary/en_GB.zip English (United Kingdom)] 2006-11-30
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_US.zip English (United States)] 2006-02-07
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_AU.zip English (Australia)] 2003-03-29 by Kelvin Eldridge (Australian dictionary creator and maintainer). Latest dictionary (2008-12-18) available from Kelvin's site [http://www.JustLocal.com.au www.JustLocal.com.au]. Scroll to the bottom of the page and click on Australian spell check dictionary files. Also OpenOffice.org 3 version. Commercial software fee payable.
** [http://chenopod.net/dnw/en_AU.zip English (Australia)] 2008-09-25 (OpenSource, no charge, updated 2 Oct. 2008)
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_CA.zip English (Canada)] 2002-03-15
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_NZ.zip English (New Zealand)] 2002-05-18
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_ZA.zip English (South Africa)] 2006-01-20
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_GB-oed.zip English (OED English)] 2005-06-13
* Hyphenation:
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_en_GB.zip English (United Kingdom)] 2002-07-27
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_en_US.zip English (United States)] 2002-07-27
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_en_CA.zip English (Canada)] 2002-07-27
* Thesaurus:
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_en_US_v2.zip English (United States & United Kingdom)], requires OpenOffice.org 2.x or later, 2006-03-06
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/en_EN-pack.zip Pack] 2003-11-05

== Esperanto (anywhere) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/eo.zip Spelling] 2004-11-29
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/eo-pack.zip Pack] 2004-11-29

== Estonian (Estonia) ==
* [http://www.meso.ee/~jjpp/speller Spelling] 2003-06-02
* [http://www.meso.ee/~jjpp/speller Hyphenator]

== Faroese (Faroe Islands) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fo_FO.zip Spelling] 2005-03-07
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fo_FO-pack.zip Pack] 2005-01-15

== Persian (Iran) ==
*[http://hunspell.sourceforge.net/fa-demo.tar.gz Spelling] 2005-07-26

== Fijian (Fiji) ==
* [http://www.iosn.net/pacific-islands/usp-microgrants/fijian-spellchecker See iosn.net] 2005-08-11

== Finnish (Finland) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fi_FI.zip Spelling] 2002-11-20
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_fi_FI.zip Hyphenation] 2004-04-10
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fi_FI-pack.zip Pack] 2004-04-11

'''NOTE: Hunspell is not capable of handling Finnish language properly, so these dictionaries should not be used. Instead, [http://voikko.sourceforge.net/ Voikko] project should be used, either via [http://www.abisource.com/projects/enchant/ Enchant] (a recommended spell-checking library for any project, supports also hunspell) or directly in OOo via openoffice.org-voikko provided by the project also.'''

== French (France, ...) ==

'''[http://www.dicollecte.org/ The French project: Dicollecte]'''

About the new french spelling, please read: [http://en.wikipedia.org/wiki/Reforms_of_French_orthography Reforms of French orthography (en)], [http://www.renouvo.org/regles.php Réforme de l'orthographe (fr)] and [http://www.orthographe-recommandee.info/index.htm Orthographe recommandée (fr)]

{| width="66%" cellpadding="0" cellspacing="0"
|-
! bgcolor="#c0e0ce" style="padding: 6px 10px 3px 10px; text-align: left;" | '''OpenOffice.org 3.x''' extensions
|-
| style="border: 2px solid #c0e0ce; padding: 10px" bgcolor="#f0fff0" |
{| border="0" cellpadding="0" cellspacing="0" style=" background-color: #f0fff0"
|-
| * [http://extensions.services.openoffice.org/project/french-dictionary-classic-reform1990 Classic & Reform 1990 Spelling ]
|-
| * [http://extensions.services.openoffice.org/project/french-dictionary-classic Classic Spelling]
|-
| * [http://extensions.services.openoffice.org/project/french-dictionary-reform1990 Reform 1990 Spelling]
|}
|}

{| width="66%" cellpadding="0" cellspacing="0"
|-
! bgcolor="#ddddff" style="padding: 6px 10px 3px 10px; text-align: left;" | '''OpenOffice.org 2.x'''
|-
| style="border: 2px solid #ddddff; padding: 10px" bgcolor="#f3f3ff" |
{| border="0" cellpadding="0" cellspacing="0" style=" background-color: #f3f3ff"
|-
| * [http://www.dicollecte.org/download.php?prj=fr Latest dictionaries]
|-
| * You can also get them in OOo with Menu File -> Wizards -> Install new dictionaries
|}
|}

{| width="66%" cellpadding="0" cellspacing="0"
|-
! bgcolor="#faf9b2" style="padding: 6px 10px 3px 10px; text-align: left;" | '''Deprecated dictionaries'''
|-
| style="border: 2px solid #faf9b2; padding: 10px" bgcolor="#ffffec" |
{| border="0" cellpadding="0" cellspacing="0" style=" background-color: #ffffec"
|-
| * [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fr_FR-pack.zip Pack] (old versions) 2005-06-09
|}
|}

== Frisian (Netherlands) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fy_NL.zip Spelling] (version 0.12) 2007-11-28
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/fy_NL-pack.zip Pack] (version 0.11) 2007-02-22

== Friulian (Italy) ==
* [http://digilander.libero.it/paganf/coretors/myspell-fur-12092005.zip Spelling] 2005-09-12 [http://digilander.libero.it/paganf/coretors/dizionaris.html home page]



== Galician (Spain) ==

Made by Frco. Javier Rial in [http://www.mancomun.org Mancomun.org]

* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/gl_ES.zip Spelling] 2008-05-16 Hunspell version.
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/gl_ES-pack.zip Pack] 2008-05-16 Hunspell version.

* [http://extensions.services.openoffice.org/project/Extension_Corrector_galego_OOo Extensión co corrector de Hunspell para o OpenOffice.org 3] (2008-05-15).

* [http://extensions.services.openoffice.org/project/Extension_Guionizador_galego_OOo Extensión co guionizador para o OpenOffice.org 3] (2009-02-09).

== Gascon (France) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/gsc_FR.zip Spelling] 2007-08-16 Contributed by [http://www.pernoste.com Per Noste]
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/gsc_FR-pack.zip Pack] 2007-08-16

Requires OOo 2.1 or later

== German (Germany, ...) ==
* '''OpenOffice.org 3.x Extensions (Spelling dictionaries, Hyphenation, Thesaurus)''':
** [http://extensions.services.openoffice.org/project/dict-de-DE_frami Extension "German (de-DE-frami) dictionaries: spell checking, hyphenation, thesaurus" for locale Germany de-DE] (recommended), by Franz Michael Baumann, an extended version of Björn Jacke's dictionary, 2009-02-21
** [http://extensions.services.openoffice.org/project/dict-de_CH_frami Extension "German (de-CH-frami) dictionaries: spell checking, hyphenation, thesaurus" for locale Switzerland de-CH] (recommended), by Franz Michael Baumann, an extended version of Björn Jacke's dictionary, 2009-02-21
** [http://extensions.services.openoffice.org/project/dict-de_AT_frami Extension "German (de-AT-frami) dictionaries: spell checking, hyphenation, thesaurus" for locale Austria de-AT] (recommended), by Franz Michael Baumann, an extended version of Björn Jacke's dictionary, 2009-02-21
** [http://extensions.services.openoffice.org/project/dict-de Extension "German dictionary, hyphenation patterns and thesaurus" for locales de-DE, de-AT and de-CH], by Björn Jacke, 2008-07-09
* '''Spelling Dictionaries:''' The new orthography dictionary with compound word support is shipped with OpenOffice.org since version 2.0.2. Its quality currently suffers from OpenOffice.org [http://qa.openoffice.org/issues/show_bug.cgi?id=64400 issue 64400].
** Recommended version (requires OpenOffice.org 2.0.2 or later):
*** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/de_DE_frami.zip German (Germany], [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/de_CH_frami.zip Switzerland], [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/de_AT_frami.zip Austria]) by Franz Michael Baumann, an extended version of Björn Jacke's dictionary, 2009-02-21
** Others versions:
*** [http://www.j3e.de/hunspell/ German (Germany, Switzerland, Austria)] by [http://www.j3e.de/ Björn Jacke] latest snapshots of the hunspell dictionary derived from [http://www.j3e.de/ispell/igerman98/ igerman98], requires OpenOffice.org 2.0.2 or later
*** [http://www.j3e.de/myspell/ German (Germany)] by [http://www.j3e.de Björn Jacke] This is a dictionary in myspell format used up to OpenOffice.org 2.0.1, 2003-06-17
*** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/de_DE_comb.zip German (Germany - mit Komposita, alte & neue Rechtschreibung gemischt)] by [http://tkltrans.sourceforge.net/spell.htm Eleonora] This is a dictionary in myspell format used up to OpenOffice.org 2.0.1, 2005-06-10
*** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/de_DE_neu.zip German (Germany - mit Komposita, neue Rechtschreibung)] by [http://tkltrans.sourceforge.net/spell.htm Eleonora] This is a dictionary in myspell format used up to OpenOffice.org 2.0.1, 2005-06-10
* '''Hyphenation:'''
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_de_DE.zip German (Germany)] 2006-01-20
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_de_CH.zip German (Switzerland)] 2006-01-20
* '''Thesaurus''' (get the latest version from [http://www.openthesaurus.de OpenThesaurus]):
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_de_DE_v2.zip German (Germany)], requires OpenOffice.org 2.x or later, 2008-01-05
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_de_CH_v2.zip German (Switzerland)], requires OpenOffice.org 2.x or later, 2008-01-05
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/de_DE-pack.zip Pack] 2005-11-02

== Greek (Greece) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/el_GR.zip Spelling] 2004-12-20
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_el_GR.zip Hyphenation] 2005-10-18
* [http://www.ellak.gr/pub/oo_extras/th_el.zip Thesaurus] 2007-04-12
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/el_GR-pack.zip Pack] 2004-09-01

== Gujarati (India) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/gu_IN.zip Spelling] 2006-10-15

== Hawaiian (United States) ==
* [http://borel.slu.edu/ispell/haw_US.zip Spelling] 2009-04-06

== Hebrew (Israel) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/he_IL.zip Spelling] 2005-01-12

== Hindi (India) ==
* [http://hunspell.sourceforge.net/hi-demo.tar.gz Spelling] 2005-01-27
* [http://devendraparakh.port5.com/ HindiWriter] includes a Hindi Spell Checker(engine and dictionary) that works with OpenOffice.org 2.0 for Windows.
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hi_IN.zip Pack] 2007-02-19

== Hungarian (Hungary) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/th_hu_HU_v2 Extension]
* Spelling:
** [http://downloads.sourceforge.net/magyarispell/hu_HU-1.3.tar.gz Magyar Ispell v1.3] requires OpenOffice.org 2.1 or later, 2008-03-15. [http://magyarispell.sourceforge.net Magyar Ispell dictionary]. [[Magyar Ispell hibabejelentés|Bug report page]].
** [http://tkltrans.sourceforge.net/tklspell/hu_HU_comb.zip Hungarian_2] requires OpenOffice.org 2.0.2 or later, 2006-11-05. This dictionary contains around 700 thousand manually collected compound words.
** [http://downloads.sourceforge.net/magyarispell/hu_HU-0.99.4.zip Hungarian] 2004-04-02
* [http://downloads.sourceforge.net/magyarispell/hyph_hu.zip Hyphenation] 2006-12-13
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_hu_HU.zip Thesaurus] 2003-09-29, NOTE: works with OpenOffice.org 1.x only!
* Pack:
** [http://downloads.sourceforge.net/magyarispell/hu_HU-1.3-pack.zip Pack] requires OpenOffice.org 2.0.2 or later, 2008-03-15
** [http://downloads.sourceforge.net/magyarispell/hu_HU-1.3-pack-for_OOo_2.1_or_newer.zip Pack] requires OpenOffice.org 2.1 or later (for Unicode non-standard hyphenation) 2008-03-15
** [http://downloads.sourceforge.net/magyarispell/hu_HU-0.99.4-pack.zip Pack] 2004-04-02

== Icelandic (Iceland) ==
* [http://hunspell.sourceforge.net/is_IS.zip Spelling] 2006-09-28
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_is_IS.zip Hyphenation] 2003-09-20
* [http://hunspell.sourceforge.net/is_IS-pack.zip Pack] 2006-09-28

== Indonesian (Indonesia) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/id_ID.zip Spelling] 2004-08-12 (NOTE: relicensed under GPL/LGPL/MPL tri-license, see https://addons.mozilla.org/en-US/firefox/addon/6818)
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_id_ID.zip Hyphenation] 2004-08-12
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/id_ID-pack.zip Pack] 2004-08-12

== Interlingua (x-register) ==

* [http://download.savannah.nongnu.org/releases/interlingua/ia_myspell.zip Spelling] 2005-01-01
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_ia.zip Hyphenation] 2005-03-07
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ia-pack.zip Pack] 2003-08-07

== Irish (Ireland) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ga_IE.zip Spelling] (version 4.3) 2007-10-29 [http://borel.slu.edu/ispell/index.html home page]
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_ga_IE.zip Hyphenation] (version 1.0) 2004-02-20 [http://borel.slu.edu/fleiscin/index.html home page]
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_ga_IE_v2.zip Thesaurus] (version 1.001) 2007-10-01 [http://borel.slu.edu/lsg/index.html home page]
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ga_IE-pack.zip Pack] 2006-07-31

== Italian (Italy) ==
You can find how to install Italian dictionaries in the dictionary home page (Italian language only).

Per sapere come fare ad installare i dizionari qui sotto riportati andare all'home page dello strumento linguistico desiderato (solo in lingua italiana).

* '''Spelling''':
** [http://prdownloads.sf.net/linguistico/italiano_2_4_2007_09_01.zip?download Italian dictionary (dizionario italiano)] (2.4 2007-09-01) [http://linguistico.sf.net/wiki/doku.php?id=dizionario_italiano home page]
** [http://prdownloads.sf.net/linguistico/cognomi_italiani_03_01__2009_06_26.zip?download Italian surname dictionary (dizionario dei cognomi italiani)] (3.01 2009-06-26) [http://linguistico.sf.net/wiki/doku.php?id=dizionario_cognomi_italiani home page]

* '''Hyphenation''':
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_it_IT.zip Hyphenation] 2007-11-27

* '''Thesaurus''':
** [http://downloads.sf.net/linguistico/thesaurus2_it_02_09_l_2008_11_29.zip?download Thesaurus OOo 2.x] (2.09.l 2008-11-29) - only for OpenOffice.org >= 2.0 [http://linguistico.sf.net/wiki/doku.php?id=thesaurus_italiano home page]
** [http://prdownloads.sf.net/linguistico/thesaurus_it_01_00_2005_07_26.zip?download Thesaurus OOo 1.1.x] (1.00 2005-07-26) - only for OpenOffice.org 1.1.x [http://linguistico.sf.net/wiki/doku.php?id=thesaurus_italiano home page]
*** [http://prdownloads.sf.net/linguistico/thesaurus_it_01_00_2005_07_26_src.zip?download Thesaurus source] (1.00 2005-07-26) - only for OOo 1.1.x [http://linguistico.sf.net/wiki/doku.php?id=thesaurus_italiano home page]
*** [http://prdownloads.sf.net/linguistico/thescoder-0.6.zip?download ThesCoder 0.60], program to make the OOo 1.1.x thesaurus binary [http://linguistico.sf.net/wiki/doku.php?id=thescoder home page]

* '''Extensions''':
** [http://prdownloads.sf.net/linguistico/Dizionari.IT_20081129.oxt?download Estensione Dizionario IT] (20081129 2008-11-29) - only for OOo >= 3.0 [http://linguistico.sf.net/wiki/doku.php?id=estensione:estensione_dizionario_it home page]
** [http://prdownloads.sf.net/linguistico/Cognomi.IT_20090626.oxt?download Estensione Cognomi IT] (20090626 2009-06-26) - only for OOo >= 3.0 [http://linguistico.sf.net/wiki/doku.php?id=estensione:estensione_cognomi_it home page]

* '''Package''':
** [http://prdownloads.sf.net/linguistico/it_IT-OOo2-pack_01_07__2008_11_29.zip?download Pack OOo 2.x] (01.07 2008-11-29) - only for OOo >= 2.0 [http://linguistico.sf.net/wiki/doku.php?id=pacchetto_strumenti_linguistici home page]
** [http://prdownloads.sf.net/linguistico/it_IT-OOo1-pack_1_1_beta_2006_07_23.zip?download Pack OOo 1.1.x] (1.1 beta 2006-07-23) - only for OOo 1.1.x [http://linguistico.sf.net/wiki/doku.php?id=pacchetto_strumenti_linguistici home page]



== Kashubian (Poland) ==
* [http://hunspell.sourceforge.net/csb-demo.tar.gz Spelling] 2005-03-04

== Khmer (Cambodia) ==
* [http://www.sbbic.org/en/node/159 KhmerOS Spelling] 2008-05-12
* [http://www.sbbic.org/en/node/159 Spelling] 2006-09-01
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/km_spellchecker Extension]

== Kinyarwanda (Rwanda) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/rw_RW.zip Spelling] 2005-01-08

== Kiswahili (East Africa) ==
* [http://www.it46.se/downloads/openoffice/dictionary/dictionary_myspell_sw_TZ_1.1.tar.gz Spelling] (extended word list) 2005-08-19
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/sw_KE.zip Spelling] 2004-05-16
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/sw_KE-pack.zip Pack] 2004-05-16

== Kurdish (Turkey, Syria) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ku_TR.zip Spelling] 2005-01-21
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ku-pack.zip Pack] 2005-01-21

== Latin (x-register) ==
* Spelling:

**[http://www.drouizig.org/Saozneg/Misc/misc-Latinspellchecker.html COL1.0ß] 2006-01-27 by Marjorie Burghart
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/la-pack.zip Pack] 2002-05-05

== Latvian (Latvia) ==
* [ftp://ftp.stardiv.de/pub/OpenOffice.org/contrib/dictionaries/lv_LV.zip Spelling] v.0.8b1 2009-05-09

== Lingala (Democratic Republic of the Congo) ==
* [http://softlayer.dl.sourceforge.net/sourceforge/lingala/ln_CD.zip Spelling] 2009-04-03

== Lithuanian (Lithuania) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/lt_LT.zip Spelling] 2003-12-31
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_lt_LT.zip Hyphenation] 2004-01-10
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/lt_LT-pack.zip Pack] 2004-04-05

== Luxembourgish (Luxembourg) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/lb-dict Extension]
* [http://www.spellchecker.lu/ Spellchecker.lu] Project Website, in Luxembourgish
* [http://downloads.spellchecker.lu/packages/OOo2/ OOo2 Pack] Notes: updated regularly, needs OOo >= 2.0.2
* [http://downloads.spellchecker.lu/packages/OOo3/ OOo3 Extension] Notes: updated regularly

== Malagasy (Madagascar) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/mg_MG.zip Spelling] 2005-01-09

== Malay (Malaysia) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ms_MY.zip Spelling] 2005-01-17
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ms_MY-pack.zip Pack] 2005-01-17

== Māori (Aotearoa) ==
[http://papakupu.maori.nz/ Te Papakupu Māori] should be considered the source for Māori dictionaries from now on.
The following packages are being auto-generated:
* [http://packages.papakupu.maori.nz/hunspell/ Spelling] dictionary for Hunspell, includes regional dialects.
* [http://packages.papakupu.maori.nz/hunspell-hyphen/ Hyphenation] rules for Hunspells' Hyphen.
* [http://packages.papakupu.maori.nz/mythes/ Thesaurus] for MyThes.
* [http://packages.papakupu.maori.nz/openoffice2/ OpenOffice.org 2 Pack] includes spelling dictionary, no regional dialects. Beta version also includes hyphenation rules and thesaurus.
* [http://extensions.services.openoffice.org/project/maori-papakupu OpenOffice.org 3 Extension] includes spelling dictionary, hyphenation rules, and thesaurus, no regional dialects.
* [http://packages.papakupu.maori.nz/ Everything else] For all supported software including the above.

Contact me if you would like tailored packages auto-generated for upstream projects.

-- [[User:Kiharoa|Kiharoa]]

== Macedonian (Former Yugoslav Republic of Macedonia) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/mk_MK.zip Spelling] 2005-11-26

== Marathi (India) ==
* [http://ftp.stardiv.de/pub/OpenOffice.org/contrib/dictionaries/mr_IN.zip Spelling] 2006-09-26
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/dicooo/mr_IN_pack.zip Pack] 2006-09-26

== Malayalam (India) ==
* [http://ftp.twaren.net/Unix/NonGNU/smc/Spellchecker/ooo-hunspell-ml-0.1.tar.bz2 Spelling] 2008-05-19
* [http://git.savannah.gnu.org/cgit/smc.git/tree/hyphenation Hyphenation] 2008-05-19

== Mongolian (Mongolia) ==

* [http://www.openoffice.org/issues/show_bug.cgi?id=92263 Spelling] 2008-07-29 (see the attachment)


== Ndebele (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/nr_ZA.zip Spelling] 2006-01-20
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/nr_ZA-pack.zip Pack] 2006-01-20
* [http://translate.org.za/download/spellchecker/ndebele/ Spelling, Pack, Word lists (Experimental/Development)]

== Nepali (Nepal) ==
* [http://nepalinux.org/downloads/ne_NP_dict.zip Spelling] 2006-10-17
* [http://nepalinux.org/downloads/thes_np_NP_v2.zip Thesaurus] requires OpenOffice.org 2.x or later, 2006-12-20

== Northern Sotho (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ns_ZA.zip Spelling] 2006-01-20
* [http://translate.org.za/download/spellchecker/northern_sotho/ Spelling, Pack, Word lists (Experimental/Development)]

== Norwegian (Norway) ==
* Spelling:
** [http://alioth.debian.org/frs/download.php/2357/no_NO-pack2-2.0.10.zip Norwegian Bokmål & Nynorsk (Norway) pack for OOo '''2.x'''] 2008-03-10
** [http://alioth.debian.org/frs/download.php/2358/no_NO-pack1-2.0.10.zip Norwegian Bokmål & Nynorsk (Norway) pack for OOo '''1.x'''] 2008-03-10
** Older versions:
*** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/nb_NO.zip Norwegian Bokmål (Norway)] 2006-05-08
*** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/nn_NO.zip Norwegian Nynorsk (Norway)] 2006-05-08
*** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/no_NO-pack.zip Pack] 2005-01-12
*** [http://alioth.debian.org/frs/?group_id=30577 All older versions, including sources]

== Occitan (France) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/oc_FR.zip Spelling (Languedocien)] 2006-09-22

== Oriya (India) ==
* [http://hunspell.sourceforge.net/or-demo.tar.gz Spelling] 2005-01-25

== Papiamentu (Netherlands Antilles) ==
* no information yet

== Persian (Iran) ==
* [http://hunspell.sourceforge.net/fa_IR.tar.bz2 Spelling] 2007-08-16

== Polish (Poland) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/pl-dict Extension]
* [http://pl.openoffice.org/pliki/pl_PL.zip Spelling] 2006-12-02
* [http://pl.openoffice.org/pliki/hyph_pl_PL.zip Hyphenation] 2006-07-26
* [http://pl.openoffice.org/pliki/thes_pl_PL_v2.zip Thesaurus] requires OpenOffice.org 2.x or later, 2006-12-23
* [http://pl.openoffice.org/pliki/pl_PL-pack.zip Pack] 2006-12-23
* [http://pl.openoffice.org/pliki/thes_pl_PL.zip Thesaurus] only for OpenOffice.org 1.x, 2006-12-23

== Portuguese (Portugal + Brasil) ==
* Spelling:
** [http://natura.di.uminho.pt/download/sources/Dictionaries/myspell Portuguese (Portugal)] 2006-10-26
** [http://www.openoffice.org.br/?q=verortografico Portuguese (Brazil)] 2006-10-17
* Hyphenation:
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_pt_PT.zip Portuguese (Portugal)] 2002-10-21
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_pt_BR.zip Portuguese (Brazil)] 2002-10-21
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/pt_PT-pack.zip Pack] 2003-12-30

== Punjabi (India) ==
* [http://hunspell.sourceforge.net/pa-demo.tar.gz Spelling] 2005-01-25

== Quechua (Bolivia) ==
* [http://hunspell.sourceforge.net/qu_BO-pack.zip Pack] (Spelling) 2007-05-09
== Quichua (Ecuador) ==
* [http://hunspell.sourceforge.net/qu_EC-pack.zip Pack] AWAITING STORAGE (Spelling) 2009-03-02

== Romanian (Romania) ==
'''OpenOffice.org 3.x extensions:''' [http://extensions.services.openoffice.org/project/dictionaries-ro-contemporary Contemporary], [http://extensions.services.openoffice.org/project/dictionaries-ro-classic Classic]

'''''Extensii OpenOffice.org 3.0:'''''
[http://extensions.services.openoffice.org/project/dictionaries-ro-contemporary Dicţionare contemporane (â din a / după 1993)], [http://extensions.services.openoffice.org/project/dictionaries-ro-classic Dicţionare clasice (î din i / ante 1993)]. ''Ambele extensii cuprind un corector ortografic, un dicţionar de sinonime, şi un dicţionar de despărţire în silabe. În cazul în care se dorește compatibilitatea cu utilizatorii care folosesc platforme cu suport incomplet pentru limba română (precum Windows XP), se recomandă folosirea dicționarelor împreună cu extensia '' [http://extensions.services.openoffice.org/project/RomanianDiacritics Diacritice românești]. ''Această extensie permite introducerea caracterelor diacritice românești și conversia textului dintr-un format de caractere în altul. Suport pentru [http://extensions.services.openoffice.org/project/AutocorrectRomanian autocorectare] este de asemenea disponibil ''

'''Source Code and OpenOffice.org 2.x Dictionaries:
'''
* [http://downloads.sourceforge.net/rospell/ro_RO.3.2.zip Spelling] 2008-07-06 - latest release
* [http://downloads.sourceforge.net/rospell/hyph_ro_RO.3.3-test3.zip Hyphenation] 2008-10-12
* [http://downloads.sourceforge.net/rospell/th_ro_RO.3.3-test3.zip Thesaurus] 2008-09-21

'''Previous releases:
'''
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ro_RO-pack.zip Pack] 2004-04-05
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ro_RO.zip Spelling] 2005-02-27
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_ro_RO.zip Hyphenation] 2005-02-21
* [http://www.archeus.ro/Download/OpenOffice/CorectorOrtografic/1.1/ro_RO.zip Spelling (Experimental)] 2007-05-12 - see [http://www.archeus.ro/lingvistica/CorectorOrtografic description (romanian)]
* [http://downloads.sourceforge.net/rospell/ro_RO.3.1.zip Spelling] 2008-04-09

== Russian (Russia) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/dict_ru_RU Extension]
OpenOffice.org 2.x:
* Spelling:
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ru_RU.zip Russian (Russia)] 2004-04-06
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ru_RU_ye.zip Russian ye (Russia)] 2003-09-11
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ru_RU_yo.zip Russian yo (Russia)] 2004-04-06
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_ru_RU.zip Hyphenation] 2002-07-27
* [http://download.i-rs.ru/pub/openoffice/dict/thes_ru_RU_v2.zip Thesaurus] 2007-06-13
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ru_RU-pack.zip Pack] 2004-04-06

== Sami ==
* [http://divvun.no/static_files/smi.zip Spelling] 2008-05-23
* [http://divvun.no/static_files/smi-pack.zip Pack] 2008-05-23

== Scottish Gaelic (Scotland) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/gd_GB.zip Spelling] 2005-01-08

== Serbian (Serbia, Republic Srpska) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/dict-sr Extension]
* [http://ooo.matf.bg.ac.rs/dict-sr/sr-20090213.zip Spelling] 2009-02-13
* [http://ooo.matf.bg.ac.rs/dict-sr/hyph_sr-20090213.zip Hyphenation] 2009-02-13

Spelling dictionary includes both Cyrillic (sr) and Latin (sh) wordlist.

== Setswana (Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/tn_ZA.zip Spelling] 2004-05-16
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/tn_ZA-pack.zip Pack] 2004-05-16
* [http://translate.org.za/download/spellchecker/tswana/myspell-tn_ZA-20060123.zip Spelling (Experimental)] 2006-01-23
* [http://translate.org.za/download/spellchecker/tswana/myspell-pack-tn-ZA-20060123.zip Pack (Experimental)] 2006-01-23
* [http://translate.org.za/download/spellchecker/tswana/ Spelling, Pack, Word lists (Experimental/Development)]

== Slovak (Slovakia) ==

* [http://www.sk-spell.sk.cx/file_download/63/hunspell-sk-20090330.zip Spelling] 2009-03-30 (see [http://www.sk-spell.sk.cx/hunspell-sk hunspell-sk])
* [http://www.sk-spell.sk.cx/thesaurus/download/OOo-Thesaurus2-sk_SK.zip Thesaurus] 2009-03-30 (weekly updated; see: [http://www.sk-spell.sk.cx/thesaurus/ OpenThesaurus-SK - Slovenský synonymický slovník])
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_sk_SK.zip Hyphenation] 2003-12-27
* [http://www.sk-spell.sk.cx/file_download/62/acor_sk.oxt Slovak autocorrection] 2008-06-01
* [http://extensions.services.openoffice.org/node/1144 Slovak dictionary plug-in for OpenOffice.org 3] 2009-03-30

For other information/files please check [http://www.sk-spell.sk.cx/ sk-spell project] or [http://www.sk-spell.sk.cx/openofficeorg-sk openoffice.org-sk]






== Slovenian (Slovenia) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/sl_SI.zip Spelling] 2007-01-27
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_sl_SI.zip Hyphenation] 2007-01-27
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/sl_SI-pack.zip Pack] 2007-01-27
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/thes_sl_SI_v2.zip Thesaurus] 2008-01-26 ([http://www.tezaver.si experimental - click here for updates])

== Southern Sotho (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/st_ZA.zip Spelling] 2006-01-20
* [http://translate.org.za/download/spellchecker/southern_sotho/ Spelling, Pack, Word lists (Experimental/Development)]

== Spanish (Spain, ...) ==
* Spelling:
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/es_ES.zip Spanish (Spain-etal)] 2005-05-10
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/es_MX.zip Spanish (Mexico)] 2005-05-05
** [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/Math_es_ES.zip Math_es_ES] 2004-04-05
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_es_ES.zip Hyphenation] 2004-08-10
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/es_ES-pack.zip Pack] 2005-01-18

For IE7Pro Spellchecker
* [http://erwin.ried.cl/files/articles/_public/esp_ie7pro_2007_04_09.rar Spanish (Spain-etal) Autoinstaller]

== Swazi/Swati (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ss_ZA.zip Spelling] 2006-07-05
* [http://translate.org.za/download/spellchecker/swati/ Spelling, Pack, Word lists (Experimental/Development)]

== Swedish (Sweden) ==
* [http://extensions.services.openoffice.org/project/dict-sv Spelling]
* [http://extensions.services.openoffice.org/project/SweThes Thesaurus]
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_sv_SE.zip Hyphenation] 2003-08-14

The above requires OpenOffice.org 3.0.0 or later.

== Tagalog (Philippines) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/tl_PH.zip Spelling] 2005-01-08

== Tamil (India) ==
* [http://hunspell.sourceforge.net/ta-demo.tar.gz Spelling] 2004-08-25

== Tetum (Indonesia) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/tet_ID.zip Spelling] 2005-01-08

== Thai (Thailand) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/th_TH.zip Spelling] 2006-12-12

== Tsonga (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ts_ZA.zip Spelling] 2006-01-23
* [http://translate.org.za/download/spellchecker/tsonga/ Spelling, Pack, Word lists (Experimental/Development)]

== Ukrainian (Ukraine) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/uk_UA.zip Spelling] 2009-01-25
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/hyph_uk_UA.zip Hyphenation] 2003-09-03
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/uk_UA-pack.zip Pack] 2005-11-06

== Urdu (Pakistan, India) ==
* [http://ftp.stardiv.de/pub/OpenOffice.org/contrib/dictionaries/ur_PK.zip Spelling] 2007-01-26
also bound to Urdu (India)

== Uzbek (Uzbekistan) ==
* [http://hunspell.sourceforge.net/uz-demo.tar.gz Spelling] (Cyrillic) 2005-04-27

== Venda (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/ve_ZA.zip Spelling] 2006-07-06
* [http://translate.org.za/download/spellchecker/venda/ Spelling, Pack, Word lists (Experimental/Development)]

== Vietnamese (Vietnam) ==
* OpenOffice.org 3.x [http://extensions.services.openoffice.org/project/Vietnamese_SpellChecker Extension]
* [http://hunspell-spellcheck-vi.googlecode.com/files/vi_VN.zip Spelling] 2008-06-04
* [http://hunspell-spellcheck-vi.googlecode.com/files/PackVietnamese.zip Pack] 2008-06-04
* [http://hunspell-spellcheck-vi.googlecode.com/ Project Forge]

== Wayunaiki (Venezuela) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/??_VE.zip Spelling (Experimental/Development)] 2006-??-??

== Welsh (Wales) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/cy_GB.zip Spelling] 2004-04-25
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/cy_GB-pack.zip Pack] 2004-04-30

== Xhosa (South Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/xh_ZA.zip Spelling] 2006-01-23
* [http://translate.org.za/download/spellchecker/xhosa/ Spelling, Pack, Word lists (Experimental/Development)]

== Zulu (Africa) ==
* [http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries/zu_ZA.zip Spelling] 2006-01-20
* [http://translate.org.za/download/spellchecker/zulu/ Spelling, Pack, Word lists (Experimental/Development)]

[[Category:Localization]]

KeyID Build

2009-11-08T11:14:51Z

Timarandras: /* Making your own KeyID build */ formatting only

[[ko:KO/KeyID_Build]]

A KeyID build is a special build used mainly for translation-related QA work on localized builds. It helps to identify UI (User Interface) and OLH (Online Help) strings based on their KeyID. A KeyID is a unique 6-digits number that serves as identifier of the string in the Sun's translation database.

[[image:Regular_build_menu.png|left|thumb|250px|[[Media:Regular_build_menu.png|Regular build menu - see full size]]]]
[[image:Keyid_build_menu.png|left|thumb|303px|[[Media:Keyid_build_menu.png|KeyID build menu - see full size]]]]

There is no functional difference between a regular build and a KeyID build. The difference between the two is that the KeyID build displays the KeyIDs of the strings in the UI and OLH. KeyID builds are regular provided for all Sun provided languages each release. See the announcements in the dev@l10n mailing list.

See the illustrating screenshots taken on a French regular and KeyID build:

== Where to find en-US sdf files ? ==
For every milestone en-US sdf files are created. You can download them from one of the mirrors in:
http://distribution.openoffice.org/mirrors/#extmirrors

For example:
http://ftp.rz.tu-bs.de/pub/mirror/OpenOffice.org/extended/ooomisc/sdf/

== Making your own KeyID build ==
There is a script which can be used to add KeyIDs of a new kind to an existing sdf file.
{{Documentation/Note| These KeyIDs are different from those in the database but might well get standard soon.}}
{{Documentation/Note| You should use gsicheck before adding KeyIDs. If you have to gsicheck a file with keyIDs, use the -k key to prevent errors regarding KeyIDs.}}
The script is located in the Sources in module transex3 in the Path scripts\keyidGen.pl
Call it without parameters for usage help.

[[Category:Localization]]
[[Category:Quality Assurance]]
[[Category:Build_System]]

HU/Documentation/BASIC Guide/Editing Text Documents

2009-11-04T18:05:14Z

Timarandras: A A -> A

{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Structure of Text Documents
|NextPage=HU/Documentation/BASIC Guide/More Than Text
|textdocs=block
}}
{{DISPLAYTITLE:Szöveges dokumentumok szerkesztése}}
__NOTOC__
Az előző részek már leírták a szöveges dokumentumok szerkesztésének számos módját, főleg a <idl>com.sun.star.text.TextPortion</idl> és a <idl>com.sun.star.text.Paragraph</idl> szolgáltatást, amelyek hozzáférést biztosítanak a bekezdésrészekhez, illetve a bekezdésekhez. Ezek a szolgáltatások olyankor megfelelőek, ha a szöveget egy menetben, egy ciklussal akarjuk szerkeszteni. Viszont ez nem minden helyzetben elegendő. Az {{OOo}} tartalmaz egy <idl>com.sun.star.text.TextCursor</idl> szolgáltatást a bonyolultabb feladatok elvégzéséhez, beleértve a dokumentumokban visszafelé történő navigálást és a <tt>TextPortions</tt> helyett szavakon és mondatokon alapuló navigálást.

== A TextCursor ==

A <tt>TextCursor</tt> az {{OOo}} API-ban hasonló, mint az {{OOo}}-dokumentumban használt látható kurzor. Egy adott pontot jelöl a szöveges dokumentumban, és különböző irányokban mozgatható a megfelelő parancsok használatával. Az {{OOo}} Basic <tt>TextCursor</tt> objektumát nem szabad összetéveszteni a látható kurzorral. Ez két különböző dolog.

{{Documentation/Note|A VBA-ban használt terminológiától való eltérések: A működését tekintve a VBA Range objektumához az {{OOo}} TextCursor objektuma hasonlítható, és nem – bár a neve ezt sugallja – az {{OOo}} Range objektuma.}}

Például az {{OOo}} TextCursor objektuma olyan metódusokat biztosít a szövegben történő navigáláshoz és a szöveg módosításához, amelyek a VBA Range objektumában találhatók meg (például MoveStart, MoveEnd, InsertBefore és InsertAfter). Az {{OOo}} TextCursor objektumának fenti VBA-függvényeknek megfelelő függvényei a következő részekben kerülnek ismertetésre.

=== Navigálás a szövegben ===

Az {{OOo}} Basic <tt>TextCursor</tt> objektuma független a szöveges dokumentumban látható kurzortól. A <tt>TextCursor</tt> objektum programvezérelt pozíciómódosítása nincs semmilyen hatással a látható kurzorra. Számos <tt>TextCursor</tt> objektum megnyitható ugyanabban a dokumentumban, és használható különböző pozíciókban, amelyek függetlenek egymástól.

A <tt>TextCursor</tt> objektumot a <tt>createTextCursor</tt> metódussal lehet létrehozni:

<source lang="oobas">
Dim Doc As Object
Dim Cursor As Object

Doc = StarDesktop.CurrentComponent
Cursor = Doc.Text.createTextCursor()
</source>

Az így létrehozott Cursor objektum támogatja a <tt>com.sun.star.text.TextCursor</tt> szolgáltatást, amely számos metódust biztosít a szöveges dokumentumokban történő navigáláshoz. A következő példa először balra mozgatja tíz karakterrel a <tt>TextCursor</tt>-t, majd három karakterrel jobbra.

<source lang="oobas">
Cursor.goLeft(10, False)
Cursor.goRight(3, False)
</source>

A <tt>TextCursor</tt> kijelölhet egy teljes területet is. Ez ahhoz hasonló, mint amikor kijelölünk egy részt az egérrel. A <tt>False</tt> paraméter az előző függvényben azt adja meg, hogy ki legyen-e jelölve a kurzor által bejárt terület. Például a <tt>TextCursor</tt> a

<source lang="oobas">
Cursor.goLeft(10, False)
Cursor.goRight(3, True)
</source>

kódban először tíz karaktert mozog jobbra kijelölés nélkül, majd három karaktert vissza, amelyeket ki is jelöl. Így a <tt>TextCursor</tt> által kijelölt terület a hetedik karakter után kezdődik a szövegben, és a tizedik karakter után ér véget.

Az alábbiakban láthatók a <idl>com.sun.star.text.TextCursor</idl> szolgáltatás főbb metódusai, amelyek a navigációra szolgálnak:

;<tt>goLeft (Karakterszám, Kijelölés)</tt>:balra lép Karakterszám karaktert.
;<tt>goRight (Karakterszám, Kijelölés)</tt>:balra lép Karakterszám karaktert.
;<tt>gotoStart (Kijelölés)</tt>:a szöveges dokumentum elejére ugrik.
;<tt>gotoEnd (Kijelölés)</tt>:a szöveges dokumentum végére ugrik.
;<tt>gotoRange (TextRange, Kijelölés)</tt>:a megadott <tt>TextRange</tt> objektumra ugrik.
;<tt>gotoStartOfWord (Kijelölés)</tt>:az aktuális szó elejére ugrik.
;<tt>gotoEndOfWord (Kijelölés)</tt>:az aktuális szó végére ugrik.
;<tt>gotoNextWord (Kijelölés)</tt>:a következő szó elejére ugrik.
;<tt>gotoPreviousWord (Kijelölés)</tt>:az előző szó elejére ugrik.
;<tt>isStartOfWord ()</tt>:<tt>True</tt> (igaz) értéket ad vissza, ha a <tt>TextCursor</tt> egy szó elején áll.
;<tt>isEndOfWord ()</tt>:<tt>True</tt> (igaz) értéket ad vissza, ha a <tt>TextCursor</tt> egy szó végén áll.
;<tt>gotoStartOfSentence (Kijelölés)</tt>:az aktuális mondat elejére ugrik.
;<tt>gotoEndOfSentence (Kijelölés)</tt>:az aktuális mondat végére ugrik.
;<tt>gotoNextSentence (Kijelölés)</tt>:a következő mondat elejére ugrik.
;<tt>gotoPreviousSentence (Kijelölés)</tt>:az előző mondat elejére ugrik.
;<tt>isStartOfSentence ()</tt>:<tt>True</tt> (igaz) értéket ad vissza, ha a <tt>TextCursor</tt> egy mondat elején áll.
;<tt>isEndOfSentence ()</tt>:<tt>True</tt> (igaz) értéket ad vissza, ha a <tt>TextCursor</tt> egy mondat végén áll.
;<tt>gotoStartOfParagraph (Kijelölés)</tt>:az aktuális bekezdés elejére ugrik.
;<tt>gotoEndOfParagraph (Kijelölés)</tt>:az aktuális bekezdés végére ugrik.
;<tt>gotoNextParagraph (Kijelölés)</tt>:a következő bekezdés elejére ugrik.
;<tt>gotoPreviousParagraph (Kijelölés)</tt>:az előző bekezdés elejére ugrik.
;<tt>isStartOfParagraph ()</tt>:<tt>True</tt> (igaz) értéket ad vissza, ha a <tt>TextCursor</tt> egy bekezdés elején áll.
;<tt>isEndOfParagraph ()</tt>:<tt>True</tt> (igaz) értéket ad vissza, ha a <tt>TextCursor</tt> egy bekezdés végén áll.

A szöveget a program a mondatjelek alapján tagolja mondatokká. Például a pontot a mondat végeként értelmezi a program.

A <tt>Kijelölés</tt> paraméter egy logikai érték, amely megadja, hogy a kurzor által bejárt területet ki kell-e jelölni. Ezenfelül minden navigálási metódus visszaad egy logikai paramétert, amely azt jelzi, hogy a navigálás sikeres volt-e, vagy a kevés szöveg miatt sikertelen.

A következő lista az olyan metódusokat sorolja fel, amelyekkel a <tt>TextCursor</tt> használatával a kijelölt részek szerkeszthetők, és amelyek támogatják a <idl>com.sun.star.text.TextCursor</idl> szolgáltatást:

;<tt>collapseToStart ()</tt>:visszavonja a kijelölést, és a <tt>TextCursor</tt>-t az előzőleg kijelölt terület elejére mozgatja.
;<tt>collapseToEnd ()</tt>:visszavonja a kijelölést, és a <tt>TextCursor</tt>-t az előzőleg kijelölt terület végére mozgatja.
;<tt>isCollapsed ()</tt>:<tt>True</tt> (igaz) értéked ad vissza, ha a <tt>TextCursor</tt> nem jelölt ki egy területet sem.

=== Szöveg formázása a TextCursor-ral ===

A <idl>com.sun.star.text.TextCursor</idl> szolgáltatás támogatja az összes karakter- és bekezdéstulajdonságot, amelyek már ismertetve voltak a fejezet elején.

A következő példa bemutatja, ezek hogyan használhatók a <tt>TextCursor</tt>-ral együtt. A program végiglépdel egy teljes dokumentumon, és minden mondat első szavát félkövérré formázza.

<source lang="oobas">
Dim Doc As Object
Dim Cursor As Object
Dim Proceed As Boolean

Doc = StarDesktop.CurrentComponent
Cursor = Doc.Text.createTextCursor

Do
Cursor.gotoEndOfWord(True)
Cursor.CharWeight = com.sun.star.awt.FontWeight.BOLD
Proceed = Cursor.gotoNextSentence(False)
Cursor.gotoNextWord(False)
Loop While Proceed
</source>

A példaprogram először létrehoz egy dokumentumobjektumot a megnyitott szöveg számára. Ezután végiglépdel a teljes szövegen mondatról mondatra, kijelöli az első szavakat és félkövérré formázza azokat.

=== Szöveg tartalmának beolvasása és módosítása ===

Ha a <tt>TextCursor</tt> kijelölt területet tartalmaz, akkor ez a szöveg elérhető a <tt>TextCurson</tt> objektum <tt>String</tt> tulajdonságán keresztül. A következő példa a <tt>String</tt> tulajdonságot használja, hogy megjelenítse a mondatok első szavát egy üzenetablakban:

<source lang="oobas">
Dim Doc As Object
Dim Cursor As Object
Dim Proceed As Boolean

Doc = StarDesktop.CurrentComponent
Cursor = Doc.Text.createTextCursor

Do
Cursor.gotoEndOfWord(True)
MsgBox Cursor.String
Proceed = Cursor.gotoNextSentence(False)
Cursor.gotoNextWord(False)
Loop While Proceed
</source>

A mondatok első szava ugyanígy módosítható a <tt>String</tt> tulajdonság használatával:

<source lang="oobas">
Dim Doc As Object
Dim Cursor As Object
Dim Proceed As Boolean

Doc = StarDesktop.CurrentComponent
Cursor = Doc.Text.createTextCursor

Do
Cursor.gotoEndOfWord(True)
Cursor.String = "Helló"
Proceed = Cursor.gotoNextSentence(False)
Cursor.gotoNextWord(False)
Loop While Proceed
</source>

Ha a <tt>TextCursor</tt> kijelölt területet tartalmaz, a <tt>String</tt> tulajdonság lecseréli azt egy új szöveggel. Ha nincs kijelölve semmi, akkor a szöveg a <tt>TextCursor</tt> aktuális pozíciójában lesz beszúrva.

=== Vezérlőkódok beszúrása ===

Néha nem a dokumentum szövegét kell módosítani, hanem a struktúráját. Az {{OOo}} ehhez vezérlőkódokat biztosít. Ezeket a szövegbe lehet beszúrni, és módosítják annak struktúráját. A vezérlőkódok a <idl>com.sun.star.text.ControlCharacter</idl> állandócsoportban vannak definiálva. A következő vezérlőkódok állnak rendelkezésre az {{OOo}}-ban:

;<tt>PARAGRAPH_BREAK</tt>:bekezdéstörés
;<tt>LINE_BREAK</tt>:sortörés a bekezdésen belül.
;<tt>SOFT_HYPHEN</tt>:lehetséges elválasztási pont
;<tt>HARD_HYPHEN</tt>:kötelező elválasztási pont.
;<tt>HARD_SPACE</tt>:védett szóköz, amely nem lesz széthúzva, sem összenyomva a sorkizárt szövegben.

A vezérlőkódok beszúrásához nem csak a kurzorra van szükség, hanem a hozzá tartozó dokumentumobjektumokra. A következő példa beszúr egy bekezdést a szöveg 20. karaktere után:

<source lang="oobas">
Dim Doc As Object
Dim Cursor As Object
Dim Proceed As Boolean

Doc = StarDesktop.CurrentComponent
Cursor = Doc.Text.createTextCursor
Cursor.goRight(20, False)
Doc.Text.insertControlCharacter(Cursor, _
com.sun.star.text.ControlCharacter.PARAGRAPH_BREAK, False)
</source>

A <tt>False</tt> (hamis) paraméter az <tt>insertControlCharacter</tt> metódus meghívásánál biztosítja, hogy a <tt>TextCursor</tt> által jelenleg kijelölt terület kijelölve maradjon a beszúrás után. Ha a <tt>True</tt> (igaz) paramétert adjuk át, akkor az <tt>insertControlCharacter</tt> lecseréli az aktuális szöveget.

== Szövegrészek keresése ==

Sokszor előfordul, hogy egy adott szövegre kell rákeresni, és azt a szöveget szerkeszteni. Minden {{OOo}}-dokumentum biztosít egy speciális felületet erre a célra, amely a következőképpen működik: Keresés előtt létre kell hozni egy <tt>SearchDescriptor</tt> objektumot. Ez adja meg, mit keressen az {{OOo}} a dokumentumban. A <tt>SearchDescriptor</tt> egy olyan objektum, amely támogatja a <tt>com.sun.star.util.SearchDescriptor</tt> szolgáltatást, és a dokumentum <tt>createSearchDescriptor</tt> metódusával hozható létre:

<source lang="oobas">
Dim SearchDesc As Object
SearchDesc = Doc.createSearchDescriptor
</source>

Ha létrehoztuk a <tt>SearchDescriptor</tt> objektumot, akkor meg kell adni a keresendő szöveget:

<source lang="oobas">
SearchDesc.searchString="bármilyen szöveg"
</source>

A funkcióját tekintve a <tt>SearchDescriptor</tt> leginkább az {{OOo}} keresési párbeszédablakára hasonlít. A keresési ablakhoz hasonlóan a <tt>SearchDescriptor</tt> objektumnál is megadhatók a keresési feltételek.

A <idl>com.sun.star.util.SearchDescriptor</idl> szolgáltatás által biztosított tulajdonságok:

;<tt>SearchBackwards (logikai érték)</tt>:visszafelé keres a szövegben.
;<tt>SearchCaseSensitive (logikai érték)</tt>:megkülönbözteti a kis- és nagybetűket keresés közben.
;<tt>SearchRegularExpression (logikai érték)</tt>:a keresendő szöveget reguláris kifejezésként kezeli.
;<tt>SearchStyles (logikai érték)</tt>:megkeresi a szövegben a megadott bekezdéssablont.
;<tt>SearchWords (logikai érték)</tt>:csak teljes szavakat keres.

Az {{OOo}} <tt>SearchSimilarity</tt> (vagy más néven „hasonlók keresése”) funkció is rendelkezésre áll az {{OOo}} programban. Ezzel a funkcióval az {{OOo}} olyan kifejezésre keres, amely hasonló, de nem pont azonos a keresési kifejezéssel. A hozzáadott, törölt és módosított karakterek száma a ezekben a kifejezésekben egyenként megadható. Az alábbiakban láthatók a <tt>com.sun.star.util.SearchDescriptor</tt> szolgáltatás ide tartozó tulajdonságai:

;<tt>SearchSimilarity (logikai érték)</tt>:hasonló szavak keresése.
;<tt>SearchSimilarityAdd (rövid egész szám)</tt>:karakterek száma, amelyek hozzáadhatók hasonló szavak keresésénél.
;<tt>SearchSimilarityExchange (rövid egész szám)</tt>:karakterek száma, amelyek lecserélhetők hasonló szavak keresésénél.
;<tt>SearchSimilarityRemove (rövid egész szám)</tt>:karakterek száma, amelyek eltávolíthatók hasonló szavak keresésénél.
;<tt>SearchSimilarityRelax (logikai érték)</tt>:egyszerre vesz figyelembe minden eltérési szabályt hasonló szavak keresésénél.

Amint a <tt>SearchDescriptor</tt> megfelelően be van állítva, alkalmazható a következő dokumentumon. Az {{OOo}}-dokumentumok biztosítanak egy <tt>findFirst</tt> és egy <tt>findNext</tt> metódust ebből a célból:

<source lang="oobas">
Found = Doc.findFirst (SearchDesc)

Do While Found
' Keresési eredmények szerkesztése...
Found = Doc.findNext( Found.End, Search)
Loop
</source>

Ez a példaprogram egy ciklussal megkeres minden egyezést, és visszaad egy <tt>TextRange</tt> objektumot, amely a megtalált szövegre hivatkozik.

=== Példa: Hasonlóak keresése ===

A következő példa megkeresi a szövegben a „kutya” szót, és a találatokat félkövérre formázza. A program hasonló szavakat keres, ezért nem csak a „kutya” szót találja meg, hanem a „kutyák” és a „kutyus” szót is. A megtalált kifejezések két karakterrel térhetnek el a keresett kifejezéstől:

<source lang="oobas">
Dim SearchDesc As Object
Dim Doc As Object

Doc = StarDesktop.CurrentComponent
SearchDesc = Doc.createSearchDescriptor
SearchDesc.SearchString="kutya"
SearchDesc.SearchSimilarity = True
SearchDesc.SearchSimilarityAdd = 2
SearchDesc.SearchSimilarityExchange = 2
SearchDesc.SearchSimilarityRemove = 2
SearchDesc.SearchSimilarityRelax = False
Found = Doc.findFirst (SearchDesc)

Do While Found
Found.CharWeight = com.sun.star.awt.FontWeight.BOLD
Found = Doc.findNext( Found.End, Search)
Loop
</source>

{{Documentation/Note|Az {{OOo}} programban használt keresés alapjai hasonlóak a VBA-ban használt keresésével. Mindkét felület rendelkezésre bocsát egy objektumot, amelyen keresztül megadhatók a keresési és cserélési feltételek. Ezután ezt az objektumot lehet a kívánt szövegterületen alkalmazni a keresés végrehajtásához. De amíg a VBA-ban a szükséges külső objektumot a Range objektum Find metódusán keresztül lehet elérni, addig az {{OOo}} programban a dokumentumobjektum <tt>createSearchDescriptor</tt> vagy <tt>createReplaceDescriptor</tt> metódusával lehet létrehozni azt. A keresési feltételek és metódusok is különbözőek.}}

Ahogy a régi {{OOo}} API-ban is, az új API-ban is a dokumentumobjektummal lehet a keresést és cserét végrehajtani. Míg előzőleg volt egy <tt>SearchSettings</tt> nevű objektum, főleg a keresési feltételek megadásához, addig az új objektumban a kereséseket a <tt>SearchDescriptor</tt> vagy a <tt>ReplaceDescriptor</tt> objektummal lehet végrehajtani az automatizált szövegcserénél. Ezek az objektumok nem csak a keresési lehetőségeket fedik le, hanem az aktuális szöveg keresését is, és amennyiben szükséges, a szöveg lecserélését is. A leíróobjektumokat a dokumentumobjektum használatával lehet létrehozni, ezután be kell állítani a megfelelő értékeiket, majd visszakerülnek paraméter formájában a dokumentumobjektumhoz a kereséshez.

== Szövegrészek lecserélése ==

Akárcsak a keresési funkció, az {{OOo}} cserefunkciója is elérhető az {{OOo}} Basicben. A program a két funkciót azonosan kezeli. A cserénél is először létre kell hozni egy speciális objektumot, amely tartalmazza a megfelelő paramétereket. Ez az objektum a <tt>ReplaceDescriptor</tt> nevű objektum, amely támogatja a <idl>com.sun.star.util.ReplaceDescriptor</idl> szolgáltatást. A <tt>SearchDescriptor</tt> összes tulajdonsága, amelyet az előző bekezdésbe láthattunk, támogatott <tt>ReplaceDescriptor</tt> objektumban is. Például a cserénél a kis- és nagybetűk megkülönböztetését szintén ki és be lehet kapcsolni, és hasonló szavak keresése is végrehajtható.

A következő példa bemutatja a <tt>ReplaceDescriptors</tt> használatát egy {{OOo}}-dokumentumon belüli keresésnél.

<source lang="oobas">
Dim I As Long
Dim Doc As Object
Dim Replace As Object
Dim Nevek(5) As String
Dim Becenevek(5) As String

Nevek() = Array("András", "Bernadett", "Diána", "Márta", _
"Miklós", "Tamás")
Becenevek() = Array("Bandi", "Betti", "Dia", "Márti", _
"Miki", "Tomi")

Doc = StarDesktop.CurrentComponent
Replace = Doc.createReplaceDescriptor

For I = 0 To 5
Replace.SearchString = Nevek(I)
Replace.ReplaceString = Becenevek(I)
Doc.replaceAll(Replace)
Next I
</source>

A keresendő és cserélendő kifejezéseket a <tt>ReplaceDescriptors</tt> objektum <tt>SearchString</tt> és <tt>ReplaceString</tt> tulajdonságával lehet beállítani. A tényleges cserét végül a dokumentumobjektum <tt>replaceAll</tt> metódusával lehet végrehajtani, amely lecseréli a keresési kifejezés minden előfordulását.

=== Példa: szöveg keresése és cseréje reguláris kifejezésekkel ===

Az {{OOo}} cserefunkciója különösen hatékony tud lenni, ha reguláris kifejezésekkel használjuk. Ezekkel a kifejezésekkel rögzített érték helyett változó kifejezésekre kereshetünk, amelyek tartalmazhatnak helyettesítő karaktereket és speciális karaktereket.

Az {{OOo}} által támogatott reguláris kifejezések részletes leírása az {{OOo}} online súgójában található meg. Az alábbiakban láthatunk néhány példát:

* A keresési kifejezésen belül a pont bármilyen karaktert helyettesít. A m.tat kifejezés ezért lehet <tt>mutat</tt> és <tt>matat</tt> is.
* A ^ karakter a bekezdés elejét jelöli. A <tt>Miklós</tt> név minden előfordulása, amely a bekezdés elején található, megkereshető a <tt>^Miklós</tt> kifejezéssel.
* A $ karakter a bekezdés végét jelöli. A <tt>Miklós</tt> név minden előfordulása, amely a bekezdés végén található, megkereshető a <tt>Miklós$</tt> kifejezéssel.
* A * karakter azt jelzi, hogy az előtte álló karakter akárhányszor szerepelhet. Kombinálható a ponttal is, amely bármilyen karaktert helyettesít. A <tt>na.*i</tt> kifejezés megtalálja a <tt>napi</tt> és a <tt>nappali</tt> szót is.

A következő példa bemutatja, hogyan távolítható az összes üres sor egy szöveges dokumentumból a ^$ reguláris kifejezés használatával:

<source lang="oobas">
Dim Doc As Object
Dim Replace As Object
Dim I As Long

Doc = StarDesktop.CurrentComponent
Replace = Doc.createReplaceDescriptor
Replace.SearchRegularExpression = True
Replace.SearchString = "^$"
Replace.ReplaceString = ""

Doc.replaceAll(Replace)
</source>

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Editing Text Documents}}
{{PDL1}}

Hu.openoffice.org/Magyar Ispell hibabejelentés

2009-05-28T11:01:32Z

Timarandras:

[[Category:felül]]
[[Category:Magyar]]

Ezen az oldalon a [http://magyarispell.sourceforge.net Magyar Ispell szótár] 1.4-es verziójának hibáit, hiányzó szavait lehet jelezni.

Magyar Ispell dictionary bug report page: leave a message about your problem with Hungarian spell checking dictionary [http://magyarispell.sourceforge.net Magyar Ispell].

== Használat ==
A + fülre kattintva lehet új témakört kezdeni. Kettősponttal vagy -pontokkal kezdve a bejegyzésünket, a válasz szintjét lehet jelölni. A hibás vagy hiányzó szót külön sorba, szóközzel kezdve adjuk meg, hogy ilyen keretben jelenjen meg:
példa

A bejegyzéseink végét mindig négy hullámvonallal zárjuk le, ennek hatására megjelenik a nevünk és az aktuális dátum: <pre>~~~~</pre>

A [[Talk:Hu.openoffice.org/Magyar_Ispell_hibabejelent%C3%A9s|vitalapon]] találjuk a visszautasított javaslatokat.

==Fel nem ismert szavak==

Kármán Tódor (vagy manapság: Kármán Irén)
szöveghű, formahű
ligandum, detergens, tautomer, elektroforézis, nukleofil
lantanidák, aktinidák
[[User:Joghurt|Joghurt]] 00:09, 4 June 2008 (CEST)

Bercsényi
Irinyi
Háros
Lehár
Szinyei(-Merse)
Tildi
[[User:Joghurt|Joghurt]] 12:24, 7 November 2008 (CET)

===Földrajzi nevek===

Kaszásdűlő
Nagyhideg-hegy

==== ISO 3166 ====
Anguilla
Aruba
Belize
Bissau-Guinea
Bissau-guineai
Bolivári
Bouvet-sziget
Burkina Faso
Caicos-szigetek
Cocos
Dahomey
Darussalam
Déli-Sandwich-szigetek
Futuna
Grenadines-szigetek
Guadeloupe
Guam
Guernsey
Hasemita
Heard-sziget
Jamahiriya
Johnston-atoll
Keeling
Kitts
Malvinas
Man
San Marinó
Martinique
Mauritius-i
Mayen-sziget
Mayotte
McDonald-szigetek
Midway-atoll
Miquelon
Nauru
Nevis
Niue
Niuei
Norfolk-sziget
Palau
Palaui
Pitcairn-szigetek
Príncipe
Saint-Pierre
Seychelles-szigetek
Svalbard-szigetek
Szaudi-iraqi
Szikkim
Szomáli Demokratikus Köztársaság
Tokelau-szigetek
Vanuatu
Wake-sziget

--[[User:Kkemenczy|Kkemenczy]] 13:33, 17 September 2007 (CEST)

===Nyelvek===
====ISO 639====
acsehnéz
acsoli
adangme
afar
afrihili
afro-ázsiai
ainu
ajmara
akan
akkád
aleman
aleut
algonkin
alsónémet
alsószász
amhara
angiká
arapaho
asszami
asztúriai
atapaszka
ausztroázsiai
avadhí
avesztai
bali
bambara
bamileke
basza
batak
bedzsa
beludzs
bemba
bhasa
bhódzspuri
bihári
bikol
bini
biszlama
blin
bokmal
bradzs
bugisz
conga
cornwalli
creek
csagatáj
csami
csamorro
csejenn
cseva
csibcsa
csicseva
csimsi
csinúk
csippevéj
csoktó
csuang
csvana
dargva
dayak
delavár
dimilí
dimli
divehi
djula
dogri
dogrib
duala
dzongkha
dzsuang
edo
efik
ekajuk
elámi
erzija
eve
evondo
északszoto
fang
filipino
főníciai
friuli
ful
fülöp-szigeteki
ga
ganda
gayo
gbaya
geez
gikuju
Gilbert-szigeti
gorontalo
grebo
guarani
gudzsaráti
guichin
haida
hausza
herero
hiligaynon
himacsali
hiri-motu
hmong
hupa
iban
ido
idzso
igbo
ilokano
inari
indoárja
indo-európai
ingus
interlingua
interlingva
inuktitut
inupiak
jao
ji
jingpo
joruba
judeoarab
judeoperzsa
jupik
kabil
kaddó
kalaallisut
kamba
kannada
kanuri
karacsáj-balkár
karakalpak
karen
kasub
kavi
kecsua
khaszi
khotani
kikuju
kimbundu
kinyarvanda
kirdkí
kirmándzskí
klingon
ko
koiszan
koltta
kongo
kosrae
kónkáni
közép-utó
kpelle
krí
kru
kuanyama
kumük
kurukh
kutenai
kúsita
kwanyama
ladino
lahndá
lamba
land
lao
lezg
limburgi
lingala
lojban
lozi
luba-katanga
luba-lulua
luiseno
lulei
luo
lushai
macedoromán
madurai
magahí
mahaók
maithili
makassari
malagas
malajálam
maldív
mandar
manding
manipuri
manobo
manx
mapucse
mapundungu
maráthi
marwari
maszai
mende
mikmak
minangkabau-maláj
mirandese
moldáv
mongo
mon-khmer
mossi
munda
nauru
navaho
ndebele
ndonga
newari
nias
niger-kordofáni
niue
nílus-szaharai
nogaj
núbiai
nzime
nyamvezi
nyandzsa
nyankore
nyasa
nynorsk
nyoro
ojrát
okcitán
orija
oromo
oszag
otomi
ozsibva
óegyiptomi
ófrancia
óír
pahlavi
palau
pampanga
pandzsábi
pangaszinam
papiamentu
pasto
pedi
pidzsin
ponapei
prákrit
radzsasztáni
rapanui
rarotonga
romani
sepedi
shan
siksika
sino-tibeti
sona
sumér
szalis
szandave
szango
szantáli
szaszak
szebuano
szelkup
szerer
szidámo
szimhala
szindhi
szogd
szomáli
szongai
szoninke
szoto
szranan
szukuma
szuszu
szvázi
tagalog
tamasek
telugu
temne
terena
tetum
tigré
tigrinya
tiv
tlingit
tokelau
tonga
tongo
tukíz
tumbuka
tupi
tuvai
tuvalu
türkmen
tvi
ugariti
umbundu
vai
vakas
valamo
vasho
venda
volapük
vót
waray
wolof
xhosza
yap
zande
zapoték
zázá
zázáki
zenaga
zunyi

--[[User:Kkemenczy|Kkemenczy]] 13:33, 17 September 2007 (CEST)

Ezek egy része nem jó (pl. türkmen→türkmén, sumér→sumer), és sok a gyanús alak (maszai→maszáj?).
Nagy része viszont egy külön idegen szavak modulba mehet, mert elég ritkák. (A Hunspell 1.2.2 már támogatja a
külön modulok egyidejű használatát, és az OpenOffice.org-ba is szeretném ezt megoldani a
közeljövőben.) [[User:Nemeth|Nemeth]] 10:03, 22 February 2008 (CET)

===Pénznemek===
====ISO 4217====
anga
ariary
arubai
austral
baht
balboa
Belize-i
boliviano
bolívar
bosznia-hercegovinai
cedi
colón
córdoba
cruzado
cruzeiro
dirham
dram
ECU
ekwele
emírségekbeli
equadori
florin
fomento
gourde
guarani
guilder
Guinea-Bissau-i
hrivnya
Szent Ilona-i
jamaikai
jordán
jüan
karbovanec
kelet-karib
kina
kip
komorei
kuna
kwacha
kwanza
kyat
lari
lek
lempira
leone
Leone-i
leu
lev
leva
lilangeni
litas
loti
maldív-szigeteki
maloti
manat
naira
nakfa
ngultrum
ouguiya
pa
pataca
peso
pol
pot
Príncipe-i
pula
quetzal
rand
reajustado
real
rial
riál
Rica-i
riel
ringgit
riyál
rodéziai
Salvador-i
Seychelles-szigeteki
sol
sucre
syli
Szaud-arábiai
szom
szomoni
szurinámi
taka
tala
talonas
tenge
Tobago-i
tolár
tugrik
vanuatui
vatu
vietnámi
won
zlotyi

--[[User:Kkemenczy|Kkemenczy]] 13:33, 17 September 2007 (CEST)

===Vegyes===
klakk (régies: fizetett taps)

kihúnyásuk helyett „kihunyásük”-öt javasol
:A prefixumok kezelésének hiánya a toldalékolt alakoknál, ami az utóbbi pár változatban került bele a Hunspellbe sejtésem szerint. Pontosabban a kettős toldalékolásnál (-ás-uk) jelentkezik ez a hiányosság. [[User:Nemeth|Nemeth]] 01:54, 9 May 2007 (CEST)

sárülés
elfogadja, pedig sérülést akartam írni. áé tévesztés gyakori. [[User:Timarandras|Timarandras]] 11:50, 23 May 2007 (CEST)
: Ha sikerülne az Aspell hiányzó tulajdonságainak megvalósítása a Hunspellben, amit tervezek, akkor a billentyűzet kiosztása is tárolásra kerülne, és akkor azt a REP-hez hasonlóan fehasználnám az összetett szavak ellenőrzésénél. [[User:Nemeth|Nemeth]] 10:58, 14 June 2007 (CEST)
:: Sikerült, de mégsem használtam fel, mert túl sok helyes alakzatot tiltanánk le vele. [[User:Nemeth|Nemeth]] 18:25, 11 September 2007 (CEST)

[[User:Timarandras|Timarandras]] 20:31, 21 August 2007 (CEST)

gyorsítótárazva

--[[User:Kkemenczy|Kkemenczy]] 13:36, 17 September 2007 (CEST)

előtető
rtg.
dugalj
szelemen
felületkezelve
növényegészségügyi
[[User:Fg|Fg]] 15:15, 1 February 2008 (CET)
: növény-egészségügyi (7 szótag, 3-as összetétel) [[User:Timarandras|Timarandras]] 13:16, 6 February 2008 (CET)

előttre
[[User:Timarandras|Timarandras]] 13:16, 6 February 2008 (CET)

koordinátarendszer

Itt kötőjelezést javasol, noha ez igazából kéttagú szóösszetétel.

[[User:Joghurt|Joghurt]] 12:23, 22 May 2009 (UTC)

FR/Documentation/Administration Guide/Using Custom Macros and Libraries

2009-05-22T10:31:33Z

Timarandras:

{{FR/Documentation/AdminGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|ShowNextPage=block
|PrevPage=FR/Documentation/Administration Guide/Windows
|NextPage=FR/Documentation/Administration Guide/Using Package Manager
}}
{{DISPLAYTITLE: Macros et bibliothèques {{OOo}} Basic personnalisées }}

{{OOo}} Basic est un langage de programmation utilisable pour l'automatisation des tâches dans {{OOo}}. Les macros {{OOo}} Basic sont stockées dans des modules, qui sont à leur tour placés dans des bibliothèques. Les bibliothèques servent également de conteneurs des boîtes de dialogue créées dans {{OOo}} Basic.
Vous pouvez stocker les bibliothèques Basic dans tout répertoire accessible par l'utilisateur.

{{Documentation/Note|Utilisez les extensions d'{{OOo}} pour procéder à la mise en packages et au déploiement des bibliothèques Basic. Le guide du développeur d'{{OOo}} (Developer's Guide) présente ces [[Documentation/DevGuide/Extensions/Extensions|extensions]] de manière détaillée.}}

==À propos des bibliothèques et modules {{OOo}}==

Les bibliothèques {{OOo}} Basic par défaut sont placées dans le répertoire <tt>''install-dir''/share/basic</tt>
. Une bibliothèque contient les fichiers suivants :
;<tt>script.xlb</tt>: Fichier au format XML contenant les noms des modules de la bibliothèque.
;<tt>dialog.xlb</tt>: Fichier au format XML contenant les noms des boîtes de dialogue de la bibliothèque.
;<tt>*.xba</tt>: Fichier au format XML stockant le code source {{OOo}} Basic pour un seul module {{OOo}} Basic. Le nom du fichier correspond au nom du module.
;<tt>*.xdl</tt>: Fichier au format XML stockant les éléments d'une boîte de dialogue {{OOo}} Basic. Le nom du fichier correspond au nom de la boîte de dialogue.
;<tt>*.pba</tt>: Module {{OOo}} Basic protégé par un mot de passe ; le code source est donc chiffré. Le nom du fichier correspond au nom du module.

==À propos des fichiers de configuration {{OOo}} Basic==

Les fichiers de configuration <tt>script.xlc</tt> et <tt>dialog.xlc</tt> contiennent la liste des emplacements des bibliothèques et boîtes de dialogue
{{OOo}} Basic. Ces fichiers se trouvent dans le répertoire <tt>''install-dir''/user/basic/</tt>, qui contient également la bibliothèque
{{OOo}} Basic standard par défaut, ainsi que les bibliothèques définies par l'utilisateur.

{{Documentation/Caution|
Vous ne pouvez pas modifier l'emplacement des fichiers de configuration <tt>script.xlc</tt> et <tt>dialog.xlc</tt>.
}}

Le fichier <tt>script.xlc</tt> au format XML contient la liste de toutes les bibliothèques Basic
disponibles dans {{OOo}}. Les balises suivantes sont utilisées :

;<tt>library<nowiki>:</nowiki>name</tt>: Spécifie le nom de la bibliothèque {{OOo}} Basic.
;<tt>xlink<nowiki>:</nowiki>href</tt>: Spécifie l'URL du fichier <tt>script.xlb</tt> pour la bibliothèque. Cet URL doit commencer par la notation <tt>file:///</tt>.
{{Documentation/Note|Vous n'avez pas besoin de spécifier de valeur pour la balise <tt>xlink:href</tt> si la bibliothèque se trouve dans le répertoire <tt> <{{OOo}} installation directory>/user/basic</tt> de l'installation utilisateur.}}
;<tt>xlink<nowiki>:</nowiki>type</tt>: Balise requise par la balise <tt>xlink:href</tt> et devant être définie sur <tt>simple</tt>.
;<tt>library<nowiki>:</nowiki>link</tt>: Spécifie que l'entrée est un lien vers une bibliothèque qui ne se trouve pas à l'emplacement par défaut des bibliothèques. Pour les bibliothèques {{OOo}} Basic, cet emplacement est <tt>''install-dir''/user/basic</tt>. Si vous utilisez uniquement l'emplacement par défaut des bibliothèques, définissez la valeur de cette balise sur <tt>false</tt>. Si ce n'est pas le cas, définissez la valeur de la balise sur <tt>true</tt>.
;<tt>library<nowiki>:</nowiki>readonly</tt>: Spécifie si une bibliothèque est accessible en lecture seule. Définissez la valeur de cette balise sur <tt>true</tt> pour restreindre l'accès en lecture seule.

Le code XML suivant est celui d'un fichier de configuration <tt>script.xlc</tt> pour des bibliothèques
{{OOo}} Basic. La seule différence entre ce fichier et un fichier <tt>dialog.xlc</tt>
réside dans le fait que la balise <tt>xlink:href</tt> pointe vers le fichier <tt>script.xlb</tt>
d'une bibliothèque au lieu du fichier <tt>dialog.xlb</tt>.

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE library:libraries PUBLIC
"-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "libraries.dtd">

<library:libraries
xmlns:library="http://openoffice.org/2000/library"
xmlns:xlink="http://www.w3.org/1999/xlink">

<library:library library:name="Standard"
xlink:href="file:///.../user/basic/Standard/script.xlb/"
xlink:type="simple" library:link="false"/>

<library:library library:name="FormWizard"
xlink:href="file:///.../share/basic/FormWizard/script.xlb/"
xlink:type="simple" library:link="true" library:readonly="false"/>
</library:libraries>
</source>
''Exemple de fichier de configuration {{OOo}} Basic''

==Distribution de bibliothèques {{OOo}} Basic==

Vous pouvez rendre les bibliothèques {{OOo}} Basic personnalisées accessibles aux installations d'{{OOo}} existantes ou uniquement aux nouvelles installations.

{{Documentation/Note| Les fichiers de configuration <tt>script.xlc</tt> et <tt>dialog.xlc</tt> sont placés dans les répertoires suivants :
* Plates-formes Solaris et Linux : <tt>''install-dir''/usr/basic/</tt>
* Windows : <tt>C:\Documents and Settings\''user-id''\Application Data\''install-dir''\user\basic\</tt>}}

===Rendre une bibliothèque {{OOo}} Basic personnalisée accessible à tous les utilisateurs d'un réseau===

Utilisez {{OOo}} pour créer une bibliothèque personnalisée, ainsi que les macros de la bibliothèque.

<ol class="task">
<li>
En tant qu'utilisateur root, copiez la bibliothèque personnalisée, à partir de l'installation utilisateur où vous l'avez créée, dans l'installation serveur d'{{OOo}}. 
<tt>cp -r ''install-dir''/user/basic/custom library ''install-dir''/share/basic/</tt>
{{Documentation/Note|Sous Windows, l'emplacement d'une bibliothèque personnalisée est <tt>C:\Documents and Settings\''user-id''\Application Data\''installation-dir''\user\basic\custom library</tt>}}
</li>
<li>
Dans le fichier de configuration <tt>script.xlc</tt> pour l'installation utilisateur, ajoutez un lien au fichier de configuration <tt>script.xlb</tt> pour la bibliothèque. 

Pour ce lien, utilisez la syntaxe suivante :

<source lang="xml">
<library:library library:name="Library Name"
xlink:href="$(USER)/basic/Library Name/script.xlb/"
xlink:type="simple" library:link="true" library:readonly="false"/>
</source>
</li>
<li>
Dans le fichier de configuration <tt>dialog.xlc</tt> pour l'installation utilisateur, ajoutez un lien au fichier de configuration <tt>script.xlb</tt> pour la bibliothèque. 

Pour ce lien, utilisez la syntaxe suivante :

<source lang="xml">
<library:library library:name="Library Name"
xlink:href="$(USER)/basic/Library Name/dialog.xlb/"
xlink:type="simple" library:link="false"/>
</source>
</li>
<li>
Redémarrez {{OOo}} sur les stations de travail.
</li>
</ol>

===Rendre une bibliothèque {{OOo}} Basic personnalisée accessible à un seul utilisateur===

<ol class="task">
<li>
Copiez la bibliothèque personnalisée, à partir de l'installation utilisateur où vous l'avez créée, dans l'installation utilisateur où vous souhaitez déployer la bibliothèque.

* Sur les plates-formes Solaris et Linux, connectez-vous en tant qu'utilisateur root, puis copiez la bibliothèque.
<source lang="text">cp -r ''install-dir''/user/basic/custom library ''install-dir''/user/basic/</source>
* Sous Windows, connectez-vous en tant qu'utilisateur doté de privilèges d'administrateur, puis copiez la bibliothèque. 
Le chemin d'accès au nom de fichier pour la bibliothèque est <tt>C:\Documents and Settings\''user-id''\Application Data\''install-dir''\user\basic\custom library</tt>
</li>
<li>
Dans le fichier de configuration <tt>script.xlc</tt> pour l'installation utilisateur, ajoutez un lien au fichier de configuration <tt>script.xlb</tt> pour la bibliothèque. 

Pour ce lien, utilisez la syntaxe suivante :
<source lang="xml">
<library:library library:name="Library Name"
xlink:href="$(USER)/basic/Library Name/script.xlb/"
xlink:type="simple" library:link="true" library:readonly="false"/>
</source>
</li>
<li>
Dans le fichier de configuration <tt>dialog.xlc</tt> pour l'installation utilisateur, ajoutez un lien au fichier de configuration <tt>script.xlb</tt> pour la bibliothèque. 

Pour ce lien, utilisez la syntaxe suivante :
<source lang="xml">
<library:library library:name="Library Name"
xlink:href="$(USER)/basic/Library Name/dialog.xlb/"
xlink:type="simple" library:link="false"/>
</source>
</li>
<li> Redémarrez {{OOo}}.</li>
</ol>

===Installation d'une bibliothèque {{OOo}} Basic personnalisée avec une macro===

Vous pouvez créer une macro qui installe une bibliothèque {{OOo}} Basic à partir d'un document {{OOo}}.

<ol class="task">
<li>
Dans Writer, créez une bibliothèque {{OOo}} Basic personnalisée dans un nouveau document.
</li>
<li>
Enregistrez le document.
</li>
<li>
Créez une macro d'installation.
</li>
<ol class="task" type="a">
<li>Choisissez '''Outils → Macros → Gérer les macros → {{OOo}} Basic'''. La boîte de dialogue Macros '''{{OOo}} Basic''' apparaît.</li>
<li>Dans la liste '''Macro de''', sélectionnez votre document Writer.</li>
<li>Dans la zone '''Nom de la macro''', saisissez le nom de la macro d'installation.</li>
<li>Cliquez sur le bouton '''Nouveau'''. La fenêtre EDI '''BASIC''' apparaît.</li>
<li>Saisissez le code suivant :</li>

<source lang="oobas">
Sub AddBasicLibrary
Dim SourceLibraryName As String, DestLibraryName As String
Dim oSrcLib As Object, oDestLib As Object, iCounter As Integer
Dim oLib As Object, oGlobalLib As Object

' paramétrez ces 2 variable au nom de votre bibliothèque
SrcLibraryName = "TextLib"
' Le nom de la bibliothèque qui contient les modules
DestLibraryName = "NewLib"
' Cette bibliothèque sera créée et est la
' destination des modules à partir du document source.

oLib = BasicLibraries ' Pour les bibliothèques Basic
oGlobalLib = GlobalScope.BasicLibraries
For iLib = 1 To 2
If oGlobalLib.hasByName( DestLibraryName ) = False Then
oGlobalLib.createLibrary( DestLibraryName )
End If
If oLib.hasByName( SrcLibraryName ) Then
oLib.loadLibrary( SrcLibraryName )
oSrcLib = oLib.getByName( SrcLibraryName )
sSrcModules = oSrcLib.getElementNames()
iCounter = lBound( sSrcModules() )

while( iCounter <= uBound( sSrcModules() ) )
oDestLib = oGlobalLib.getByName(DestLibraryName)
If oDestLib.hasByName( sSrcModules(iCounter) ) = False Then
oDestLib.insertByName( sSrcModules(iCounter),_
oSrcLib.getByName( sSrcModules(iCounter) ) )
End If
iCounter = iCounter + 1
wend
End If

oLib = DialogLibraries ' Même chose pour les bibliothèques de dialogue
oGlobalLib = GlobalScope.DialogLibraries
Next iLib
End Sub
</source>

<li>Remplacez les variables <tt>SrcLibraryName</tt> et <tt>DestLibraryName</tt> par le nom de votre bibliothèque.</li>
<li>Fermez la fenêtre EDI '''BASIC'''.</li>
</ol>

<li>Ajoutez un bouton au document.</li>
<ol class="task" type="a">
<li>Dans la barre d'outils '''''''''Contrôles de formulaire''', cliquez sur l'icône '''Bouton'''.</li>
<li>Dans le document, faites glisser le curseur pour dessiner le bouton.</li>
</ol>

<li>Affectez la macro d'installation au bouton.</li>
<ol class="task" type="a">
<li>Cliquez avec le bouton droit de la souris sur le nouveau bouton et choisissez '''Contrôle'''.</li>
<li>Cliquez sur l'onglet '''Événements'''.</li>
<li>Cliquez sur les points de suspension '''...''' en regard d'un événement, par exemple, l'événement '''Bouton de souris enfoncé'''.</li>
<li>Dans la boîte de dialogue '''Assigner une action''', cliquez sur le bouton '''Macro'''. La boîte de dialogue '''Sélecteur de macro''' apparaît.</li>
<li>Dans la liste '''Bibliothèque''', sélectionnez la bibliothèque contenant la macro d'installation.</li>
<li>Dans la liste '''Nom de la macro''', sélectionnez la macro d'installation.</li>
<li>Cliquez sur '''OK'''.</li>
<li>Dans la boîte de dialogue '''Assigner une action''', cliquez sur '''OK'''.</li>
</ol>
<li>Enregistrez le document.</li>
</ol>

{{PDL1}}
{{InterWiki_Languages_AdminGuide|articletitle=Documentation/Administration Guide/Using Custom Macros and Libraries}}

HU/Documentation/BASIC Guide/Formatting Spreadsheet Documents

2009-05-22T08:58:25Z

Timarandras:

{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Cells and Ranges
|NextPage=HU/Documentation/BASIC Guide/Editing Spreadsheet Documents
|spread=block
}}
{{DISPLAYTITLE:Munkafüzet-dokumentumok formázása}}
__NOTOC__
A munkafüzet-dokumentum tulajdonságokat és metódusokat biztosít a cellák és oldalak formázásához.

== Cellatulajdonságok ==

Számos tulajdonság áll rendelkezésre a cellák formázásához, például a betűtípus vagy a szöveg méretének megadásához. Minden cella támogatja a <idl>com.sun.star.style.CharacterProperties</idl> és a <idl>com.sun.star.style.ParagraphProperties</idl> szolgáltatást, amelyeknek a főbb tulajdonságainak leírása a [[HU/Documentation/BASIC Guide/Text Documents|Szöveges dokumentumok]]fejezetben található. A speciális cellaformázást a <idl>com.sun.star.table.CellProperties</idl> szolgáltatás végzi. Ennek a szolgáltatásnak a főbb tulajdonságait a következő részek írják le.

A fent említett tulajdonságokat alkalmazhatjuk az egyes cellákra és cellatartományokra.

{{Documentation/Note|A <tt>CellProperties</tt> objektum az {{OOo}} API-ban kompatibilis a VBA <tt>Interior</tt> objektumával, amely szintén meghatározza a cellaspecifikus tulajdonságokat.}}

== Háttérszín és árnyékok ==

A <idl>com.sun.star.table.CellProperties</idl> szolgáltatás a következő tulajdonságokat biztosítja a háttérszínek és árnyékok meghatározásához:

;<tt>CellBackColor (hosszú egész szám)</tt>:a táblázatcella háttérszíne.
;<tt>IsCellBackgroundTransparent (logikai érték)</tt>:átlátszóvá teszi a háttérszínt.
;<tt>ShadowFormat (struktúra)</tt>:megadja a cella árnyéka (struktúra a <idl>com.sun.star.table.ShadowFormat</idl> tulajdonságnak megfelelően).

A <idl>com.sun.star.table.ShadowFormat</idl> struktúrának és a cellaárnyék részletes specifikációjának a következő a struktúrája:

;<tt>Location (enumeráció)</tt>:az árnyékpozíciója (<idl>com.sun.star.table.ShadowLocation</idl> struktúra).
;<tt>ShadowWidth (rövid egész)</tt>:az árnyék mérete századmilliméterben.
;<tt>IsTransparent (logikai érték)</tt>:átlátszó árnyék.
;<tt>Color (hosszú egész)</tt>:árnyék színe.

A következő példa az 1000 számot beírja a B2 cellába, módosítja a háttérszínét pirosra a <tt>CellBackColor</tt> tulajdonsággal, és létrehoz egy világosszürke árnyékot 1 milliméterre balra és lent.

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object
Dim Cell As Object
Dim ShadowFormat As New com.sun.star.table.ShadowFormat

Doc = ThisComponent
Sheet = Doc.Sheets(0)
Cell = Sheet.getCellByPosition(1,1)

Cell.Value = 1000

Cell.CellBackColor = RGB(255, 0, 0)

ShadowFormat.Location = com.sun.star.table.ShadowLocation.BOTTOM_RIGHT
ShadowFormat.ShadowWidth = 100
ShadowFormat.Color = RGB(160, 160, 160)

Cell.ShadowFormat = ShadowFormat
</source>

== Igazítás ==

Az {{OOo}} különböző funkciókat biztosít a táblázatcella szövegének igazításához.

A következő tulajdonságok meghatározzák a szöveg vízszintes és függőleges igazítását:

;<tt>HoriJustify (enumeráció)</tt>:szöveg vízszintes igazítása (érték a <idl>com.sun.star.table.CellHoriJustify</idl> enumerációból)
;<tt>VertJustify (enumeráció)</tt>:szöveg függőleges igazítása (érték a <idl>com.sun.star.table.CellVertJustify</idl> enumerációból)
;<tt>Orientation (enumeráció)</tt>:a szöveg tájolása (a <idl>com.sun.star.table.CellOrientation</idl> enumerációnak megfelelően).
;<tt>IsTextWrapped (logikai érték)</tt>:automatikus sortörések engedélyezése a cellán belül.
;<tt>RotateAngle (hosszú egész szám)</tt>:a szöveg forgatása századfokban.

A következő példa bemutatja, hogyan „halmozható” egymásra a cella tartalma úgy, hogy az egyes karakterek egymásra lesznek nyomtatva, a cella bal felső sarkában. A karakterek nincsenek elforgatva.

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object
Dim Cell As Object

Doc = ThisComponent
Sheet = Doc.Sheets(0)
Cell = Sheet.getCellByPosition(1,1)

Cell.Value = 1000

Cell.HoriJustify = com.sun.star.table.CellHoriJustify.LEFT
Cell.VertJustify = com.sun.star.table.CellVertJustify.TOP
Cell.Orientation = com.sun.star.table.CellOrientation.STACKED
</source>

== Számok, dátumok és szöveg formázása ==

Az {{OOo}} számos előre definiált dátum- és időformátumot biztosít. Ezek mindegyike rendelkezik egy belső számmal, amelyet a <tt>NumberFormat</tt> tulajdonság használ cellák formázásához. Az {{OOo}} a <tt>queryKey</tt> és a <tt>addNew</tt> metódust biztosítja a meglévő számformátumokhoz való hozzáféréshez és új számformátumok létrehozásához. A metódusokat a következő objektumhíváson keresztül lehet elérni:

<source lang="oobas">
NumberFormats = Doc.NumberFormats
</source>

A formátumot egy formátum-karakterlánc határozza meg, amelynek struktúrája hasonló az {{OOo}} Basic formázási funkciójának struktúrájához. Viszont van egy különbség: míg a parancsformátum angol rövidítéseket és tizedespontot, illetve karaktereket vár ezreselválasztóként, addig a <tt>NumberFormats</tt> objektum struktúrájában a területi beállításoknak megfelelő parancsformátumot kell megadni.

A következő példa úgy formázza a B2 cellát, hogy a számok három tizedesjeggyel jelennek meg, és a vesszőt használják ezreselválasztóként.

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object
Dim Cell As Object
Dim NumberFormats As Object
Dim NumberFormatString As String
Dim NumberFormatId As Long
Dim LocalSettings As New com.sun.star.lang.Locale

Doc = ThisComponent
Sheet = Doc.Sheets(0)
Cell = Sheet.getCellByPosition(1,1)

Cell.Value = 23400.3523565

LocalSettings.Language = "en"
LocalSettings.Country = "us"

NumberFormats = Doc.NumberFormats
NumberFormatString = "#,##0.000"

NumberFormatId = NumberFormats.queryKey(NumberFormatString, LocalSettings, True)
If NumberFormatId = -1 Then
NumberFormatId = NumberFormats.addNew(NumberFormatString, LocalSettings)
End If

MsgBox NumberFormatId
Cell.NumberFormat = NumberFormatId
</source>

Az {{OOo}} Calc '''Cellák formázása''' párbeszédablaka áttekintés nyújt a cellák különböző formázási lehetőségeiről.

== Oldaltulajdonságok ==

Az oldaltulajdonságok olyan formázási lehetőségek, amelyek meghatározzák a dokumentum tartalmának, valamint az oldalról oldalra ismétlő vizuális elemeknek az elhelyezkedését. Ezek közé tartoznak a következők:

* Papírformátumok
* Oldalmargók
* Élőfejek és élőlábak

Az oldalformátumok definiálása eltér a más típusú formázásoktól. Míg a cellák, bekezdések és karakterek közvetlenül formázhatók, addig az oldalformátumok közvetetten is formázhatók oldalstílusok használatával. Például élőfejek és élőlábak adhatók az oldalstílushoz.

A következő részek leírják a munkalap-oldalak főbb formázási lehetőségeit. A bemutatott stílusok közül több is elérhető a szöveges dokumentumoknál. A mindkét dokumentumtípusnál használható oldaltulajdonságok a <idl>com.sun.star.style.PageProperties</idl> szolgáltatásban vannak definiálva. A csak a munkafüzet-dokumentumoknál használható tulajdonságok a <idl>com.sun.star.sheet.TablePageStyle</idl> szolgáltatásban vannak definiálva.

{{Documentation/Note|A Microsoft Office-dokumentumok oldaltulajdonságait (oldalmargó, -keret stb.) a <tt>Worksheet</tt> objektum (Excel) vagy a <tt>Document</tt> objektum (Word) <tt>PageSetup</tt> objektuma definiálja. Az {{OOo}} programban ezeket a tulajdonságokat az oldalstílus definiálja, amely viszont a hozzá tartozó dokumentumhoz van csatolva.}}

== Oldalháttér ==

A <idl>com.sun.star.style.PageProperties</idl> szolgáltatás a következő tulajdonságokat definiálja az oldalháttér számára:

;<tt>BackColor (hosszú egész)</tt>:háttér színe.
;<tt>BackGraphicURL (karakterlánc)</tt>:a használni kívánt háttérkép URL-je.
;<tt>BackGraphicFilter (karakterlánc)</tt>:a háttérképet értelmező szűrő neve.
;<tt>BackGraphicLocation (enumeráció)</tt>:a háttérkép pozíciója (az enumerációnak megfelelően).
;<tt>BackTransparent (logikai érték)</tt>:átlátszó háttérkép.

== Oldalformátum ==

Az oldalformátumot a <idl>com.sun.star.style.PageProperties</idl> szolgáltatás tulajdonságai határozzák meg:

;<tt>IsLandscape (logikai érték)</tt>:fekvő formátum.
;<tt>Width (hosszú egész)</tt>:az oldal szélessége századmilliméterben.
;<tt>Height (hosszú egész)</tt>:az oldal magassága századmilliméterben.
;<tt>PrinterPaperTray (karakterlánc)</tt>:használni kívánt nyomtatótálca neve.

A következő példa a "Default" oldalstílus méretét a DIN A5 fekvő formátumra (magasság: 14,8 cm, szélesség: 21 cm) állítja:

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object
Dim StyleFamilies As Object
Dim PageStyles As Object
Dim DefPage As Object

Doc = ThisComponent
StyleFamilies = Doc.StyleFamilies
PageStyles = StyleFamilies.getByName("PageStyles")
DefPage = PageStyles.getByName("Default")

DefPage.IsLandscape = True
DefPage.Width = 21000
DefPage.Height = 14800
</source>

== Oldalmargó, -keret és -árnyék ==

A <idl>com.sun.star.style.PageProperties</idl> szolgáltatás a következő tulajdonságokat biztosítja az oldalmargók, -keretek és -árnyékok beállításához:

;<tt>LeftMargin (hosszú egész)</tt>:a bal margó szélessége századmilliméterben.
;<tt>RightMargin (hosszú egész)</tt>:a jobb margó szélessége századmilliméterben.
;<tt>TopMargin (hosszú egész)</tt>:a felső margó szélessége századmilliméterben.
;<tt>BottomMargin (hosszú egész)</tt>:az alsó margó szélessége századmilliméterben.
;<tt>LeftBorder (struktúra)</tt>:az oldalkeret bal oldalának specifikációja (<idl>com.sun.star.table.BorderLine</idl> struktúra)
;<tt>RightBorder (struktúra)</tt>:az oldalkeret jobb oldalának specifikációja (<idl>com.sun.star.table.BorderLine</idl> struktúra)
;<tt>TopBorder (struktúra)</tt>:az oldalkeret felső oldalának specifikációja (<idl>com.sun.star.table.BorderLine</idl> struktúra)
;<tt>BottomBorder (struktúra)</tt>:az oldalkeret alsó oldalának specifikációja (<idl>com.sun.star.table.BorderLine</idl> struktúra)
;<tt>LeftBorderDistance (hosszú egész)</tt>:az oldalkeret bal oldala és az oldal tartalma közti távolság századmilliméterben.
;<tt>RightBorderDistance (hosszú egész)</tt>:az oldalkeret jobb oldala és az oldal tartalma közti távolság századmilliméterben.
;<tt>TopBorderDistance (hosszú egész)</tt>:az oldalkeret felső oldala és az oldal tartalma közti távolság századmilliméterben.
;<tt>BottomBorderDistance (hosszú egész)</tt>:az oldalkeret alsó oldala és az oldal tartalma közti távolság századmilliméterben.
;<tt>ShadowFormat (struktúra)</tt>:az oldal tartalomterülete árnyékának specifikációja (<idl>com.sun.star.table.ShadowFormat</idl> struktúra).

A következő példa a "Default" oldalstílus bal és jobb oldali keretét 1 cm-re állítja.

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object
Dim StyleFamilies As Object
Dim PageStyles As Object
Dim DefPage As Object

Doc = ThisComponent
StyleFamilies = Doc.StyleFamilies
PageStyles = StyleFamilies.getByName("PageStyles")
DefPage = PageStyles.getByName("Default")

DefPage.LeftMargin = 1000
DefPage.RightMargin = 1000
</source>

== Élőfejek és élőlábak ==

A dokumentum élőfejei és élőlábai a dokumentumtulajdonságok részei, és a <idl>com.sun.star.style.PageProperties</idl> szolgáltatásban vannak definiálva. Az élőfejek formázási tulajdonságai a következők:

;<tt>HeaderIsOn (logikai érték)</tt>:élőfej aktiválva.
;<tt>HeaderLeftMargin (hosszú egész)</tt>:az élőfej és az oldal bal margója közti távolság századmilliméterben.
;<tt>HeaderRightMargin (hosszú egész)</tt>:az élőfej és az oldal jobb margója közti távolság századmilliméterben.
;<tt>HeaderBodyDistance (hosszú egész)</tt>:az élőfej és a dokumentumtörzs közti távolság századmilliméterben.
;<tt>HeaderHeight (hosszú egész)</tt>:az élőfej magassága századmilliméterben.
;<tt>HeaderIsDynamicHeight (logikai érték)</tt>:az élőfej magassága automatikusan igazodik a tartalmához.
;<tt>HeaderLeftBorder (struktúra)</tt>:az élőfej körüli keret bal szegélye (<idl>com.sun.star.table.BorderLine</idl> struktúra).
;<tt>HeaderRightBorder (struktúra)</tt>:az élőfej körüli keret jobb szegélye (<idl>com.sun.star.table.BorderLine</idl> struktúra).
;<tt>HeaderTopBorder (struktúra)</tt>:az élőfej körüli keret felső szegélye (<idl>com.sun.star.table.BorderLine</idl> struktúra).
;<tt>HeaderBottomBorder (struktúra)</tt>:az élőfej körüli keret alsó szegélye (<idl>com.sun.star.table.BorderLine</idl> struktúra).
;<tt>HeaderLeftBorderDistance (hosszú egész)</tt>:az élőfejkeret bal oldali szegélye és tartalma közti távolság századmilliméterben.
;<tt>HeaderRightBorderDistance (hosszú egész)</tt>:az élőfejkeret jobb oldali szegélye és tartalma közti távolság századmilliméterben.
;<tt>HeaderTopBorderDistance (hosszú egész)</tt>:az élőfejkeret felső szegélye és tartalma közti távolság századmilliméterben.
;<tt>HeaderBottomBorderDistance (hosszú egész)</tt>:az élőfejkeret alsó szegélye és tartalma közti távolság századmilliméterben.
;<tt>HeaderIsShared (logikai érték)</tt>:azonos élőfej a páros és páratlan oldalakon (lásd: <tt>HeaderText</tt>, <tt>HeaderTextLeft</tt> és <tt>HeaderTextRight</tt>).
;<tt>HeaderBackColor (hosszú egész szám)</tt>:az élőfej háttérszíne.
;<tt>HeaderBackGraphicURL (karakterlánc)</tt>:a használni kívánt háttérkép URL-je.
;<tt>HeaderBackGraphicFilter (karakterlánc)</tt>:az élőfej háttérképét értelmező szűrő neve.
;<tt>HeaderBackGraphicLocation (enumeráció)</tt>:az élőfej háttérképének pozíciója (a <idl>com.sun.star.style.GraphicLocation</idl> enumerációnak megfelelően).
;<tt>HeaderBackTransparent (logikai érték)</tt>:az élőfej háttere átlátszó lesz.
;<tt>HeaderShadowFormat (struktúra)</tt>:az élőfej árnyéka (<idl>com.sun.star.table.ShadowFormat</idl> struktúra).

Az élőlábak formázási tulajdonságai a következők:

;<tt>FooterIsOn (logikai érték)</tt>:élőláb aktiválva.
;<tt>FooterLeftMargin (hosszú egész)</tt>:az élőláb és az oldal bal margója közti távolság századmilliméterben.
;<tt>FooterRightMargin (hosszú egész)</tt>:az élőláb és az oldal jobb margója közti távolság századmilliméterben.
;<tt>FooterBodyDistance (hosszú egész)</tt>:a élőláb és a dokumentumtörzs közti távolság századmilliméterben.
;<tt>FooterHeight (hosszú egész)</tt>:az élőláb magassága századmilliméterben.
;<tt>FooterIsDynamicHeight (logikai érték)</tt>:az élőláb magassága automatikusan igazodik a tartalmához.
;<tt>FooterLeftBorder (struktúra)</tt>:az élőláb körüli keret bal szegélye (<idl>com.sun.star.table.BorderLine</idl> struktúra).
;<tt>FooterRightBorder (struktúra)</tt>:az élőláb körüli keret jobb szegélye (<idl>com.sun.star.table.BorderLine</idl> struktúra).
;<tt>FooterTopBorder (struktúra)</tt>:az élőláb körüli keret felső szegélye (<idl>com.sun.star.table.BorderLine</idl> struktúra).
;<tt>FooterBottomBorder (struktúra)</tt>:az élőláb körüli keret alsó szegélye (<idl>com.sun.star.table.BorderLine</idl> struktúra).
;<tt>FooterLeftBorderDistance (hosszú egész)</tt>:az élőlábkeret bal oldali szegélye és tartalma közti távolság századmilliméterben.
;<tt>FooterRightBorderDistance (hosszú egész)</tt>:az élőlábkeret jobb oldali szegélye és tartalma közti távolság századmilliméterben.
;<tt>FooterTopBorderDistance (hosszú egész)</tt>:az élőlábkeret felső szegélye és tartalma közti távolság századmilliméterben.
;<tt>FooterBottomBorderDistance (hosszú egész)</tt>:az élőlábkeret alsó szegélye és tartalma közti távolság századmilliméterben.
;<tt>FooterIsShared (logikai érték)</tt>:azonos élőláb a páros és páratlan oldalakon (lásd: <tt>FooterText</tt>, <tt>FooterTextLeft</tt> és <tt>FooterTextRight</tt>).
;<tt>FooterBackColor (hosszú egész szám)</tt>:az élőláb háttérszíne.
;<tt>FooterBackGraphicURL (karakterlánc)</tt>:a használni kívánt háttérkép URL-je.
;<tt>FooterBackGraphicFilter (karakterlánc)</tt>:az élőláb háttérképét értelmező szűrő neve.
;<tt>FooterBackGraphicLocation (enumeráció)</tt>:az élőláb háttérképének pozíciója (a <idl>com.sun.star.style.GraphicLocation</idl> enumerációnak megfelelően).
;<tt>FooterBackTransparent (logikai érték)</tt>:az élőláb háttere átlátszó lesz.
;<tt>FooterShadowFormat (struktúra)</tt>:az élőláb árnyéka (<idl>com.sun.star.table.ShadowFormat</idl> struktúra).

== Az élőfejek és élőlábak szövegének módosítása ==

A munkalap élőfejeinek és élőlábainak tartalma a következő tulajdonságokkal érhetők el:

;<tt>LeftPageHeaderContent (objektum)</tt>:a páros oldalak élőfejének tartalma (<idl>com.sun.star.sheet.HeaderFooterContent</idl> szolgáltatás).
;<tt>RightPageHeaderContent (objektum)</tt>:a páratlan oldalak élőfejének tartalma (<idl>com.sun.star.sheet.HeaderFooterContent</idl> szolgáltatás).
;<tt>LeftPageFooterContent (objektum)</tt>:a páros oldalak élőlábának tartalma (<idl>com.sun.star.sheet.HeaderFooterContent</idl> szolgáltatás).
;<tt>RightPageFooterContent (objektum)</tt>:a páratlan oldalak élőlábának tartalma (<idl>com.sun.star.sheet.HeaderFooterContent</idl> szolgáltatás).

Ha nincs szükség a páros és páratlan oldalak élőfejének és élőlábának megkülönböztetésére (a <tt>FooterIsShared</tt> tulajdonság értéke <tt>False</tt> (hamis)), akkor a páratlan oldalak élőfejének és élőlábának tulajdonságát állítsuk be.

A fent felsorolt objektumok mindegyike visszaad egy objektumot, amely támogatja a <idl>com.sun.star.sheet.HeaderFooterContent</idl> szolgáltatást. A <tt>LeftText</tt>, a <tt>CenterText</tt> és a <tt>RightText</tt> tulajdonsággal ez a szolgáltatás három szöveges elemet biztosít az {{OOo}} Calc élőfejei és élőlábai számára.

A következő példa a "Csak teszt." értéket írja a "Default" sablon élőfejének bal oldali szövegébe.

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object
Dim StyleFamilies As Object
Dim PageStyles As Object
Dim DefPage As Object
Dim HText As Object
Dim HContent As Object
Doc = ThisComponent
StyleFamilies = Doc.StyleFamilies
PageStyles = StyleFamilies.getByName("PageStyles")
DefPage = PageStyles.getByName("Default")

DefPage.HeaderIsOn = True
HContent = DefPage.RightPageHeaderContent
HText = HContent.LeftText
HText.String = "Csak teszt."
DefPage.RightPageHeaderContent = HContent
</source>

Megjegyzés a program utolsó sorához: Miután a szöveg módosult, a <tt>TextContent</tt> objektumot ismét az élőfejhez kell rendelni, hogy a módosítás érvébe lépjen.

Az élőfejek és élőlábak módosításának másik módja a szöveges dokumentumoknál ({{OOo}} Writer) használható, mert ezek egyetlen szövegblokkból állnak. A <idl>com.sun.star.style.PageProperties</idl> szolgáltatás a következő tulajdonságokkal rendelkezik:

;<tt>HeaderText (objektum)</tt>:az élőfejet tartalmazó szövegobjektum (<idl>com.sun.star.text.XText</idl> szolgáltatás).
;<tt>HeaderTextLeft (objektum)</tt>:a bal oldalak élőfejét tartalmazó szövegobjektum (<idl>com.sun.star.text.XText</idl> szolgáltatás).
;<tt>HeaderTextRight (objektum)</tt>:a jobb oldalak élőfejét tartalmazó szövegobjektum (<idl>com.sun.star.text.XText</idl> szolgáltatás).
;<tt>FooterText (objektum)</tt>:az élőlábat tartalmazó szövegobjektum (<idl>com.sun.star.text.XText</idl> szolgáltatás).
;<tt>FooterTextLeft (objektum)</tt>:a bal oldalak élőlábát tartalmazó szövegobjektum (<idl>com.sun.star.text.XText</idl> szolgáltatás).
;<tt>FooterTextRight (objektum)</tt>:a jobb oldalak élőlábát tartalmazó szövegobjektum (<idl>com.sun.star.text.XText</idl> szolgáltatás).

A következő példa létrehoz egy élőfejet a szöveges dokumentum "Default" sablonjában, és hozzáadja a "Csak teszt." szöveget.

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object
Dim StyleFamilies As Object
Dim PageStyles As Object
Dim DefPage As Object
Dim HText As Object

Doc = ThisComponent
StyleFamilies = Doc.StyleFamilies
PageStyles = StyleFamilies.getByName("PageStyles")
DefPage = PageStyles.getByName("Default")

DefPage.HeaderIsOn = True
HText = DefPage.HeaderText

HText.String = "Csak teszt."
</source>

Ebben a példában a program közvetlenül a <tt>HeaderText</tt> tulajdonsággal fér hozzá az oldalstílus tulajdonságához <tt>HeaderFooterContent</tt> objektum helyett.

== Középre igazítás (csak munkalapok) ==

A <idl>com.sun.star.sheet.TablePageStyle</idl> szolgáltatás szolgáltatás csak az {{OOo}} Calc-oldalstílusokkal használható, és segítségével a kinyomtatni kívánt cellatartományok középre igazíthatók az oldalon. Ez a szolgáltatás következő tulajdonságokat biztosítja:

;<tt>CenterHorizontally (logikai érték)</tt>:a táblázat tartalma vízszintesen középre van igazítva.
;<tt>CenterVertically (logikai érték)</tt>:a táblázat tartalma függőlegesen középre van igazítva.

== A kinyomtatandó elemek meghatározása (csak munkalapok) ==

Munkalapok formázásánál megadhatjuk, hogy az oldalelemek láthatók legyenek-e. Ebből a célból a <idl>com.sun.star.sheet.TablePageStyle</idl> szolgáltatás a következő tulajdonságokat biztosítja:

;<tt>PrintAnnotations (logikai érték)</tt>:cellamegjegyzések nyomtatása.
;<tt>PrintGrid (logikai érték)</tt>:cella rácsvonalainak nyomtatása.
;<tt>PrintHeaders (logikai érték)</tt>:sor- és oszlopfejlécek nyomtatása.
;<tt>PrintCharts (logikai érték)</tt>:a munkalap diagramjainak nyomtatása.
;<tt>PrintObjects (logikai érték)</tt>:beágyazott objektumok nyomtatása.
;<tt>PrintDrawing (logikai érték)</tt>:rajzobjektumok nyomtatása.
;<tt>PrintDownFirst (logikai érték)</tt>:ha a munkalap tartalma több oldalra kiterjed, akkor először lefelé haladó sorrendben lesznek kinyomtatva, majd jobbra.
;<tt>PrintFormulas (logikai érték)</tt>:a képletek kinyomtatása a kiszámított értékek helyett.
;<tt>PrintZeroValues (logikai érték)</tt>:nullák nyomtatása.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Formatting Spreadsheet Documents}}
{{PDL1}}

HU/Documentation/BASIC Guide/Branching

2009-05-22T08:57:45Z

Timarandras:

{{DISPLAYTITLE:Elágazások}}
{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Operators
|NextPage=HU/Documentation/BASIC Guide/Loops
|lang=block
}}

Az elágazási utasításokkal egy kódrészlet végrehajtását egy adott feltételtől tehetjük függővé.

== <tt>If...Then...Else</tt> ==

A legegyszerűbb elágazási utasítás az <tt>If</tt> utasítás, ahogy az a következő példában is látható:

<source lang="oobas">
If A > 3 Then
B = 2
End If
</source>

A <tt>B = 2</tt> értékadás csak akkor történik meg, ha az <tt>A</tt> változó értéke nagyobb háromnál. Az <tt>If</tt> utasítás egyik változata az <tt>If/Else</tt> utasítás:

<source lang="oobas">
If A > 3 Then
B = 2
Else
B = 0
End If
</source>

Ebben a példában <tt>B</tt> értéke akkor lesz 2, ha <tt>A</tt> értéke nagyobb 3-nál, egyébként <tt>B</tt> értéke 0 lesz.

Létrehozhatunk bonyolultabb feltételeket is az <tt>If</tt> utasítások egymásba ágyazásával:

<source lang="oobas">
If A = 0 Then
B = 0
ElseIf A < 3 Then
B = 1
Else
B = 2
End If
</source>

Ha <tt>A</tt> értéke 0, akkor <tt>B</tt> értéke 0 lesz. Ha <tt>A</tt> értéke kisebb háromnál (de nem egyenlő 0-val), akkor <tt>B</tt> értéke 1 lesz. Minden egyéb helyzetben (azaz, ha <tt>A</tt> nagyobb 3-nál vagy egyenlő azzal), <tt>B</tt> értéke 2 lesz.

== <tt>Select...Case</tt> ==

A <tt>Select...Case</tt> utasítás az egymásba ágyazott <tt>If</tt> utasítások alternatívája, és akkor érdemes használni, ha egy változó értékét több feltétellel kell ellenőrizni:

<source lang="oobas">
Select Case Nap
Case 1:
NapNeve = "Vasárnap"
Case 2:
NapNeve = "Hétfő"
Case 3:
NapNeve = "Kedd"
Case 4:
NapNeve = "Szerda"
Case 5:
NapNeve = "Csütörtök"
Case 6:
NapNeve = "Péntek"
Case 7:
NapNeve = "Szombat"
End Select
</source>

Ebben a példában a hét napját egy szám jelöli, így a <tt>NapNeve</tt> változó értéke <tt>Vasárnap</tt> lesz, ha a változó 1, <tt>Hétfő</tt>, ha 2 stb.

A <tt>Select</tt> parancs nem csak az 1:1 értékadásoknál használható – a <tt>Case</tt> feltételben megadhatunk összehasonlító operátorokat vagy kifejezéslistákat is. A következő példa bemutatja a legfontosabb változatokat:

<source lang="oobas">
Select Case Valtozo
Case 1 To 5
' ... A Valtozo értéke 1 és 5 között lehet (beleértve az 1 és 5 értékeket is).
Case > 100
' ... A Valtozo nagyobb, mint 100.
Case 6, 7, 8
' ... A Valtozo értéke 6, 7 vagy 8.
Case 6, 7, 8, > 15, < 0
' ... A Valtozo értéke 6, 7, 8, nagyobb, mint 15 vagy kisebb, mint 0.
Case Else
' ... Minden más eset
End Select
</source>

Nézzünk meg egy félrevezető (bonyolult) példát, ami egy gyakran elkövetett hibát mutat be:

<source lang="oobas">
Select Case Valtozo
Case Valtozo = 8
' ... A Valtozo értéke 0.
Case Else
' ... Minden más eset
End Select
</source>

A (Valtozo = 8) kifejezés TRUE (Igaz) lesz, ha a Valtozo értéke 8, különben FALSE (Hamis). A TRUE értéke -1, a FALSE értéke 0. A Select Case utasítás kiértékeli a kifejezést, amely TRUE vagy FALSE lesz, majd ezt az értéket hasonlítja össze a Valtozo értékével. Ha a Valtozo értéke 0, akkor a feltétel teljesül. Ha megértettünk az előbbi példát, akkor azt is érteni fogjuk, hogy ez a példaprogram miért nem azt csinálja, amit ránézésre várnánk tőle:

<source lang="oobas">
Select Case Valtozo
Case Valtozo > 8 And Valtozo < 11
' ... A Valtozo értéke 0.
Case Else
' ... Minden más eset
End Select
</source>

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Branching}}
{{PDL1}}

HU/Documentation/BASIC Guide/Structure of Spreadsheets

2009-05-22T08:55:40Z

Timarandras: /* Munkalapok létrehozása, törlése és átnevezése */

{{DISPLAYTITLE:A munkafüzet-dokumentumok felépítése}}
{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Spreadsheets
|NextPage=HU/Documentation/BASIC Guide/Rows and Columns
|spread=block
}}

A munkafüzet dokumentumobjektuma a <idl>com.sun.star.sheet.SpreadsheetDocument</idl> szolgáltatáson alapul. A dokumentumok mindegyike több munkafüzetet is tartalmazhat. Ebben az útmutatóban a táblázat alapú dokumentum vagy munkafüzet-dokumentum a teljes dokumentum, míg a munkalap egy lapja (táblázata) a dokumentumnak.

{{Documentation/Note|A VBA és az {{OOo}} Basic eltérő neveket használ az egyes objektumok megnevezésére. Míg a dokumentumobjektum neve VBA-ban Workbook és az egyes lapjai a Worksheet objektumok, addig az {{OOo}} Basicben SpreadsheetDocument objektumnak és Sheet objektumnak hívják ugyanazt.}}

== Munkafüzetek ==

A munkafüzet-dokumentum egyes munkalapjait a <tt>Sheets</tt> listával érhetjük el.

Az alábbi példa bemutatja, hogyan érhető el egy munkalap a száma vagy neve alapján.

'''1. példa: hozzáférés szám alapján (a számozás 0-nál kezdődik)'''

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object

Doc = ThisComponent
Sheet = Doc.Sheets(0)
</source>

{{Documentation/Note|A <tt>ThisComponent</tt> az utoljára aktív dokumentumot adja vissza.}}

'''2. példa: hozzáférés név alapján'''

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object

Doc = ThisComponent
Sheet = Doc.Sheets.getByName("Sheet 1")
</source>

Az első példában a munkalapot a száma alapján éri el a program (a számozás 0-nál kezdődik). A második példában pedig a neve alapján, a <tt>getByName</tt> metódus használatával.

A <tt>getByName</tt> metódus által visszaadott <tt>Sheet</tt> objektum a <idl>com.sun.star.sheet.Spreadsheet</idl> szolgáltatást támogatja. A tartalom szerkesztéséhez használt számos felületen kívül ez a szolgáltatás a következő tulajdonságokat biztosítja:

;<tt>IsVisible (logikai érték)</tt>:a munkafüzet látható.
;<tt>PageStyle (karakterlánc)</tt>:a munkafüzet oldalsablonjának neve.

=== Munkalapok létrehozása, törlése és átnevezése ===

A <tt>munkafüzet-objektum</tt> <tt>Sheets</tt> listája szintén használható az egyes munkalapok létrehozásához, törléséhez és átnevezéséhez. A következő példa a <tt>hasByName</tt> metódussal ellenőrzi, hogy létezik-e egy '''SajátMunkalap''' nevű munkalap. Ha létezik, a metódus létrehozza a megfelelő objektumhivatkozást a <tt>getByName</tt> metódus használatával, és menti a hivatkozást a <tt>Sheet</tt> nevű változóba. Ha az adott munkalap nem létezik, a <tt>createInstance</tt> metódus létrehozza azt, és az <tt>insertByName</tt> beszúrja a munkafüzet-objektumba.

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object

Doc = ThisComponent
Sheet = Doc.Sheets(0)

If Doc.Sheets.hasByName("SajátMunkalap") Then
Sheet = Doc.Sheets.getByName("SajátMunkalap")
Else
Sheet = Doc.createInstance("com.sun.star.sheet.Spreadsheet")
Doc.Sheets.insertByName("SajátMunkalap", Sheet)
End If
</source>

A <tt>getByName</tt> és az <tt>insertByName</tt> metódust a <idl>com.sun.star.container.XnameContainer</idl> felület tartalmazza. Ezek leírását [[HU/Documentation/BASIC Guide/API Intro|A StarOffice API bemutatása]] fejezetben találjuk.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Structure of Spreadsheets}}
{{PDL1}}

Documentation/BASIC Guide/StarDesktop

2009-05-22T08:51:43Z

Timarandras: /* Creating, Opening and Importing Documents */ text.odt -> test.odt

{{Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=Documentation/BASIC Guide/Documents
|NextPage=Documentation/BASIC Guide/Templates
|docs=block
}}
{{DISPLAYTITLE:The StarDesktop}}
__NOTOC__
When working with documents, two services are used most frequently:

* The <idl>com.sun.star.frame.Desktop</idl> service, which is similar to the core service of {{OOo}}. It provides the functions for the frame object of {{OOo}}, under which all document windows are classified. Documents can also be created, opened and imported using this service.
* The basic functionality for the individual document objects is provided by the <idl>com.sun.star.document.OfficeDocument</idl> service. This provides the methods for saving, exporting and printing documents.

The <idl>com.sun.star.frame.Desktop</idl> service is created automatically when {{OOo}} is started. This service can be addressed in {{OOo}} Basic using the global name <tt>StarDesktop</tt>.

The most important interface of the <tt>StarDesktop</tt> is <idl>com.sun.star.frame.XComponentLoader</idl>. This basically covers the <tt>loadComponentFromURL</tt> method, which is responsible for creating, importing, and opening documents.

The name of the <tt>StarDesktop</tt> object dates back to StarOffice 5, in which all document windows were embedded in one common application called <tt>StarDesktop</tt>. In the present version of {{OOo}}, a visible <tt>StarDesktop</tt> is no longer used. The name <tt>StarDesktop</tt> was, however, retained for the frame object of {{OOo}} because it clearly indicates that this is a basic object for the entire application.

The <tt>StarDesktop</tt> object replaces the <tt>Application</tt> object of StarOffice 5 which previously applied as a root object. However, unlike the old <tt>Application</tt> object, <tt>StarDesktop</tt> is primarily responsible for opening new documents. The functions resident in the old <tt>Application</tt> object for controlling the on-screen depiction of {{OOo}} (for example, <tt>FullScreen</tt>, <tt>FunctionBarVisible</tt>, <tt>Height</tt>, <tt>Width</tt>, <tt>Top</tt>, <tt>Visible</tt>) are no longer used.

{{Documentation/Note|Whereas the active document in Word is accessed through <tt>Application.ActiveDocument</tt> and in Excel through <tt>Application.ActiveWorkbook,</tt> in {{OOo}}, the <tt>StarDesktop</tt> is responsible for this task. The active document object is accessed in {{OOo}} through the <tt>StarDesktop.CurrentComponent</tt> property, or through <tt>ThisComponent</tt>.}}

== ThisComponent ==
The global name <tt>ThisComponent</tt> generally returns the same object as <tt>StarDesktop.CurrentComponent</tt>, with one significant advantage. If you are running from within the Basic IDE, debugging or exploring, then <tt>StarDesktop</tt> returns the Basic IDE itself. This is probably not what you want. <tt>ThisComponent</tt> returns the last previously active document.

== Basic Information about Documents in {{OOo}} ==

When working with {{OOo}} documents, it is useful to deal with some of the basic issues of document administration in {{OOo}}. This includes the way in which file names are structured for {{OOo}} documents, as well as the format in which files are saved.

=== File Names in URL Notation ===

Since {{OOo}} is a platform-independent application, it uses URL notation (which is independent of any operating system), as defined in the Internet Standard RFC 1738 for file names. Standard file names using this system begin with the prefix <tt>file:///</tt> followed by the local path. If the file name contains sub-directories, then these are separated by a single forward slash, not with a backslash usually used under Windows. The following path references the <tt>test.odt</tt> file in the doc directory on the C: drive.

file:///C:/doc/test.odt

To convert local file names into an URL, {{OOo}} provides the <tt>ConvertToUrl</tt> function. To convert a URL into a local file name, {{OOo}} provides the <tt>ConvertFromUrl</tt> function:

<source lang="oobas">
MsgBox ConvertToUrl("C:\doc\test.odt")
' supplies file:///C:/doc/test.odt
MsgBox ConvertFromUrl("file:///C:/doc/test.odt")
' supplies (under Windows) c:\doc\test.odt
</source>

The example converts a local file name into a URL and displays it in a message box. It then converts a URL into a local file name and also displays this.

The Internet Standard RFC 1738, upon which this is based, permits use of the <tt>0-9</tt>, <tt>a-z</tt>, and <tt>A-Z</tt> characters. All other characters are inserted as escape coding in the URLs. To do this, they are converted into their hexadecimal value in the UTF-8 set of characters and are preceded by a percent sign. A space in a local file name therefore, for example, becomes a <tt>%20</tt> in the URL.

=== XML File Format ===

{{OOo}} documents are based on the XML file format. XML-based files can be opened and edited with other programs.

=== Compression of Files ===

Since XML is based on standard text files, the resultant files are usually very large. {{OOo}} therefore compresses the files and saves them as a ZIP file. By means of a <tt>storeAsURL</tt> method option, the user can save the original XML files directly. See [[Documentation/BASIC Guide/StarDesktop#storeAsURL Method Options|storeAsURL Method Options]], below.

== Creating, Opening and Importing Documents ==

Documents are opened, imported and created using the method

<source lang="oobas">
StarDesktop.loadComponentFromURL(URL, Frame, SearchFlags, FileProperties)
</source>

The first parameter of <tt>loadComponentFromURL</tt> specifies the URL of the associated file.

As the second parameter, <tt>loadComponentFromURL</tt> expects a name for the frame object of the window that {{OOo}} creates internally for its administration. The predefined <tt>_blank</tt> name is usually specified here, and this ensures that {{OOo}} creates a new window. Alternatively, <tt>_hidden</tt> can also be specified, and this ensures that the corresponding document is loaded but remains invisible.

Using these parameters, the user can open a {{OOo}} document, since place holders (dummy values) can be assigned to the last two parameters:

<source lang="oobas">
Dim Doc As Object
Dim Url As String
Dim Dummy() 'An (empty) array of PropertyValues

Url = "file:///C:/test.odt"

Doc = StarDesktop.loadComponentFromURL(Url, "_blank", 0, Dummy)
</source>

The preceding call opens the <tt>test.odt</tt> file and displays this in a new window.

Any number of documents can be opened in this way in {{OOo}} Basic and then edited using the returned document objects.

{{Documentation/Note|<tt>StarDesktop.loadComponentFromURL</tt> supersedes the <tt>Documents.Add</tt> and <tt>Documents.Open</tt> methods from the old {{OOo}} API.}}

=== Replacing the Content of the Document Window ===

The named <tt>_blank</tt> and <tt>_hidden</tt> values for the <tt>Frame</tt> parameter ensure that {{OOo}} creates a new window for every call from <tt>loadComponentFromURL</tt>. In some situations, it is useful to replace the content of an existing window. In this case, the frame object of the window should contain an explicit name. Note that this name must not begin with an underscore. Furthermore, the <tt>SearchFlags</tt> parameter must be set so that the corresponding framework is created, if it does not already exist. The corresponding constant for <tt>SearchFlags</tt> is:

<source lang="oobas">
SearchFlags = com.sun.star.frame.FrameSearchFlag.CREATE + _
com.sun.star.frame.FrameSearchFlag.ALL
</source>

The following example shows how the content of an opened window can be replaced with the help of the frame parameter and <tt>SearchFlags</tt>:

<source lang="oobas">
Dim Doc As Object
Dim Dummy()
Dim Url As String
Dim SearchFlags As Long

SearchFlags = com.sun.star.frame.FrameSearchFlag.CREATE + _
com.sun.star.frame.FrameSearchFlag.ALL
Url = "file:///C:/test.odt"
Doc = StarDesktop.loadComponentFromURL(Url, "MyFrame", SearchFlags, Dummy)
MsgBox "Press OK to display the second document."

Url = "file:///C:/test2.odt"
Doc = StarDesktop.loadComponentFromURL(Url, "MyFrame", _
SearchFlags, Dummy)
</source>

The example first opens the <tt>test.odt</tt> file in a new window with the frame name of <tt>MyFrame</tt>. Once the message box has been confirmed, it replaces the content of the window with the <tt>test2.odt</tt> file.

=== loadComponentFromURL Method Options ===

The fourth parameter of the <tt>loadComponentFromURL</tt> function is a <tt>PropertyValue</tt> data field. which provides {{OOo}} with various options for opening and creating documents. The data field must provide a <tt>PropertyValue</tt> structure for each option in which the name of the option is saved as a string as well as the associated value.

<tt>loadComponentFromURL</tt> supports the following options:

;<tt>AsTemplate (Boolean)</tt>:if true, loads a new, untitled document from the given URL. If is false, template files are loaded for editing.
;<tt>CharacterSet (String)</tt>:defines which set of characters a document is based on.
;<tt>FilterName (String)</tt>:specifies a special filter for the <tt>loadComponentFromURL</tt> function. The filter names available are defined in the <tt>\share\config\registry\instance\org\openoffice\office\TypeDetection.xml</tt> file.
;<tt>FilterOptions (String)</tt>:defines additional options for filters.
;<tt>JumpMark (String)</tt>:once a document has been opened, jumps to the position defined in JumpMark.
;<tt>Password (String)</tt>:transfers a password for a protected file.
;<tt>ReadOnly (Boolean)</tt>:loads a read-only document.

The following example shows how a text file separated by a comma in {{OOo}} Calc can be opened using the <tt>FilterName</tt> option.

<source lang="oobas">
Dim Doc As Object
Dim FileProperties(1) As New com.sun.star.beans.PropertyValue
Dim Url As String

Url = "file:///C:/doc.csv"
FileProperties(0).Name = "FilterName"
FileProperties(0).Value ="Text - txt - csv (StarCalc)"
FileProperties(1).Name = "FilterOptions"
FileProperties(1).value = "44,34,0,1"

Doc = StarDesktop.loadComponentFromURL(Url, "_blank", 0, FileProperties())
</source>

The <tt>FileProperties</tt> data field covers precisely one value because it records one option. The <tt>Filtername</tt> property defines whether {{OOo}} uses a {{OOo}} Calc text filter to open files.

=== Creating New Documents ===

{{OOo}} automatically creates a new document if the document specified in the URL is a template.

Alternatively, if only an empty document without any adaptation is needed, a <tt>private:factory</tt> URL can be specified:

<source lang="oobas">
Dim Dummy()
Dim Url As String
Dim Doc As Object

Url = "private:factory/swriter"
Doc = StarDesktop.loadComponentFromURL(Url, "_blank", 0, Dummy())
</source>

The call creates an empty {{OOo}} writer document.

== Document Objects ==

The <tt>loadComponentFromURL</tt> function introduced in the previous section returns a document object. This supports the <idl>com.sun.star.document.OfficeDocument</idl> service, which in turn provides two central interfaces:

* The <idl>com.sun.star.frame.XStorable</idl> interface, which is responsible for saving documents.
* The <idl>com.sun.star.view.XPrintable</idl> interface, which contains the methods for printing documents.

=== Saving and Exporting Documents ===

{{OOo}} documents are saved directly through the document object. The <tt>store</tt> method of the <idl>com.sun.star.frame.XStorable</idl> interface is available for this purpose:

<source lang="oobas">
Doc.store()
</source>

This call functions provided that the document has already been assigned a memory space. This is not the case for new documents. In this instance, the <tt>storeAsURL</tt> method is used. This method is also defined in <idl>com.sun.star.frame.XStorable</idl> and can be used to define the location of the document:

<source lang="oobas">
Dim URL As String
Dim Dummy()

Url = "file:///C:/test3.odt"
Doc.storeAsURL(URL, Dummy())
</source>

In addition to the preceding methods, <idl>com.sun.star.frame.XStorable</idl> also provides some help methods which are useful when saving documents. These are:

;<tt>hasLocation()</tt>:specifies whether the document has already been assigned a URL.
;<tt>isReadonly()</tt>:specifies whether a document has read-only protection.
;<tt>isModified()</tt>:specifies whether a document has been modified since it was last saved.

The code for saving a document can be extended by these options so that the document is only saved if the object has actually been modified and the file name is only queried if it is actually needed:

<source lang="oobas">
If (Doc.isModified) Then
If (Doc.hasLocation And (Not Doc.isReadOnly)) Then
Doc.store()
Else
Doc.storeAsURL(URL, Dummy())
End If
End If
</source>

The example first checks whether the relevant document has been modified since it was last saved. It only continues with the saving process if this is the case. If the document has already been assigned a URL and is not a read-only document, it is saved under the existing URL. If it does not have a URL or was opened in its read-only status, it is saved under a new URL.

=== storeAsURL Method Options ===

As with the <tt>loadComponentFromURL</tt> method, some options can also be specified in the form of a <tt>PropertyValue</tt> data field using the <tt>storeAsURL</tt> method. These determine the procedure {{OOo}} uses when saving a document. <tt>storeAsURL</tt> provides the following options:

;<tt>CharacterSet (String)</tt>:defines which set of characters a document is based on.
;<tt>FilterName (String)</tt>:specifies a special filter for the <tt>loadComponentFromURL</tt> function. The filter names available are defined in the <tt>\share\config\registry\instance\org\openoffice\office\TypeDetection.xml</tt> file.
;<tt>FilterOptions (String)</tt>:defines additional options for filters.
;<tt>Overwrite (Boolean)</tt>:allows a file which already exists to be overwritten without a query.
;<tt>Password (String)</tt>:transfers the password for a protected file.
;<tt>Unpacked (Boolean)</tt>:saves the document (not compressed) in sub-directories.

The following example shows how the <tt>Overwrite</tt> option can be used in conjunction with <tt>storeAsURL</tt>:

<source lang="oobas">
Dim Doc As Object
Dim FileProperties(0) As New com.sun.star.beans.PropertyValue
Dim Url As String
' ... Initialize Doc

Url = "file:///c:/test3.odt"
FileProperties(0).Name = "Overwrite"
FileProperties(0).Value = True
Doc.storeAsURL(Url, FileProperties())
</source>

The example then saves <tt>Doc</tt> under the specified file name if a file already exists under the name.

=== Printing Documents ===

Similar to saving, documents are printed out directly by means of the document object. The <tt>Print</tt> method of the <idl>com.sun.star.view.Xprintable</idl> interface is provided for this purpose. In its simplest form, the print call is:

<source lang="oobas">
Dim Dummy()

Doc.print(Dummy())
</source>

As in the case of the <tt>loadComponentFromURL</tt> method, the Dummy parameter is a <tt>PropertyValue</tt> data field through which {{OOo}} can specify several options for printing.

=== The options of the print method ===

The <tt>print</tt> method expects a <tt>PropertyValue</tt> data field as a parameter, which reflects the settings of the print dialog of {{OOo}}:

;<tt>CopyCount (Integer)</tt>:specifies the number of copies to be printed.
;<tt>FileName (String)</tt>:prints the document in the specified file.
;<tt>Collate (Boolean)</tt>:advises the printer to collate the pages of the copies.
;<tt>Sort (Boolean)</tt>:sorts the pages when printing out several copies (<tt>CopyCount</tt> > 1).
;<tt>Pages (String)</tt>:contains the list of the pages to be printed (syntax as specified in print dialog).

The following example shows how several pages of a document can be printed out using the <tt>Pages</tt> option:

<source lang="oobas">
Dim Doc As Object
Dim PrintProperties(0) As New com.sun.star.beans.PropertyValue

PrintProperties(0).Name="Pages"
PrintProperties(0).Value="1-3; 7; 9"
Doc.print(PrintProperties())
</source>

=== Printer selection and settings ===

The <idl>com.sun.star.view.XPrintable</idl> interface provides the <tt>Printer</tt> property, which selects the printer. This property receives a <tt>PropertyValue</tt> data field with the following settings:

;<tt>Name (String)</tt>:specifies the name of printer.
;<tt>PaperOrientation (Enum)</tt>:specifies the paper orientation (<idl>com.sun.star.view.PaperOrientation.PORTRAIT</idl> value for portrait format, <idl>com.sun.star.view.PaperOrientation.LANDSCAPE</idl> for landscape format).
;<tt>PaperFormat (Enum)</tt>:specifies the paper format (for example, <idl>com.sun.star.view.PaperFormat.A4</idl> for DIN A4 or <idl>com.sun.star.view.PaperFormat.Letter</idl> for US letters).
;<tt>PaperSize (Size)</tt>:specifies the paper size in hundredths of a millimeter.

The following example shows how a printer can be changed and the paper size set with the help of the <tt>Printer</tt> property.

<source lang="oobas">
Dim Doc As Object
Dim PrinterProperties(1) As New com.sun.star.beans.PropertyValue
Dim PaperSize As New com.sun.star.awt.Size

PaperSize.Width = 20000 ' corresponds to 20 cm
PaperSize.Height = 20000 ' corresponds to 20 cm
PrinterProperties (0).Name="Name"
PrinterProperties (0).Value="My HP Laserjet"
PrinterProperties (1).Name="PaperSize"
PrinterProperties (1).Value=PaperSize
Doc.Printer = PrinterProperties()
</source>

The example defines an object named <tt>PaperSize</tt> with the <idl>com.sun.star.awt.Size</idl> type. This is needed to specify the paper size. Furthermore, it creates a data field for two <tt>PropertyValue</tt> entries named <tt>PrinterProperties</tt>. This data field is then initialized with the values to be set and assigned the <tt>Printer</tt> property. From the standpoint of UNO, the printer is not a real property but an imitated one.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/StarDesktop}}
{{PDL1}}

Kezdőlap

2009-05-15T20:12:52Z

Timarandras: /* Fejlesztés */

== Üdvözli az OpenOffice.org wiki ==
A wiki az OpenOffice.org (OOo) felhasználóinak / fejlesztőinek készült. A felhasználók egyre növekvő száma is szükségessé tesz a [http://hu.openoffice.org magyar OOo honlapon] kívüli információforrást.
Az itt található linkekre kattintva közvetlenül eljuthat a kiválasztott oldalra.

Csatlakozzon az OpenOffice.org wiki készítőihez. Lehetőleg használja az OOo bejelentkezési nevét a regisztrációjakor. (A későbbiekben összevonásra kerülhet a két rész.) Néhány funkciót csak a bejelentkezett felhasználók használhatnak, a spamelés elkerülésére. A regisztráció része a levelezési cím ellenőrzése.

== Fórumok ==
Az alábbi fórumokon választ kaphat a feltett kérdésére, kereshet a korábbi témák között.

Magyar nyelven:
[http://user.services.openoffice.org/hu/forum/ OpenOffice.org Közösségi Fórum]

Valamint a:
[http://hup.hu/forum/192 HUP iroda fórum]

Angolul:
[http://user.services.openoffice.org/en/forum/ OpenOffice.org Community Forum]

----
== Az OpenOffice.org 3.1 újdonságai ==
[http://www.openoffice.hu/2009/05/az-openoffice-31-ujdonsagai/ Az OpenOffice.org 3.1 újdonságai]

[[Base újdonságai a 3.1-s változatban]]

== Az OpenOffice.org 3.0 újdonságai ==
[http://hu.openoffice.org/files/documents/176/4324/OpenOffice.org3_ujdonsagai.pdf 3.0 újdonságai]

== Az OpenOffice.org 2.4 újdonságai ==
[[2.4 változat újdonságai]]

== Dokumentáció ==

Az OpenOffice.org használatával kapcsolatos dokumentációk ebben a wikiben:

[[HU/Documentation/BASIC_Guide|OpenOffice.org BASIC programozói útmutató]]

== Fejlesztés ==
Az OpenOffice.org magyar fejlesztésével kapcsolatos oldalak.

[[Hu.openoffice.org/Magyar_Ispell_hibabejelent%C3%A9s|Magyar Ispell hibabejelentés]]

[[Hu.openoffice.org/Szabad_diploma_-_OOo|Szabad diploma - OOo]]

[[Hu.openoffice.org/Minőségbiztosítás|Minőségbiztosítás - VCLTesttool]]

{{InterWiki Languages}}

[[Category:Magyar]]

Kezdőlap

2009-05-15T20:11:37Z

Timarandras:

== Üdvözli az OpenOffice.org wiki ==
A wiki az OpenOffice.org (OOo) felhasználóinak / fejlesztőinek készült. A felhasználók egyre növekvő száma is szükségessé tesz a [http://hu.openoffice.org magyar OOo honlapon] kívüli információforrást.
Az itt található linkekre kattintva közvetlenül eljuthat a kiválasztott oldalra.

Csatlakozzon az OpenOffice.org wiki készítőihez. Lehetőleg használja az OOo bejelentkezési nevét a regisztrációjakor. (A későbbiekben összevonásra kerülhet a két rész.) Néhány funkciót csak a bejelentkezett felhasználók használhatnak, a spamelés elkerülésére. A regisztráció része a levelezési cím ellenőrzése.

== Fórumok ==
Az alábbi fórumokon választ kaphat a feltett kérdésére, kereshet a korábbi témák között.

Magyar nyelven:
[http://user.services.openoffice.org/hu/forum/ OpenOffice.org Közösségi Fórum]

Valamint a:
[http://hup.hu/forum/192 HUP iroda fórum]

Angolul:
[http://user.services.openoffice.org/en/forum/ OpenOffice.org Community Forum]

----
== Az OpenOffice.org 3.1 újdonságai ==
[http://www.openoffice.hu/2009/05/az-openoffice-31-ujdonsagai/ Az OpenOffice.org 3.1 újdonságai]

[[Base újdonságai a 3.1-s változatban]]

== Az OpenOffice.org 3.0 újdonságai ==
[http://hu.openoffice.org/files/documents/176/4324/OpenOffice.org3_ujdonsagai.pdf 3.0 újdonságai]

== Az OpenOffice.org 2.4 újdonságai ==
[[2.4 változat újdonságai]]

== Dokumentáció ==

Az OpenOffice.org használatával kapcsolatos dokumentációk ebben a wikiben:

[[HU/Documentation/BASIC_Guide|OpenOffice.org BASIC programozói útmutató]]

== Fejlesztés ==
Az OpenOffice.org magyar fejlesztésével kapcsolatos oldalak.

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Magyar_Ispell_hibabejelent%C3%A9s Magyar Ispell hibabejelentés]

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Szabad_diploma_-_OOo Szabad diploma - OOo]

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Minőségbiztosítás Minőségbiztosítás - VCLTesttool]

{{InterWiki Languages}}

[[Category:Magyar]]

Kezdőlap

2009-05-15T20:08:40Z

Timarandras: /* Dokumentáció */

== Üdvözli az OpenOffice.org wiki ==
A wiki az OpenOffice.org (OOo) felhasználóinak / fejlesztőinek készült. A felhasználók egyre növekvő száma is szükségessé tesz a [http://hu.openoffice.org magyar OOo honlapon] kívüli információforrást.
Az itt található linkekre kattintva közvetlenül eljuthat a kiválasztott oldalra.

Csatlakozzon az OpenOffice.org wiki készítőihez. Lehetőleg használja az OOo bejelentkezési nevét a regisztrációjakor. (A későbbiekben összevonásra kerülhet a két rész.) Néhány funkciót csak a bejelentkezett felhasználók használhatnak, a spamelés elkerülésére. A regisztráció része a levelezési cím ellenőrzése.

== Fórumok ==
Az alábbi fórumokon választ kaphat a feltett kérdésére, kereshet a korábbi témák között.

Magyar nyelven:
[http://user.services.openoffice.org/hu/forum/ OpenOffice.org Közösségi Fórum]

Valamint a:
[http://hup.hu/forum/192 HUP iroda fórum]

Angolul:
[http://user.services.openoffice.org/en/forum/ OpenOffice.org Community Forum]

----
== Az OpenOffice.org 3.1 újdonságai ==
[http://www.openoffice.hu/2009/05/az-openoffice-31-ujdonsagai/ Az OpenOffice.org 3.1 újdonságai]

[[Base újdonságai a 3.1-s változatban]]

== Az OpenOffice.org 3.0 újdonságai ==
[http://hu.openoffice.org/files/documents/176/4324/OpenOffice.org3_ujdonsagai.pdf 3.0 újdonságai]

== Az OpenOffice.org 2.4 újdonságai ==
[[2.4 változat újdonságai]]

== Dokumentáció ==

Az OpenOffice.org használatával kapcsolatos dokumentációk ebben a wikiben:

[[OpenOffice.org BASIC programozói útmutató HU/Documentation/BASIC_Guide]]

== Fejlesztés ==
Az OpenOffice.org magyar fejlesztésével kapcsolatos oldalak.

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Magyar_Ispell_hibabejelent%C3%A9s Magyar Ispell hibabejelentés]

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Szabad_diploma_-_OOo Szabad diploma - OOo]

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Minőségbiztosítás Minőségbiztosítás - VCLTesttool]

{{InterWiki Languages}}

[[Category:Magyar]]

Kezdőlap

2009-05-15T20:07:17Z

Timarandras: /* Dokumentáció */

== Üdvözli az OpenOffice.org wiki ==
A wiki az OpenOffice.org (OOo) felhasználóinak / fejlesztőinek készült. A felhasználók egyre növekvő száma is szükségessé tesz a [http://hu.openoffice.org magyar OOo honlapon] kívüli információforrást.
Az itt található linkekre kattintva közvetlenül eljuthat a kiválasztott oldalra.

Csatlakozzon az OpenOffice.org wiki készítőihez. Lehetőleg használja az OOo bejelentkezési nevét a regisztrációjakor. (A későbbiekben összevonásra kerülhet a két rész.) Néhány funkciót csak a bejelentkezett felhasználók használhatnak, a spamelés elkerülésére. A regisztráció része a levelezési cím ellenőrzése.

== Fórumok ==
Az alábbi fórumokon választ kaphat a feltett kérdésére, kereshet a korábbi témák között.

Magyar nyelven:
[http://user.services.openoffice.org/hu/forum/ OpenOffice.org Közösségi Fórum]

Valamint a:
[http://hup.hu/forum/192 HUP iroda fórum]

Angolul:
[http://user.services.openoffice.org/en/forum/ OpenOffice.org Community Forum]

----
== Az OpenOffice.org 3.1 újdonságai ==
[http://www.openoffice.hu/2009/05/az-openoffice-31-ujdonsagai/ Az OpenOffice.org 3.1 újdonságai]

[[Base újdonságai a 3.1-s változatban]]

== Az OpenOffice.org 3.0 újdonságai ==
[http://hu.openoffice.org/files/documents/176/4324/OpenOffice.org3_ujdonsagai.pdf 3.0 újdonságai]

== Az OpenOffice.org 2.4 újdonságai ==
[[2.4 változat újdonságai]]

== Dokumentáció ==

Az OpenOffice.org használatával kapcsolatos dokumentációk ebben a wikiben:

[[HU/Documentation/BASIC_Guide OpenOffice.org BASIC programozói útmutató]]

== Fejlesztés ==
Az OpenOffice.org magyar fejlesztésével kapcsolatos oldalak.

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Magyar_Ispell_hibabejelent%C3%A9s Magyar Ispell hibabejelentés]

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Szabad_diploma_-_OOo Szabad diploma - OOo]

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Minőségbiztosítás Minőségbiztosítás - VCLTesttool]

{{InterWiki Languages}}

[[Category:Magyar]]

Kezdőlap

2009-05-15T20:05:41Z

Timarandras: /* Az OpenOffice.org 3.1 újdonságai */

== Üdvözli az OpenOffice.org wiki ==
A wiki az OpenOffice.org (OOo) felhasználóinak / fejlesztőinek készült. A felhasználók egyre növekvő száma is szükségessé tesz a [http://hu.openoffice.org magyar OOo honlapon] kívüli információforrást.
Az itt található linkekre kattintva közvetlenül eljuthat a kiválasztott oldalra.

Csatlakozzon az OpenOffice.org wiki készítőihez. Lehetőleg használja az OOo bejelentkezési nevét a regisztrációjakor. (A későbbiekben összevonásra kerülhet a két rész.) Néhány funkciót csak a bejelentkezett felhasználók használhatnak, a spamelés elkerülésére. A regisztráció része a levelezési cím ellenőrzése.

== Fórumok ==
Az alábbi fórumokon választ kaphat a feltett kérdésére, kereshet a korábbi témák között.

Magyar nyelven:
[http://user.services.openoffice.org/hu/forum/ OpenOffice.org Közösségi Fórum]

Valamint a:
[http://hup.hu/forum/192 HUP iroda fórum]

Angolul:
[http://user.services.openoffice.org/en/forum/ OpenOffice.org Community Forum]

----
== Az OpenOffice.org 3.1 újdonságai ==
[http://www.openoffice.hu/2009/05/az-openoffice-31-ujdonsagai/ Az OpenOffice.org 3.1 újdonságai]

[[Base újdonságai a 3.1-s változatban]]

== Az OpenOffice.org 3.0 újdonságai ==
[http://hu.openoffice.org/files/documents/176/4324/OpenOffice.org3_ujdonsagai.pdf 3.0 újdonságai]

== Az OpenOffice.org 2.4 újdonságai ==
[[2.4 változat újdonságai]]

== Dokumentáció ==

Az OpenOffice.org használatával kapcsolatos dokumentációk: [[Dokumentáció]]
(jelenleg üres)

== Fejlesztés ==
Az OpenOffice.org magyar fejlesztésével kapcsolatos oldalak.

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Magyar_Ispell_hibabejelent%C3%A9s Magyar Ispell hibabejelentés]

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Szabad_diploma_-_OOo Szabad diploma - OOo]

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Minőségbiztosítás Minőségbiztosítás - VCLTesttool]

{{InterWiki Languages}}

[[Category:Magyar]]

Kezdőlap

2009-05-15T20:05:15Z

Timarandras: /* Az OpenOffice.org 3.1 újdonságai */

== Üdvözli az OpenOffice.org wiki ==
A wiki az OpenOffice.org (OOo) felhasználóinak / fejlesztőinek készült. A felhasználók egyre növekvő száma is szükségessé tesz a [http://hu.openoffice.org magyar OOo honlapon] kívüli információforrást.
Az itt található linkekre kattintva közvetlenül eljuthat a kiválasztott oldalra.

Csatlakozzon az OpenOffice.org wiki készítőihez. Lehetőleg használja az OOo bejelentkezési nevét a regisztrációjakor. (A későbbiekben összevonásra kerülhet a két rész.) Néhány funkciót csak a bejelentkezett felhasználók használhatnak, a spamelés elkerülésére. A regisztráció része a levelezési cím ellenőrzése.

== Fórumok ==
Az alábbi fórumokon választ kaphat a feltett kérdésére, kereshet a korábbi témák között.

Magyar nyelven:
[http://user.services.openoffice.org/hu/forum/ OpenOffice.org Közösségi Fórum]

Valamint a:
[http://hup.hu/forum/192 HUP iroda fórum]

Angolul:
[http://user.services.openoffice.org/en/forum/ OpenOffice.org Community Forum]

----
== Az OpenOffice.org 3.1 újdonságai ==
[http://www.openoffice.hu/2009/05/az-openoffice-31-ujdonsagai/|Az OpenOffice.org 3.1 újdonságai]

[[Base újdonságai a 3.1-s változatban]]

== Az OpenOffice.org 3.0 újdonságai ==
[http://hu.openoffice.org/files/documents/176/4324/OpenOffice.org3_ujdonsagai.pdf 3.0 újdonságai]

== Az OpenOffice.org 2.4 újdonságai ==
[[2.4 változat újdonságai]]

== Dokumentáció ==

Az OpenOffice.org használatával kapcsolatos dokumentációk: [[Dokumentáció]]
(jelenleg üres)

== Fejlesztés ==
Az OpenOffice.org magyar fejlesztésével kapcsolatos oldalak.

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Magyar_Ispell_hibabejelent%C3%A9s Magyar Ispell hibabejelentés]

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Szabad_diploma_-_OOo Szabad diploma - OOo]

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Minőségbiztosítás Minőségbiztosítás - VCLTesttool]

{{InterWiki Languages}}

[[Category:Magyar]]

Kezdőlap

2009-05-15T20:04:58Z

Timarandras: /* Az OpenOffice.org 3.1 újdonságai */

== Üdvözli az OpenOffice.org wiki ==
A wiki az OpenOffice.org (OOo) felhasználóinak / fejlesztőinek készült. A felhasználók egyre növekvő száma is szükségessé tesz a [http://hu.openoffice.org magyar OOo honlapon] kívüli információforrást.
Az itt található linkekre kattintva közvetlenül eljuthat a kiválasztott oldalra.

Csatlakozzon az OpenOffice.org wiki készítőihez. Lehetőleg használja az OOo bejelentkezési nevét a regisztrációjakor. (A későbbiekben összevonásra kerülhet a két rész.) Néhány funkciót csak a bejelentkezett felhasználók használhatnak, a spamelés elkerülésére. A regisztráció része a levelezési cím ellenőrzése.

== Fórumok ==
Az alábbi fórumokon választ kaphat a feltett kérdésére, kereshet a korábbi témák között.

Magyar nyelven:
[http://user.services.openoffice.org/hu/forum/ OpenOffice.org Közösségi Fórum]

Valamint a:
[http://hup.hu/forum/192 HUP iroda fórum]

Angolul:
[http://user.services.openoffice.org/en/forum/ OpenOffice.org Community Forum]

----
== Az OpenOffice.org 3.1 újdonságai ==
[http://www.openoffice.hu/2009/05/az-openoffice-31-ujdonsagai/|Az OpenOffice.org 3.1 újdonságai]
[[Base újdonságai a 3.1-s változatban]]

== Az OpenOffice.org 3.0 újdonságai ==
[http://hu.openoffice.org/files/documents/176/4324/OpenOffice.org3_ujdonsagai.pdf 3.0 újdonságai]

== Az OpenOffice.org 2.4 újdonságai ==
[[2.4 változat újdonságai]]

== Dokumentáció ==

Az OpenOffice.org használatával kapcsolatos dokumentációk: [[Dokumentáció]]
(jelenleg üres)

== Fejlesztés ==
Az OpenOffice.org magyar fejlesztésével kapcsolatos oldalak.

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Magyar_Ispell_hibabejelent%C3%A9s Magyar Ispell hibabejelentés]

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Szabad_diploma_-_OOo Szabad diploma - OOo]

[http://wiki.services.openoffice.org/wiki/Hu.openoffice.org/Minőségbiztosítás Minőségbiztosítás - VCLTesttool]

{{InterWiki Languages}}

[[Category:Magyar]]

HU/Documentation/BASIC Guide

2009-05-15T20:00:15Z

Timarandras:

{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=none
|NextPage=HU/Documentation/BASIC Guide/Language
}}
{{DISPLAYTITLE:{{OOo}} BASIC programozói útmutató}}
__NOTOC__

Ez az útmutató bevezet az {{OOo}} Basic programozásába. Ha a legtöbbet akarjuk kihozni ebből a könyvből, nem árt, ha ismerünk néhány másik programozási nyelvet is. A könyvben számos példát találhatunk, amelyek segítségével rövid idő alatt létrehozhatjuk saját {{OOo}} Basic programjainkat.

Az útmutató {{OOo}} Basic programozásának ismereteit több fejezetre osztja szét. Az első három fejezet megismerteti az olvasót az {{OOo}} Basic nyelvvel:

* [[HU/Documentation/BASIC Guide/Language|Az {{OOo}} Basic nyelv]]
* [[HU/Documentation/BASIC Guide/Runtime_Library|A futásidejű programkönyvtár]]
* [[HU/Documentation/BASIC Guide/API_Intro|Bevezetés az API használatába]]

Ezek a fejezetek az {{OOo}} Basic nyelvről adnak áttekintést, és mindenkinek érdemes elolvasnia őket, aki {{OOo}} Basic-programokat akar írni. A további fejezetek részletesen leírják az {{OOo}} API részeit, és igény szerint érdemes elolvasni őket:

* [[HU/Documentation/BASIC Guide/Documents|Munka a dokumentumokkal]]
* [[HU/Documentation/BASIC Guide/Text Documents|Szöveges dokumentumok]]
* [[HU/Documentation/BASIC Guide/Spreadsheets|Munkafüzet-dokumentumok]]
* [[HU/Documentation/BASIC Guide/Drawings Presentations|Rajzok és bemutatók]]
* [[HU/Documentation/BASIC Guide/Charts|Diagramok (grafikonok)]]
* [[HU/Documentation/BASIC Guide/Database|Adatbázisok]]
* [[HU/Documentation/BASIC Guide/Dialogs|Párbeszédablakok]]
* [[HU/Documentation/BASIC Guide/Forms|Űrlapok]]

==Az {{OOo}} Basic nyelvről==

The Az {{OOo}} Basic programozási nyelv az {{OOo}} programhoz lett kifejlesztve, és szorosan integrálódik az Office-csomagba.

Ahogy a neve is jelzi, az {{OOo}} Basic a Basic családjából származó programozási nyelv. Bárki, aki már dolgozott Basic-nyelvekkel – főleg a Microsoft Visual Basicjével vagy Visual Basic for Applications (VBA) nyelvével –, az hamar meg fogja érteni az {{OOo}} Basic nyelvet. Az {{OOo}} Basic alapvető szerkezeteinek jelentős része kompatibilis a Visual Basic nyelvvel.

Az {{OOo}} Basic programozási nyelv négy összetevőből áll:

* Az {{OOo}} Basic nyelv: Definiálja az alapvető nyelvi elemeket, például a változódeklarációkat, ciklusokat és függvényeket.
* A futásidejű programkönyvtár: Az {{OOo}} programhoz közvetlenül nem kapcsolódó normál függvényeket tartalmaz, például számok, karakterláncok, dátumváltozók és fájlok szerkesztésére.
* Az {{OOo}} API (Application Programming Interface – alkalmazásprogramozási felület): Hozzáférést biztosít az {{OOo}}-dokumentumokhoz, és lehetővé teszi ezek létrehozását, mentését, módosítását és nyomtatását.
* A párbeszédablak-szerkesztő: Saját párbeszédablakokat hozhatunk létre, és vezérlőelemeket, illetve eseménykezelőket adhatunk hozzá.

{{Documentation/Note|Az {{OOo}} Basic és a VBA közti kompatibilitás az {{OOo}} Basic nyelvre és a futásidejű könyvtárra korlátozódik. Az {{OOo}} API és a Párbeszédablak-szerkesztő nem kompatibilis a VBA-val (ezeknek a felületeknek a szabványosítása az {{OOo}} számos funkcióját elérhetetlenné tette volna).}}

==Az {{OOo}} Basic felhasználói==

Az {{OOo}} Basic alkalmazása ott kezdődik, ahol az {{OOo}} normál funkciói véget érnek. Az {{OOo}} Basic segítségével a szokásos feladatok automatizálhatók, csatolások hozhatók létre más programokhoz (például egy adatbázis-kiszolgálóhoz), és előre definiált parancsfájlok használatával bonyolult tevékenységek hajthatók végre egyetlen gombnyomással.

Az {{OOo}} Basic teljes hozzáférést biztosít az {{OOo}} funkcióihoz, támogat minden funkciót, módosíthatja a dokumentumtípusokat, és lehetőséget biztosít saját párbeszédablakok létrehozására.

==Az {{OOo}} Basic használata==

Az {{OOo}} Basicet bármilyen {{OOo}}-felhasználó használhatja bármilyen további program vagy kiegészítő nélkül. Még a szokásos telepítésnél is rendelkezik az {{OOo}} az összes szükséges összetevővel a Basic-makrók létrehozásához, a következőket is beleértve:

* Az integrált fejlesztési környezet (IDE), amely egy szerkesztőt biztosít a makrók létrehozásához és teszteléséhez.
* Az értelmező, amely az {{OOo}} Basic-makrók futtatásához szükséges.
* A felületek a különböző {{OOo}}-alkalmazásokhoz, amelyek közvetlen hozzáférést biztosítanak az Office-dokumentumokhoz.

==További információk==

Az útmutatóban bemutatott {{OOo}} API-összetevők az {{OOo}} Basic-programozó szemszögéből vannak összeválogatva. Általánosságban elmondható, hogy a felületeknek (interfészeknek) csak egy része kerül bemutatásra. Részletesebb információkért lásd [http://api.openoffice.org/docs/common/ref/com/sun/star/module-ix.html az API-referenciát].

A [[Documentation/DevGuide/OpenOffice.org_Developers_Guide|Developer's Guide]] részletesebben ismerteti ennél az útmutatónál az {{OOo}} API-t, de főleg a Java- és C++-programozóknak íródott. Bárki, aki ismeri az {{OOo}} Basic programozását, találhat további információkat az {{OOo}} Basic nyelvről és az {{OOo}} programozásáról a Developer's Guide-ban.

Azoknak a programozóknak akik az {{OOo}} Basic helyett Java vagy C++ nyelven akarnak programot írni, érdemes ehelyett az útmutató helyett inkább az {{OOo}} Developer's Guide-ot elolvasniuk. Az {{OOo}} Java vagy C++ nyelven történő programozása jelentősen bonyolultabb, mint az {{OOo}} Basic nyelven történő programozás.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide}}
{{PDL1}}
[[Category:Magyar]]

HU/Documentation/BASIC Guide

2009-05-15T19:59:16Z

Timarandras: /* A {{OOo}} Basic felhasználói */

{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=none
|NextPage=HU/Documentation/BASIC Guide/Language
}}
{{DISPLAYTITLE:{{OOo}} BASIC programozói útmutató}}
__NOTOC__

Ez az útmutató bevezet az {{OOo}} Basic programozásába. Ha a legtöbbet akarjuk kihozni ebből a könyvből, nem árt, ha ismerünk néhány másik programozási nyelvet is. A könyvben számos példát találhatunk, amelyek segítségével rövid idő alatt létrehozhatjuk saját {{OOo}} Basic programjainkat.

Az útmutató {{OOo}} Basic programozásának ismereteit több fejezetre osztja szét. Az első három fejezet megismerteti az olvasót a {{OOo}} Basic nyelvvel:

* [[HU/Documentation/BASIC Guide/Language|Az {{OOo}} Basic nyelv]]
* [[HU/Documentation/BASIC Guide/Runtime_Library|A futásidejű programkönyvtár]]
* [[HU/Documentation/BASIC Guide/API_Intro|Bevezetés az API használatába]]

Ezek a fejezetek az {{OOo}} Basic nyelvről adnak áttekintést, és mindenkinek érdemes elolvasnia őket, aki {{OOo}} Basic-programokat akar írni. A további fejezetek részletesen leírják a {{OOo}} API részeit, és igény szerint érdemes elolvasni őket:

* [[HU/Documentation/BASIC Guide/Documents|Munka a dokumentumokkal]]
* [[HU/Documentation/BASIC Guide/Text Documents|Szöveges dokumentumok]]
* [[HU/Documentation/BASIC Guide/Spreadsheets|Munkafüzet-dokumentumok]]
* [[HU/Documentation/BASIC Guide/Drawings Presentations|Rajzok és bemutatók]]
* [[HU/Documentation/BASIC Guide/Charts|Diagramok (grafikonok)]]
* [[HU/Documentation/BASIC Guide/Database|Adatbázisok]]
* [[HU/Documentation/BASIC Guide/Dialogs|Párbeszédablakok]]
* [[HU/Documentation/BASIC Guide/Forms|Űrlapok]]

==Az {{OOo}} Basic nyelvről==

The Az {{OOo}} Basic programozási nyelv az {{OOo}} programhoz lett kifejlesztve, és szorosan integrálódik az Office-csomagba.

Ahogy a neve is jelzi, az {{OOo}} Basic a Basic családjából származó programozási nyelv. Bárki, aki már dolgozott Basic-nyelvekkel – főleg a Microsoft Visual Basicjével vagy Visual Basic for Applications (VBA) nyelvével –, az hamar meg fogja érteni a {{OOo}} Basic nyelvet. Az {{OOo}} Basic alapvető szerkezeteinek jelentős része kompatibilis a Visual Basic nyelvvel.

Az {{OOo}} Basic programozási nyelv négy összetevőből áll:

* Az {{OOo}} Basic nyelv: Definiálja az alapvető nyelvi elemeket, például a változódeklarációkat, ciklusokat és függvényeket.
* A futásidejű programkönyvtár: Az {{OOo}} programhoz közvetlenül nem kapcsolódó normál függvényeket tartalmaz, például számok, karakterláncok, dátumváltozók és fájlok szerkesztésére.
* Az {{OOo}} API (Application Programming Interface – alkalmazásprogramozási felület): Hozzáférést biztosít az {{OOo}}-dokumentumokhoz, és lehetővé teszi ezek létrehozását, mentését, módosítását és nyomtatását.
* A párbeszédablak-szerkesztő: Saját párbeszédablakokat hozhatunk létre, és vezérlőelemeket, illetve eseménykezelőket adhatunk hozzá.

{{Documentation/Note|Az {{OOo}} Basic és a VBA közti kompatibilitás az {{OOo}} Basic nyelvre és a futásidejű könyvtárra korlátozódik. Az {{OOo}} API és a Párbeszédablak-szerkesztő nem kompatibilis a VBA-val (ezeknek a felületeknek a szabványosítása az {{OOo}} számos funkcióját elérhetetlenné tette volna).}}

==Az {{OOo}} Basic felhasználói==

Az {{OOo}} Basic alkalmazása ott kezdődik, ahol az {{OOo}} normál funkciói véget érnek. Az {{OOo}} Basic segítségével a szokásos feladatok automatizálhatók, csatolások hozhatók létre más programokhoz (például egy adatbázis-kiszolgálóhoz), és előre definiált parancsfájlok használatával bonyolult tevékenységek hajthatók végre egyetlen gombnyomással.

Az {{OOo}} Basic teljes hozzáférést biztosít az {{OOo}} funkcióihoz, támogat minden funkciót, módosíthatja a dokumentumtípusokat, és lehetőséget biztosít saját párbeszédablakok létrehozására.

==Az {{OOo}} Basic használata==

Az {{OOo}} Basicet bármilyen {{OOo}}-felhasználó használhatja bármilyen további program vagy kiegészítő nélkül. Még a szokásos telepítésnél is rendelkezik az {{OOo}} az összes szükséges összetevővel a Basic-makrók létrehozásához, a következőket is beleértve:

* Az integrált fejlesztési környezet (IDE), amely egy szerkesztőt biztosít a makrók létrehozásához és teszteléséhez.
* Az értelmező, amely a {{OOo}} Basic-makrók futtatásához szükséges.
* A felületek a különböző {{OOo}}-alkalmazásokhoz, amelyek közvetlen hozzáférést biztosítanak az Office-dokumentumokhoz.

==További információk==

Az útmutatóban bemutatott {{OOo}} API-összetevők az {{OOo}} Basic-programozó szemszögéből vannak összeválogatva. Általánosságban elmondható, hogy a felületeknek (interfészeknek) csak egy része kerül bemutatásra. Részletesebb információkért lásd [http://api.openoffice.org/docs/common/ref/com/sun/star/module-ix.html az API-referenciát].

A [[Documentation/DevGuide/OpenOffice.org_Developers_Guide|Developer's Guide]] részletesebben ismerteti ennél az útmutatónál az {{OOo}} API-t, de főleg a Java- és C++-programozóknak íródott. Bárki, aki ismeri az {{OOo}} Basic programozását, találhat további információkat az {{OOo}} Basic nyelvről és az {{OOo}} programozásáról a Developer's Guide-ban.

Azoknak a programozóknak akik az {{OOo}} Basic helyett Java vagy C++ nyelven akarnak programot írni, érdemes ehelyett az útmutató helyett inkább az {{OOo}} Developer's Guide-ot elolvasniuk. Az {{OOo}} Java vagy C++ nyelven történő programozása jelentősen bonyolultabb, mint az {{OOo}} Basic nyelven történő programozás.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide}}
{{PDL1}}
[[Category:Magyar]]

HU/Documentation/BASIC Guide

2009-05-15T14:58:18Z

Timarandras: added Category:Magyar

{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=none
|NextPage=HU/Documentation/BASIC Guide/Language
}}
{{DISPLAYTITLE:{{OOo}} BASIC programozói útmutató}}
__NOTOC__

Ez az útmutató bevezet az {{OOo}} Basic programozásába. Ha a legtöbbet akarjuk kihozni ebből a könyvből, nem árt, ha ismerünk néhány másik programozási nyelvet is. A könyvben számos példát találhatunk, amelyek segítségével rövid idő alatt létrehozhatjuk saját {{OOo}} Basic programjainkat.

Az útmutató {{OOo}} Basic programozásának ismereteit több fejezetre osztja szét. Az első három fejezet megismerteti az olvasót a {{OOo}} Basic nyelvvel:

* [[HU/Documentation/BASIC Guide/Language|Az {{OOo}} Basic nyelv]]
* [[HU/Documentation/BASIC Guide/Runtime_Library|A futásidejű programkönyvtár]]
* [[HU/Documentation/BASIC Guide/API_Intro|Bevezetés az API használatába]]

Ezek a fejezetek az {{OOo}} Basic nyelvről adnak áttekintést, és mindenkinek érdemes elolvasnia őket, aki {{OOo}} Basic-programokat akar írni. A további fejezetek részletesen leírják a {{OOo}} API részeit, és igény szerint érdemes elolvasni őket:

* [[HU/Documentation/BASIC Guide/Documents|Munka a dokumentumokkal]]
* [[HU/Documentation/BASIC Guide/Text Documents|Szöveges dokumentumok]]
* [[HU/Documentation/BASIC Guide/Spreadsheets|Munkafüzet-dokumentumok]]
* [[HU/Documentation/BASIC Guide/Drawings Presentations|Rajzok és bemutatók]]
* [[HU/Documentation/BASIC Guide/Charts|Diagramok (grafikonok)]]
* [[HU/Documentation/BASIC Guide/Database|Adatbázisok]]
* [[HU/Documentation/BASIC Guide/Dialogs|Párbeszédablakok]]
* [[HU/Documentation/BASIC Guide/Forms|Űrlapok]]

==Az {{OOo}} Basic nyelvről==

The Az {{OOo}} Basic programozási nyelv az {{OOo}} programhoz lett kifejlesztve, és szorosan integrálódik az Office-csomagba.

Ahogy a neve is jelzi, az {{OOo}} Basic a Basic családjából származó programozási nyelv. Bárki, aki már dolgozott Basic-nyelvekkel – főleg a Microsoft Visual Basicjével vagy Visual Basic for Applications (VBA) nyelvével –, az hamar meg fogja érteni a {{OOo}} Basic nyelvet. Az {{OOo}} Basic alapvető szerkezeteinek jelentős része kompatibilis a Visual Basic nyelvvel.

Az {{OOo}} Basic programozási nyelv négy összetevőből áll:

* Az {{OOo}} Basic nyelv: Definiálja az alapvető nyelvi elemeket, például a változódeklarációkat, ciklusokat és függvényeket.
* A futásidejű programkönyvtár: Az {{OOo}} programhoz közvetlenül nem kapcsolódó normál függvényeket tartalmaz, például számok, karakterláncok, dátumváltozók és fájlok szerkesztésére.
* Az {{OOo}} API (Application Programming Interface – alkalmazásprogramozási felület): Hozzáférést biztosít az {{OOo}}-dokumentumokhoz, és lehetővé teszi ezek létrehozását, mentését, módosítását és nyomtatását.
* A párbeszédablak-szerkesztő: Saját párbeszédablakokat hozhatunk létre, és vezérlőelemeket, illetve eseménykezelőket adhatunk hozzá.

{{Documentation/Note|Az {{OOo}} Basic és a VBA közti kompatibilitás az {{OOo}} Basic nyelvre és a futásidejű könyvtárra korlátozódik. Az {{OOo}} API és a Párbeszédablak-szerkesztő nem kompatibilis a VBA-val (ezeknek a felületeknek a szabványosítása az {{OOo}} számos funkcióját elérhetetlenné tette volna).}}

==A {{OOo}} Basic felhasználói==

Az {{OOo}} Basic alkalmazása ott kezdődik, ahol az {{OOo}} normál funkciói véget érnek. Az {{OOo}} Basic segítségével a szokásos feladatok automatizálhatók, csatolások hozhatók létre más programokhoz (például egy adatbázis-kiszolgálóhoz), és előre definiált parancsfájlok használatával bonyolult tevékenységek hajthatók végre egyetlen gombnyomással.

Az {{OOo}} Basic teljes hozzáférést biztosít az {{OOo}} funkcióihoz, támogat minden funkciót, módosíthatja a dokumentumtípusokat, és lehetőséget biztosít saját párbeszédablakok létrehozására.

==Az {{OOo}} Basic használata==

Az {{OOo}} Basicet bármilyen {{OOo}}-felhasználó használhatja bármilyen további program vagy kiegészítő nélkül. Még a szokásos telepítésnél is rendelkezik az {{OOo}} az összes szükséges összetevővel a Basic-makrók létrehozásához, a következőket is beleértve:

* Az integrált fejlesztési környezet (IDE), amely egy szerkesztőt biztosít a makrók létrehozásához és teszteléséhez.
* Az értelmező, amely a {{OOo}} Basic-makrók futtatásához szükséges.
* A felületek a különböző {{OOo}}-alkalmazásokhoz, amelyek közvetlen hozzáférést biztosítanak az Office-dokumentumokhoz.

==További információk==

Az útmutatóban bemutatott {{OOo}} API-összetevők az {{OOo}} Basic-programozó szemszögéből vannak összeválogatva. Általánosságban elmondható, hogy a felületeknek (interfészeknek) csak egy része kerül bemutatásra. Részletesebb információkért lásd [http://api.openoffice.org/docs/common/ref/com/sun/star/module-ix.html az API-referenciát].

A [[Documentation/DevGuide/OpenOffice.org_Developers_Guide|Developer's Guide]] részletesebben ismerteti ennél az útmutatónál az {{OOo}} API-t, de főleg a Java- és C++-programozóknak íródott. Bárki, aki ismeri az {{OOo}} Basic programozását, találhat további információkat az {{OOo}} Basic nyelvről és az {{OOo}} programozásáról a Developer's Guide-ban.

Azoknak a programozóknak akik az {{OOo}} Basic helyett Java vagy C++ nyelven akarnak programot írni, érdemes ehelyett az útmutató helyett inkább az {{OOo}} Developer's Guide-ot elolvasniuk. Az {{OOo}} Java vagy C++ nyelven történő programozása jelentősen bonyolultabb, mint az {{OOo}} Basic nyelven történő programozás.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide}}
{{PDL1}}
[[Category:Magyar]]

HU/Documentation/BASIC Guide/Working With Variables

2009-05-15T14:43:57Z

Timarandras: New page: {{DISPLAYTITLE:Változókkal végzett munka}} {{HU/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=HU/Documentation/BASIC Guide/Program Overview |NextPage=...

{{DISPLAYTITLE:Változókkal végzett munka}}
{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Program Overview
|NextPage=HU/Documentation/BASIC Guide/Strings
|lang=block
}}

==Implicit változódeklaráció ==

A Basic-nyelveket úgy tervezték, hogy egyszerűen használhatók legyenek. Ennek eredményeképpen az {{OOo}} Basic lehetővé teszi a változók létrehozását azok használatával, explicit deklaráció nélkül is. Más szóval a változó onnantól fogva létezik, amikor először előfordul a kódban. A már meglévő változóktól függően a következő példa akár három új változót is deklarál:

a = b + c

A változók implicit deklarálása nem követendő programozási gyakorlat, mert új változók nem szándékos deklarálásához vezethet például egy gépelési hiba miatt. Hibaüzenet megjelenítése helyett az értelmező új változóként fogja fel a gépelési hibát, amelynek a 0 értéket adja. Az ilyen hibákat nagyon nehéz felderíteni a kódban.

==Explicit változódeklaráció ==

Az implicit változódeklarációból fakadó hibák kiküszöbölésére az {{OOo}} Basic tartalmazza a kapcsolót:

<source lang="oobas">
Option Explicit
</source>

Ennek minden modulban az első sorban kell állnia, és biztosítja azt, hogy hibaüzenet jelenik meg, ha egy használt változó nincs deklarálva. Az <tt>Option Explicit</tt> kapcsolót minden Basic-modulban érdemes használni.

A legegyszerűbb esetben az explicit változódeklaráció a következőképpen néz ki:

<source lang="oobas">
Dim SajatValtozo
</source>

Ez a példa deklarál egy <tt>SajatValtozo</tt> nevű változót, amelynek a típusa <tt>Variant</tt>. A Variant egy univerzális változó, amely az összes elképzelhető értéket tartalmazhatja, beleértve a karakterláncokat, egész számokat, lebegőpontos értékeket és logikai értékeket. Az alábbiakban példákat láthatunk Variant változókra:

<source lang="oobas">
SajatValtozo = "Hello, világ!" ' Karakterlánc hozzárendelése
SajatValtozo = 1 ' Egész szám hozzárendelése
SajatValtozo = 1.0 ' Lebegőpontos szám hozzárendelése
SajatValtozo = True ' Logikai érték hozzárendelése
</source>

Az előző példában deklarált változók más változótípusokhoz is használhatók ugyanabban a programban. Annak ellenére, hogy ez jelentős rugalmasságot kínál, a legjobb egy adott változót csak egy típussal használni. Amikor az {{OOo}} Basic egy helytelenül definiált változótípust talál egy adott környezetben, akkor hibaüzenetet generál.

Rögzített típusú változók definiálásához használjuk az alábbi stílust:

<source lang="oobas">
Dim SajatValtozo As Integer ' Integer (egész szám) típusú változó deklarálása
</source>

A változó interger (egész szám) típusúként van deklarálva, és egész számokat tartalmazhat. A következő stílussal egy integer (egész szám) típusú változó deklarálható:

<source lang="oobas">
Dim SajatValtozo% ' Integer (egész szám) típusú változó deklarálása
</source>

A Dim utasítással több változó is deklarálható egyszerre:

<source lang="oobas">
Dim SajatValtozo1, SajatValtozo2
</source>

Ha a változókat egy adott típussal akarjuk deklarálni, akkor mindegyikhez típust kell rendelni:

<source lang="oobas">
Dim SajatValtozo1 As Integer, SajatValtozo2 As Integer
</source>

Ha nem deklaráljuk egy változó típusát, akkor az {{OOo}} Basic a variant típust rendeli hozzá. Például a következő deklarációban a <tt>SajatValtozo1</tt> egy variant lesz, a <tt>SajatValtozo2</tt> viszont integer (egész szám):

<source lang="oobas">
Dim SajatValtozo1, SajatValtozo2 As Integer
</source>

A következő részekben láthatók az {{OOo}} Basicben elérhető változók, valamint a használatuk és deklarálásuk leírása.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Working With Variables}}
{{PDL1}}

HU/Documentation/BASIC Guide/Working With Forms

2009-05-15T14:43:39Z

Timarandras: New page: {{HU/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=HU/Documentation/BASIC Guide/Forms |NextPage=HU/Documentation/BASIC Guide/Control Element Forms |form=...

{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Forms
|NextPage=HU/Documentation/BASIC Guide/Control Element Forms
|form=block
}}
{{DISPLAYTITLE:Munka az űrlapokkal}}
__NOTOC__
Az {{OOo}} űrlapjai tartalmazhatnak szövegmezőket, listapaneleket, választógombokat és számos egyéb vezérlőelemet, amelyeket közvetlenül a szövegbe vagy a munkafüzetbe lehet beszúrni. Az Űrlapelemek eszköztár használatával szerkeszthetők az űrlapok.

Egy {{OOo}}-űrlap a két mód egyikét használhatja: a vázlatmódot vagy a megjelenítési módot. Vázlatmódban a vezérlőelemek helyzete módosítható, és tulajdonságaik szerkeszthetők a tulajdonságablak használatával.

Az Űrlapelemek eszköztár használatával is lehet váltani a két mód között.

== Objektuműrlapok meghatározása ==

Az {{OOo}} a rajzobjektum-szinten helyezi el az űrlap vezérlőelemeit. A tényleges űrlapobjektum a Forms listán keresztül érhető el, a rajzolási szinten. Az objektumokat a következő módon lehet elérni a szöveges dokumentumokban:

<source lang="oobas">
Dim Doc As Object
Dim DrawPage As Object
Dim Form As Object

Doc = StarDesktop.CurrentComponent
DrawPage = Doc.DrawPage
Form = DrawPage.Forms.GetByIndex(0)
</source>

A <tt>GetByIndex</tt> metódus visszaadja a 0-s indexszel rendelkező űrlapot.

Ha munkafüzetekkel dolgozunk, egy közbenső lépésre van szükség (a Sheets listára), mert a rajzolási szintek nem közvetlenül a dokumentumban helyezkednek el, hanem az egyes munkalapokban:

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object
Dim DrawPage As Object
Dim Form As Object

Doc = StarDesktop.CurrentComponent
Sheet = Doc.Sheets.GetByIndex(0)
DrawPage = Sheet.DrawPage
Form = DrawPage.Forms.GetByIndex(0)
</source>

Ahogy a <tt>GetByIndex</tt> metódus neve is jelzi, a dokumentum több űrlapot is tartalmazhat. Ez például akkor hasznos, ha több adatbázis tartalma is megjelenik egyetlen dokumentumban, vagy ha egy 1:n típusú adatbázis-kapcsolat van megjelenítve az űrlapon. Ebből a célból rendelkezésre áll az alűrlapok létrehozásának lehetősége is.

== Az űrlap vezérlőelemeinek három nézőpontja ==

Az űrlap vezérlőelemeinek három nézőpontja van:

* A vezérlőelem '''Modellje''' a kulcsobjektum az {{OOo}} Basic-programozó számára, amikor űrlap-vezérlőelemekkel dolgozik.
* Ennek ellentettje a vezérlőelem '''Nézete''', amely a megjelenítési információkat kezeli.
* Mivel a program speciális rajzelemként kezeli a dokumentumok űrlap-vezérlőelemeit, létezik egy '''Alakzatobjektum''' is, amely a vezérlőelem rajzelem-specifikus tulajdonságait tartalmazza (gyakorlatilag a helyét és méretét).

== Az űrlap-vezérlőelemek modelljének elérése ==

Az űrlap-vezérlőelemek modellje az űrlapobjektum <tt>GetByName</tt> metódusán keresztül érhető el.

<source lang="oobas">
Dim Doc As Object
Dim Form As Object
Dim Ctl As Object

Doc = StarDesktop.CurrentComponent
Form = Doc.DrawPage.Forms.GetByIndex(0)
Ctl = Form.getByName("SajátLista")
</source>

Ez a példa meghatározza a jelenleg megnyitott szöveges dokumentum első űrlapjában található <tt>SajátLista</tt> vezérlőelem modelljét.

Ha nem vagyunk benne biztosak, melyik űrlap tartalmazza a vezérlőelemet, akkor a kívánt vezérlőelemet megkereshetjük az űrlapokban:

<source lang="oobas">
Dim Doc As Object
Dim Forms As Object
Dim Form As Object
Dim Ctl As Object
Dim I as Integer

Doc = StarDesktop.CurrentComponent
Forms = Doc.Drawpage.Forms

For I = 0 To Forms.Count - 1
Form = Forms.GetbyIndex(I)
If Form.HasByName("SajátLista") Then
Ctl = Form.GetbyName("SajátLista")
Exit Function
End If
Next I
</source>

Ez a példa a <tt>HasByName</tt> metódussal végignézi a szöveges dokumentum összes űrlapját, hogy tartalmaz-e egy <tt>SajátLista</tt> nevű vezérlőelemet. Ha az adott modell megtalálható, akkor a program menti az erre mutató hivatkozást a <tt>Ctl</tt> változóba, és a keresés befejeződik.

== Az űrlap-vezérlőelemek nézetének elérése ==

Az űrlap-vezérlőelem nézetének eléréséhez először meg kell határozni a vezérlőelem modelljét. A vezérlőelem modellje ezután meghatározható a modell segítségével és a dokumentumvezérlő használatával.

<source lang="oobas">
Dim Doc As Object
Dim DocCrl As Object
Dim Forms As Object
Dim Form As Object
Dim Ctl As Object
Dim CtlView As Object
Dim I as Integer

Doc = StarDesktop.CurrentComponent
DocCrl = Doc.getCurrentControler()
Forms = Doc.Drawpage.Forms

For I = 0 To Forms.Count - 1
Form = Forms.GetbyIndex(I)
If Form.HasByName("SajátLista") Then
Ctl = Form.GetbyName("SajátLista")
CtlView = DocCrl.GetControl(Ctl)
Exit Function
End If
Next I
</source>

A példában látható kód sokban hasonlít az előző példa kódjához, például a vezérlőelem modelljének meghatározásában. Nem csak a <tt>Doc</tt> dokumentumobjektumot használja, hanem a <tt>DocCrl</tt> dokumentumvezérlő-objektumot, amely egy hivatkozás az aktuális dokumentumablakra. Ezzel a vezérlőobjektummal és a vezérlőelem modelljével a program a <tt>GetControl</tt> metódus használatával meghatározza a vezérlőelem nézetét (<tt>CtlView</tt> változó).

== Az űrlap-vezérlőelemek alakzatobjektumának elérése ==

Az űrlap-vezérlőelemek alakzatobjektumának eléréséhez használt metódus szintén a dokumentum rajzolási szintjét használja. Egy adott vezérlőelem maghatározásához a rajzolási szint összes rajzelemét át kell nézni.

<source lang="oobas">
Dim Doc As Object
Dim Shape as Object
Dim I as integer

Doc = StarDesktop.CurrentComponent

For i = 0 to Doc.DrawPage.Count - 1
Shape = Doc.DrawPage(i)
If HasUnoInterfaces(Shape, "com.sun.star.drawing.XControlShape") Then
If Shape.Control.Name = "SajátLista" Then
Exit Function
End If
End If
Next
</source>

Ez a példaprogram végignézi az összes rajzelemet, és ellenőrzi, hogy azok támogatják-e az űrlap-vezérlőelemekhez szükséges <idl>com.sun.star.drawing.XControlShape</idl> felületet. Amennyiben igen, a <tt>Control.Name</tt> tulajdonsággal ellenőrzi, hogy a vezérlőelem neve <tt>SajátLista</tt>-e. Ha így van, akkor a keresés befejeződik.

=== Vezérlőelemek méretének és helyének meghatározása ===

Mint ahogy azt olvashattuk, a vezérlőelemek mérete és helye megállapítható a hozzájuk tartozó <tt>alakzatobjektummal</tt>. A vezérlőelem alakzatobjektuma, akárcsak az összes többi <tt>alakzatobjektum</tt>, rendelkezik egy <tt>Size</tt> és egy <tt>Position</tt> tulajdonsággal ehhez:

;<tt>Size (struktúra)</tt>:a vezérlőelem mérete (<idl>com.sun.star.awt.Size</idl> adatstruktúra).
;<tt>Position (struktúra)</tt>:a vezérlőelem helye (<idl>com.sun.star.awt.Point</idl> adatstruktúra).

A következő példa bemutatja, hogyan állítható be egy vezérlőelem helye és mérete az alakzatobjektum használatával:

<source lang="oobas">
Dim Shape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size

' ... Shape objektum inicializálása a korábbi módon ...

Point.x = 1000
Point.y = 1000
Size.Width = 10000
Size.Height = 10000

Shape.Size = Size
Shape.Position = Point
</source>

Ahhoz, hogy működjön a kód, a vezérlőelem <tt>alakzatobjektumának</tt> már ismertnek kell lennie. Ha nem így lenne, akkor azt be kell állítani az előző példában látható kóddal.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Working With Forms}}
{{PDL1}}

HU/Documentation/BASIC Guide/Working With Dialogs

2009-05-15T14:43:20Z

Timarandras: New page: {{HU/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=HU/Documentation/BASIC Guide/Dialogs |NextPage=HU/Documentation/BASIC Guide/Properties |dial=block }} ...

{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Dialogs
|NextPage=HU/Documentation/BASIC Guide/Properties
|dial=block
}}
{{DISPLAYTITLE:A párbeszédablakok használata}}
__NOTOC__
Az {{OOo}} Basic párbeszédablakai olyan önálló ablakok, amelyek szövegmezőket, listákat, választókapcsolókat és más vezérlőelemeket tartalmazhatnak.

== Párbeszédablakok létrehozása ==

A párbeszédablakokat az {{OOo}} párbeszédablak-szerkesztőjével hozhatjuk létre és alakíthatjuk ki:

[[Image:documentation_basicguide_dlg_01.gif|none|thumb|500px|Párbeszédablakok létrehozása és alakítása a párbeszédablak-szerkesztővel]]

A használni kívánt vezérlőelemeket a tervezőpalettáról (jobbra) áthúzzuk a párbeszédablak-területre, ahol megadhatjuk ezek helyét és méretét.

A példában egy címkét és egy listát tartalmazó párbeszédablak látható.

[[Image:documentation_basicguide_dlg_04.gif|none|thumb|500px|Címkét és listát tartalmazó párbeszédablak]]

A párbeszédablakok a következő kóddal nyithatók meg:

<source lang="oobas">
Dim Dlg As Object

DialogLibraries.LoadLibrary("Standard")
Dlg = CreateUnoDialog(DialogLibraries.Standard.DlgDef)
Dlg.Execute()
Dlg.dispose()
</source>

A <tt>CreateUnoDialog</tt> egy <tt>Dlg</tt> nevű objektumot hoz létre, amely a kapcsolódó párbeszédablakra hivatkozik. A párbeszédablak létrehozása előtt biztosítani kell, hogy az általa használt programkönyvtár (a példában ez a <tt>Standard</tt>) be legyen töltve. A <tt>LoadLibrary</tt> metódus végrehajtja ezt a feladatot.

A <tt>Dlg</tt> objektum inicializálása után az <tt>Execute</tt> metódussal megjeleníthetjük a párbeszédablakot. A párbeszédablakok, így a példában szereplő is, viselkedése modális, azaz bezárásukig nem tesznek lehetővé más programműveletet. Amíg a párbeszédablak nyitva van, a program az <tt>Execute</tt> hívás állapotában marad.

A kód végén lévő <tt>dispose</tt> metódus a párbeszédablak által használt erőforrásokat felszabadítja a programfutás befejezésekor.

== Párbeszédablakok bezárása ==

=== Bezárás az OK vagy a Mégse gombbal ===

Ha a párbeszédablak tartalmaz egy '''OK''' vagy egy '''Mégse''' gombot, az ezek bármelyikére kattintás automatikusan bezárja a párbeszédablakot. A gombok használatáról a további tudnivalók a [[HU/Documentation/BASIC Guide/Control Elements|Párbeszédablakok vezérlőelemeinek részletes ismertetése]] című részben olvashatók.

Ha egy párbeszédablakot az '''OK''' gombra kattintással zárunk be, az <tt>Execute</tt> metódus visszatérési értéke 1 lesz, egyébként a metódus a 0 értéket adja vissza.

<source lang="oobas">
Dim Dlg As Object

DialogLibraries.LoadLibrary("Standard")
Dlg = CreateUnoDialog(DialogLibraries.Standard.MyDialog)
Select Case Dlg.Execute()
Case 1:
MsgBox "OK gombra kattintás"
Case 0:
MsgBox "Mégse gombra kattintás"
End Select
</source>

=== Bezárás a címsor Bezárás gombjával ===

A párbeszédablakok a címsorban található bezárás (×) gombra kattintással is bezárhatók. Ebben az esetben a párbeszédablak <tt>Execute</tt> metódusa ugyanúgy a 0 értéket adja vissza, mintha a Mégse gombra kattintottunk volna.

=== Bezárás explicit programhívással ===

A megnyitott párbeszédablak az <tt>endExecute</tt> metódussal is bezárható:

<source lang="oobas">
Dlg.endExecute()
</source>

== Az egyes vezérlőelemek elérése ==

A párbeszédablakok tetszőleges számú vezérlőelemet tartalmazhatnak. Ezek a vezérlőelemek a <tt>getControl</tt> metódussal érhetők el, amely a vezérlőelem nevét adja vissza.

<source lang="oobas">
Dim Ctl As Object

Ctl = Dlg.getControl("MyButton")
Ctl.Label = "New Label"
</source>

Ez a kód meghatározza a <tt>MyButton</tt> vezérlőelem objektumát, majd az elemre hivatkozással ennek értékére állítja be a <tt>Ctl</tt> objektumváltozót. Végül a kód a vezérlőelem <tt>Label</tt> tulajdonságához a <tt>New Label</tt> értéket rendeli.

{{Documentation/Note|Az {{OOo}} Basic azonosítóival ellentétben a vezérlőelemek nevében a kis- és nagybetűk különbözőnek számítanak.}}

== Munka a párbeszédablakok és a vezérlőelemek modelljével ==

Az {{OOo}} API számos helyén előfordul a látható programelemek ('''View''') és az ezek mögött lévő adatok vagy dokumentumok ('''Model''') közötti megkülönböztetés. A vezérlőelemek metódusain és tulajdonságain kívül a párbeszédablak- és a vezérlőelem-objektumok is rendelkeznek egy alárendelt <tt>Model</tt> objektummal. Ez az objektum lehetővé teszi, hogy közvetlenül elérjük egy párbeszédablak vagy egy vezérlőelem tartalmát.

A párbeszédablakokban az adatok és a megjelenítés közötti megkülönböztetés nem mindig olyan egyértelmű, mint az {{OOo}} többi API-területén. Az API elemei mind a nézeten, mind a modellen keresztül elérhetők.

A <tt>Model</tt> tulajdonság a párbeszédablak és a vezérlőelem-objektumok modelljének programvezérelt elérését biztosítja.

<source lang="oobas">
Dim cmdNext As Object

cmdNext = Dlg.getControl("cmdNext")
cmdNext.Model.Enabled = False
</source>

Ez a példa a <tt>cmdNtext</tt> modellobjektuma segítségével kikapcsolja a <tt>cmdNtext</tt> gomb működését a <tt>Dlg</tt> párbeszédablakban.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Working With Dialogs}}
{{PDL1}}

HU/Documentation/BASIC Guide/UNO Tools

2009-05-15T14:43:01Z

Timarandras: New page: {{DISPLAYTITLE:Az UNO-val végzett munka eszközei}} {{HU/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=HU/Documentation/BASIC Guide/Modules, Services an...

{{DISPLAYTITLE:Az UNO-val végzett munka eszközei}}
{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Modules, Services and Interfaces
|NextPage=HU/Documentation/BASIC Guide/Interface Overview
|api=block
}}

A kérdés továbbra is az, hogy melyik objektum – azaz szolgáltatás, ha az UNO-terminológián belül akarunk maradni – melyik tulajdonságot, metódust és felületet támogatja, és ez hogyan állapítható meg. Az útmutatóban közölt leíráson felül az objektumokról további információkat kaphatunk a következő forrásokból: a <tt>supportsService</tt> metódus, a hibakeresési metódusok, a Fejlesztői útmutató és az API-referencia.

== A <tt>supportsService</tt> metódus ==

Számos UNO-objektum támogatja a <tt>supportsService</tt> metódust, amellyel meg tudjuk állapítani, hogy egy objektum támogat-e egy adott szolgáltatást. A következő metódushívás például meghatározza, hogy a <tt>TextElement</tt> objektum támogatja-e a <idl>com.sun.star.text.Paragraph</idl> szolgáltatás.

<source lang="oobas">
Ok = TextElement.supportsService("com.sun.star.text.Paragraph")
</source>

== Hibakeresési tulajdonságok ==

Az {{OOo}} Basicben minden UNO-objektum tudja, milyen tulajdonságokat, metódusokat és felületeket tartalmaz. Tartalmaz olyan tulajdonságokat, amelyek ezt visszaadják egy lista formájában. Ezek a tulajdonságok a következők:

;<tt>DBG_properties</tt>:visszaadja egy objektum összes tulajdonságát egy karakterláncban.
;<tt>DBG_methods</tt>:visszaadja egy objektum összes metódusát egy karakterláncban.
;<tt>DBG_supportedInterfaces</tt>:visszaadja azokat a szolgáltatásokat egy karakterláncban, amelyek támogatják az adott objektumot.

A következő példakód bemutatja, hogyan használható valódi alkalmazásokban a <tt>DBG_properties</tt> és a <tt>DBG_methods</tt> tulajdonság. Először létrehozza a <idl>com.sun.star.frame.Desktop</idl> szolgáltatást, majd üzenetablakokban megjeleníti a támogatott tulajdonságokat és metódusokat.

<source lang="oobas">
Dim Obj As Object
Obj = createUnoService("com.sun.star.frame.Desktop")

MsgBox Obj.DBG_Properties
MsgBox Obj.DBG_methods
</source>

A <tt>DBG_properties</tt> tulajdonság használatánál figyeljünk oda, hogy a függvény visszaadja az összes olyan tulajdonságot, amelyet egy szolgáltatás elméletileg támogathat. Viszont semmi sem garantálja, hogy az adott objektum használni is tudja ezeket. Éppen ezért egy tulajdonság használata előtt hívjuk meg az <tt>IsEmpty</tt> függvényt, amellyel ellenőrizhetjük, hogy az adott tulajdonság ténylegesen elérhető-e.

== API-referencia ==

Az elérhető szolgáltatásokról és azok felületeiről, metódusairól és tulajdonságairól további információkat a [http://api.openoffice.org/docs/common/ref/com/sun/star/module-ix.html {{OOo}} API referenciájában] találunk.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/UNO Tools}}
{{PDL1}}

HU/Documentation/BASIC Guide/UNO

2009-05-15T14:42:38Z

Timarandras: New page: {{DISPLAYTITLE:Universal Network Objects (UNO, univerzális hálózati objektumok)}} {{HU/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=HU/Documentation/...

{{DISPLAYTITLE:Universal Network Objects (UNO, univerzális hálózati objektumok)}}
{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/API Intro
|NextPage=HU/Documentation/BASIC Guide/Properties and Methods (API)
|api=block
}}

Az {{OOo}} rendelkezik egy programozási felülettel, amely a Universal Network Objects (UNO, univerzális hálózati objektumok). Ez egy objektumorientált programozási felület, amelyet az {{OOo}} számos olyan objektumra oszt fel, amelyek programvezérlésű hozzáférést biztosítanak az irodai programcsomag adott részeihez.

Mivel az {{OOo}} Basic egy eljárásvezérelt programozási nyelv, számos nyelvi elemet kellett hozzáadni, hogy lehetővé váljon az UNO használata.

Ha egy UNO-objektumot akarunk használni az {{OOo}} Basicben, változódeklarációt kell megadnunk az adott objektumhoz. A deklarációt a <tt>Dim</tt> utasítással végezhetjük el (lásd: [[HU/Documentation/BASIC Guide/Language|Az {{OOo}} Basic nyelv]]). Az <tt>Object</tt> típusmeghatározást kell használni egy objektumváltozó deklarálásához:

<source lang="oobas">
Dim Obj As Object
</source>

Ez az utasítás deklarál egy <tt>Obj</tt> nevű objektumváltozót.

A létrehozott objektumváltozót ezután inicializálni kell a használat előtt. Ezt a <tt>createUnoService</tt> függvénnyel végezhetjük el:

<source lang="oobas">
Obj = createUnoService("com.sun.star.frame.Desktop")
</source>

Ez a függvényhívás az <tt>Obj</tt> változóhoz rendeli az újonnan létrehozott objektumra mutató hivatkozást. A <tt>com.sun.star.frame.Desktop</tt> egy objektumtípus, de az UNO-ban szolgáltatásnak hívják, nem típusnak. Az UNO filozófiájával összhangban az Obj egy olyan objektumra mutató hivatkozás, amely támogatja a <idl>com.sun.star.frame.Desktop</idl> szolgáltatást. Ezért az {{OOo}} Basicben használt szolgáltatás kifejezés a más programozási nyelvek típus és osztály kifejezésének felel meg.

Viszont van egy fontos különbség: egy UNO-objektum egyszerre több szolgáltatást is támogathat. Néhány UNO-szolgáltatás viszont más szolgáltatásokat támogat, így egyetlen objektumon keresztül számos szolgáltatást elérhetünk. Például a már említett objektum, amely a <idl>com.sun.star.frame.Desktop</idl> szolgáltatáson alapul, tartalmazhat más szolgáltatásokat is, például dokumentumok betöltéséhez vagy a program bezárásához.

{{Documentation/Note|Míg a VBA-ban az objektum struktúráját az az osztály határozza meg, amelyhez tartozik, addig az {{OOo}} Basicben a struktúrát azok a szolgáltatások határozzák meg, amelyekhez tartozik. Egy VBA-objektum mindig pontosan egy osztályhoz van rendelve. Ezzel szemben egy {{OOo}} Basic-objektum számos szolgáltatást támogat.}}

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/UNO}}
{{PDL1}}

HU/Documentation/BASIC Guide/Text Documents

2009-05-15T14:42:21Z

Timarandras: New page: {{DISPLAYTITLE:Szöveges dokumentumok}} {{HU/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=HU/Documentation/BASIC Guide/Templates |NextPage=HU/Documentat...

{{DISPLAYTITLE:Szöveges dokumentumok}}
{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Templates
|NextPage=HU/Documentation/BASIC Guide/Structure of Text Documents
|textdocs=block
}}

A karakterláncok mellett a szöveges dokumentumok formázási információkat is tartalmaznak. Ezek bárhol szerepelhetnek a szövegben. Ezt még tovább bonyolítják a táblázatok. Ezek nem csak egydimenziós karakterláncok lehetnek, hanem kétdimenziós mezők. A legtöbb szövegszerkesztő rendszerben már van lehetőség rajzobjektumok, szövegkeretek és egyéb objektumok szövegen belüli kezelésére. Ezek lehetnek a szövegen kívül is, és elhelyezhetők bárhol az oldalon.

Ez a fejezet bemutatja a szöveges dokumentumok központi felületeit és szolgáltatásait.

* [[HU/Documentation/BASIC Guide/Structure of Text Documents|A szöveges dokumentumok felépítése]]
* [[HU/Documentation/BASIC Guide/Editing Text Documents|Szöveges dokumentumok szerkesztése]]
* [[HU/Documentation/BASIC Guide/More Than Text|Több, mint szöveg]]

Az első rész a szöveges dokumentumok felépítésével foglalkozik, és arra koncentrál, hogyan dolgozható fel egy {{OOo}}-dokumentum egy {{OOo}} Basic-programban. A fejezet a bekezdésekre, bekezdésrészletekre és azok formázására összpontosít.

A második rész a szöveges dokumentumokkal végzett hatékony munkával foglalkozik. Ebből a célból egy {{OOo}} számos objektumot bocsát rendelkezésünkre, például a <tt>TextCursor</tt> objektumot, amely túlmutat az első részben bemutatottakon.

A harmadik rész már nem csak a szövegekkel való munkáról szól. Itt már ismertetésre kerülnek a táblázatok, szövegkeretek, szövegmezők, könyvjelzők, tartalomkönyvtárak és számos egyéb dolog.

A [[HU/Documentation/BASIC Guide/Documents|Munka a dokumentumokkal]] fejezet leírja a dokumentumok létrehozását, megnyitását, mentését és nyomtatását, mert a program nem csak szöveges dokumentumokkal használható, hanem számos egyéb típusúval is.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Text Documents}}
{{PDL1}}

HU/Documentation/BASIC Guide/Templates

2009-05-15T14:42:03Z

Timarandras: New page: {{DISPLAYTITLE:Sablonok}} {{HU/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=HU/Documentation/BASIC Guide/StarDesktop |NextPage=HU/Documentation/BASIC Gu...

{{DISPLAYTITLE:Sablonok}}
{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/StarDesktop
|NextPage=HU/Documentation/BASIC Guide/Text Documents
|docs=block
}}

A sablonok névvel ellátott listák, amelyek formázó attribútumokat tartalmaznak. Az {{OOo}} összes alkalmazásában megtalálhatók, és segítségükkel jelentősen egyszerűbbé válik a formázás. Ha a felhasználó módosítja egy sablon egyik attribútumát, az {{OOo}} automatikusan módosítja az összes dokumentumrészt, amely azon a sablonon alapul. Így például a felhasználó módosíthatja a dokumentum összes első szintű fejlécének betűtípusát egyetlen módosítással. Az adott dokumentumtípusoktól függően az {{OOo}} a sablonok számos típusát képes kezelni.

Az {{OOo}} Writer a következő sablonokat támogatja:

* karaktersablonok
* bekezdéssablonok
* keretsablonok
* oldalsablonok
* számozási sablonok

Az {{OOo}} Calc a következő sablonokat támogatja:

* cellasablonok
* oldalsablonok

Az {{OOo}} Impress a következő sablonokat támogatja:

* karakterelem-sablonok
* bemutatósablonok

Az {{OOo}} terminológiájában a sablonok különböző típusának elnevezése <tt>StyleFamilies</tt> (stíluscsaládok) a <idl>com.sun.star.style.StyleFamily</idl> szolgáltatásnak megfelelően, amelyen alapulnak. A <tt>StyleFamilies</tt> a dokumentumobjektumon keresztül érhető el:

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object
Dim StyleFamilies As Object
Dim CellStyles As Object

Doc = StarDesktop.CurrentComponent
StyleFamilies = Doc.StyleFamilies
CellStyles = StyleFamilies.getByName("CellStyles")
</source>

Ez a példa egy munkafüzet-dokumentum <tt>StyleFamilies</tt> tulajdonságát használja az összes elérhető cellasablon listájának létrehozásához.

Az egyes sablonok egy index használatával érhetők el közvetlenül:

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object
Dim StyleFamilies As Object
Dim CellStyles As Object
Dim CellStyle As Object
Dim I As Integer

Doc = StarDesktop.CurrentComponent
StyleFamilies = Doc.StyleFamilies
CellStyles = StyleFamilies.getByName("CellStyles")

For I = 0 To CellStyles.Count - 1
CellStyle = CellStyles(I)
MsgBox CellStyle.Name
Next I
</source>

A ciklus azért van hozzáadva, mert a példaprogram megjeleníti az összes cellasablon nevét egymás után egy üzenetablakban.

== Információk a különböző formázási lehetőségekről ==

Az összes sablon számos formázási tulajdonsággal rendelkezik. Az alábbiakban látható egy áttekintés a legfontosabb formázási tulajdonságokról és azok magyarázatának helyéről:

* [[HU/Documentation/BASIC Guide/Structure of Text Documents#Character Properties|Szövegtulajdonságok]], <idl>com.sun.star.style.CharacterProperties</idl> szolgáltatás
* [[HU/Documentation/BASIC Guide/Structure of Text Documents#Paragraph Properties|Bekezdéstulajdonságok]], <idl>com.sun.star.text.Paragraph</idl> szolgáltatás
* [[HU/Documentation/BASIC Guide/Formatting Spreadsheet Documents#Cell Properties|Cellatulajdonságok]], <idl>com.sun.star.table.CellProperties</idl> szolgáltatás
* [[HU/Documentation/BASIC Guide/Formatting Spreadsheet Documents#Page Properties|Oldaltulajdonságok]], <idl>com.sun.star.style.PageProperties</idl> szolgáltatás
* [[HU/Documentation/BASIC Guide/Formatting Spreadsheet Documents|Karakterelem-tulajdonságok]], különféle szolgáltatások

A formázási tulajdonságok nem korlátozódnak azokra az alkalmazásokra, ahol ismertetésre kerülnek, hanem univerzálisan használhatók. Például az oldaltulajdonságok legtöbbje a [[HU/Documentation/BASIC Guide/Spreadsheets|Munkafüzet-dokumentumok]] című fejezetben van ismertetve, de nem csak az {{OOo}} Calc programban, hanem az {{OOo}} Writerben is használhatók.

A sablonokkal végzett munkáról bővebb információ a [[HU/Documentation/BASIC Guide/Text Documents|Szöveges dokumentumok]]című fejezetben található, a [[Documentation/BASIC_Guide/Structure_of_Text_Documents#Default values for character and paragraph properties|'''A karakter- és bekezdéstulajdonságok alapértelmezett értékei''']] című részben.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Templates}}
{{PDL1}}

HU/Documentation/BASIC Guide/Structure of Text Documents

2009-05-15T14:41:31Z

Timarandras: New page: {{HU/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=HU/Documentation/BASIC Guide/Text Documents |NextPage=HU/Documentation/BASIC Guide/Editing Text Docume...

{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Text Documents
|NextPage=HU/Documentation/BASIC Guide/Editing Text Documents
|textdocs=block
}}
{{DISPLAYTITLE:A szöveges dokumentumok felépítése}}
Egy szöveges dokumentum lényegében négyféle típusú információt tartalmazhat:

* magát a szöveget;
* sablonokat a karakterek, bekezdések és oldalak formázásához;
* nem szöveges elemeket, például táblázatokat, ábrákat és rajzobjektumokat;
* a szöveges dokumentum globális beállításait.

Ez a szakasz főleg a szöveg- és a hozzá tartozó formázási lehetőségekkel foglalkozik.

== Bekezdések és bekezdésrészek ==

A szöveges dokumentum alapja a bekezdések sorozatából áll. Ezek nincsenek elnevezve vagy indexelve, ezért nincs lehetőség az egyes bekezdések egyenkénti elérésére. Ennek ellenére a bekezdéseken végig lehet lépdelni az <tt>Enumeration</tt> objektum használatával a [[HU/Documentation/BASIC Guide/API Intro|Bevezetés az API használatába]]című fejezetben ismertetett módon. Ez lehetővé teszi a bekezdések szerkesztését.

Az <tt>Enumeration</tt> objektummal végzett munka során azonban figyelnünk kell egy speciális helyzetre: nem csak a bekezdéseket adja vissza, hanem a táblázatokat is (szigorúan véve az {{OOo}} Writerben a táblázat is egy speciális bekezdés). Ezért, mielőtt dolgozni kezdenénk a visszaadott objektummal, ellenőriznünk kell, hogy az a <idl>com.sun.star.text.Paragraph</idl> szolgáltatást támogatja a bekezdések számára, vagy a <idl>com.sun.star.text.TextTable</idl> szolgáltatást a táblázatok számára.

A következő példa végiglépdel egy szöveges dokumentum tartalmán egy ciklusban, és minden objektumról egy üzenetben kiírja, hogy az táblázat vagy bekezdés.

<source lang="oobas">
Dim Doc As Object
Dim Enum As Object
Dim TextElement As Object

' Dokumentumobjektum létrehozása
Doc = StarDesktop.CurrentComponent
' Enumerációobjektum létrehozása
Enum = Doc.Text.createEnumeration
' ciklus végig a szöveges elemeken

While Enum.hasMoreElements
TextElement = Enum.nextElement

If TextElement.supportsService("com.sun.star.text.TextTable") Then
MsgBox "A jelenlegi blokk egy táblázatot tartalmaz."
End If

If TextElement.supportsService("com.sun.star.text.Paragraph") Then
MsgBox "A jelenlegi blokk egy bekezdést tartalmaz."
End If

Wend
</source>

Ez a példa létrehoz egy <tt>Doc</tt> nevű dokumentumobjektumot, amely az aktuális {{OOo}}-dokumentumra hivatkozik. A <tt>Doc</tt> objektum segítségével a program létrehoz egy <tt>Enumeration</tt> nevű objektumot, amely végiglépdel a szöveg egyes részein (bekezdéseken és táblázatokon), és hozzárendeli az adott elemet a <tt>TextElement</tt> objektumhoz. A példa a <tt>supportsService</tt> metódust használja annak megállapítására, hogy a <tt>TextElement</tt> objektum bekezdés vagy táblázat.

=== Bekezdések ===

A <idl>com.sun.star.text.Paragraph</idl> szolgáltatás hozzáférést biztosít a bekezdés tatalmához. A bekezdés szövege String tulajdonság használatával olvasható be és módosítható:

<source lang="oobas">
Dim Doc As Object
Dim Enum As Object
Dim TextElement As Object

Doc = StarDesktop.CurrentComponent
Enum = Doc.Text.createEnumeration

While Enum.hasMoreElements
TextElement = Enum.nextElement

If TextElement.supportsService("com.sun.star.text.Paragraph") Then
TextElement.String = Replace(TextElement.String, "úgynevezett", "ún.")
TextElement.String = Replace(TextElement.String, "satöbbi", "stb.")
TextElement.String = Replace(TextElement.String, "Tisztelt", "T.")
End If

Wend
</source>

Ez a példa megnyitja az aktuális szövegdokumentumot, és végiglépdel rajta az Enumeration objektum segítségével. A <tt>TextElement.String</tt> tulajdonság segítségével hozzáfér a bekezdések szövegéhez, és lecseréli az <tt>úgynevezett, satöbbi és Tisztelt</tt> szót az <tt>ún., stb. és T.</tt> rövidítésre. A cserére használt <tt>Replace</tt> függvény nem része az {{OOo}} Basic nyelvnek. Ez a [[HU/Documentation/BASIC Guide/Strings_%28Runtime_Library%29|Keresés és csere]] fejezetben leírt példafüggvény egy példánya.

{{Documentation/Note|Az itt ismertetett, szöveg bekezdéseihez való hozzáférést biztosító eljárás tartalma hasonló a VBA-ban használt Paragraphs listához, amely az ott rendelkezésre álló <tt>Range</tt> és <tt>Document</tt> objektumon keresztül érhető el. Míg a VBA-ban a bekezdésekhez a számuk alapján lehet hozzáférni (például a <tt>Paragraph(1)</tt> függvénnyel), az {{OOo}} Basicben az előbbiekben ismertetett <tt>Enumeration</tt> objektumot kell használni. }}

Az {{OOo}} Basicben nincs közvetlen megfelelője a VBA-ban rendelkezésre álló <tt>Characters</tt>, <tt>Sentences</tt> és <tt>Words</tt> listáknak. Viszont megvan a lehetőségünk, hogy átváltsunk egy <tt>TextCursor</tt> objektumra, amellyel lehetővé válik a karakter-, szó- és mondatszintű navigáció.

=== Bekezdésrészek ===

Lehet, hogy az előző példa megfelelően lecseréli a szöveget, de néha előfordulhat, hogy elrontja a formázást.

Ez azért fordulhat elő, mert egy bekezdés különálló alobjektumokból áll. Ezek mindegyike saját formázási információkat tartalmaz. Ha például a bekezdés közepe egy félkövér szót tartalmaz, akkor ez az {{OOo}} programban három bekezdésrészként fog megjelenni: a félkövér betűtípus előtti rész, majd a félkövér szó, és végül a félkövér betűtípus utáni rész, amely normálként ismét jelenik meg.

Ha most a bekezdés szövegét módosítjuk a bekezdés <tt>String</tt> tulajdonságával, akkor az {{OOo}} először törli a régi bekezdésrészeket, majd egy új bekezdésrészt szúr be. Az eredeti rész formázása ezután el fog tűnni.

Ha meg akarjuk tartani a formázást, elérhetjük az adott bekezdésrészeket is a teljes bekezdése helyett. A bekezdések rendelkeznek saját <tt>Enumeration</tt> objektummal ebből a célból. A következő példa egy dupla ciklust mutat be, amely végiglépdel a szöveges dokumentum összes bekezdésén és azok bekezdésrészein, majd alkalmazza az előző példában megismert cseréket:

<source lang="oobas">
Dim Doc As Object
Dim Enum1 As Object
Dim Enum2 As Object
Dim TextElement As Object
Dim TextPortion As Object

Doc = StarDesktop.CurrentComponent
Enum1 = Doc.Text.createEnumeration

' a ciklus végiglépdel az összes bekezdésen
While Enum1.hasMoreElements
TextElement = Enum1.nextElement

If TextElement.supportsService("com.sun.star.text.Paragraph") Then
Enum2 = TextElement.createEnumeration
' a ciklus végiglépdel az összes bekezdésrészen

While Enum2.hasMoreElements
TextPortion = Enum2.nextElement
MsgBox "'" & TextPortion.String & "'"
TextPortion.String = Replace(TextPortion.String, "úgynevezett", "ún.")
TextPortion.String = Replace(TextPortion.String, "satöbbi", "stb.")
TextPortion.String = Replace(TextPortion.String, "satöbbi", "stb.")
Wend

End If
Wend
</source>

A példa egy kettős ciklussal lépdel végig a szöveges dokumentumon. A külső ciklus a szöveg bekezdésein lépdel végig. A belső ciklus ezeknek a bekezdéseknek a részeit dolgozza fel. A példában bemutatott kód módosítja a bekezdésrészek tartalmát a bekezdésrész <tt>String</tt> tulajdonságának használatával, akárcsak az előző példa a bekezdésekkel. Viszont mivel itt közvetlenül a bekezdésrészeket módosítja a program, így a formázásuk megmarad a szöveg cseréje után.

=== Formázás ===

A szöveget többféleképpen formázhatjuk. A legegyszerűbb mód, ha a formázási tulajdonságokat közvetlenül egy szövegrészhez rendeljük. Ezt hívják közvetlen formázásnak. A közvetlen formázás főleg a rövid szövegeknél használatos, mert ott a felhasználó az egérrel el tudja végezni a formázást. Például kiemelhetünk egy szót a szövegen belül a félkövér betűtípussal, vagy középre igazíthatunk egy vonalat.

A közvetlen formázás mellett, formázhatjuk a szöveget sablonok használatával is. Ezt hívják közvetett formázásnak. A közvetett formázásnál egy előre definiált sablont rendelünk az adott szövegrészhez. Ha a szöveg megjelenését később módosítani kell, csak a sablont kell módosítanunk, az {{OOo}} ezután módosítja az összes olyan szövegrész megjelenését, amely ezt a sablont használja.

{{Documentation/Note|A VBA-ban egy objektum formázási tulajdonságai általában több alobjektum között oszlanak szét (például <tt>Range.Font</tt>, <tt>Range.Borders</tt>, <tt>Range.Shading</tt> és <tt>Range.ParagraphFormat</tt>). A tulajdonságokat kaszkádolt kifejezések formájában lehet elérni (például <tt>Range.Font.AllCaps</tt>). Ezzel szemben az {{OOo}} Basicben a formázási tulajdonságok közvetlenül, a megfelelő objektumok használatával érhetők el (<tt>TextCursor, Paragraph</tt> stb.). A következő két szakasz áttekintést nyújt az {{OOo}} program karakter- és bekezdéstulajdonságairól.}}

{{Documentation/Note|A formázási tulajdonságok megtalálhatók minden objektumban (<tt>Paragraph</tt>, <tt>TextCursor</tt> stb.), és közvetlenül alkalmazhatók.}}

=== Karaktertulajdonságok ===

Azokat a formázási tulajdonságokat, amelyek az egyes karakterekre vonatkoznak, karaktertulajdonságoknak nevezik. Ezek magukban foglalják a félkövér típust és a betűtípust. Az olyan objektumoknak, amelyek lehetővé teszik a karaktertulajdonságok beállítását, támogatniuk kell a <idl>com.sun.star.style.CharacterProperties</idl> szolgáltatást. A szolgáltatások széles skáláját felismeri, amelyek támogatják ezt a szolgáltatást. Ezek közé tartozik az előzőekben ismertetett, bekezdésekhez használható <idl>com.sun.star.text.Paragraph</idl> szolgáltatásai és a bekezdésrészekhez használható <idl>com.sun.star.text.TextPortion</idl> szolgáltatásai.

A <idl>com.sun.star.style.CharacterProperties</idl> szolgáltatás nem nyújt semmilyen felületet, csak tulajdonságokat, amelyeken keresztül a karaktertulajdonságok megadhatók és meghívhatók. A karaktertulajdonságok teljes listája megtalálható az {{OOo}} API-referenciában. A következő lista ismerteti a legfontosabb tulajdonságokat:

;<tt>CharFontName (karakterlánc)</tt>:a kijelölt betűtípus neve.
;<tt>CharColor (hosszú egész szám)</tt>:a szöveg színe.
;<tt>CharHeight (lebegőpontos érték)</tt>:a karaktermagasság pontban (pt) megadva.
;<tt>CharUnderline (állandócsoport)</tt>:az aláhúzás típusa (a <idl>com.sun.star.awt.FontUnderline</idl> tulajdonságnak megfelelő állandók).
;<tt>CharWeight (állandócsoport)</tt>:a betűsúly (a <idl>com.sun.star.awt.FontWeight</idl> tulajdonságnak megfelelő állandók).
;<tt>CharBackColor (hosszú egész szám)</tt>:a háttérszín.
;<tt>CharKeepTogether (logikai érték)</tt>:az automatikus sortörés kikapcsolása.
;<tt>CharStyleName (karakterlánc)</tt>:a karaktersablon neve.

=== Bekezdéstulajdonságok ===

Az olyan formázási tulajdonságok, amelyek nem az egyes karakterekre vonatkoznak, hanem a teljes bekezdésre, azok a bekezdéstulajdonságok. Ezek magukban foglalják a bekezdés távolságát az oldal szélétől, valamint sortávolságot is. A bekezdéstulajdonságok a <idl>com.sun.star.style.ParagraphProperties</idl> szolgáltatáson keresztül érhetők el.

A bekezdéstulajdonságok is számos objektumban elérhetők. Minden olyan objektum, amely támogatja a <idl>com.sun.star.text.Paragraph</idl> szolgáltatást, támogatja a <idl>com.sun.star.style.ParagraphProperties</idl> objektumban megtalálható tulajdonságokat is.

A bekezdéstulajdonságok teljes listája megtalálható az {{OOo}} API-referenciában. A leggyakrabban használt bekezdéstulajdonságok a következők:

;<tt>ParaAdjust (enumeráció)</tt>:szöveg függőleges tájolása (a <idl>com.sun.star.style.ParagraphAdjust</idl> objektumnak megfelelő állandók).
;<tt>ParaLineSpacing (struktúra)</tt>:sortávolság (a <idl>com.sun.star.style.LineSpacing</idl> tulajdonságnak megfelelő struktúra).
;<tt>ParaBackColor (hosszú egész szám)</tt>:a háttérszín.
;<tt>ParaLeftMargin (hosszú egész szám)</tt>:bal margó századmilliméterben.
;<tt>ParaRightMargin (hosszú egész szám)</tt>:jobb margó századmilliméterben.
;<tt>ParaTopMargin (hosszú egész szám)</tt>:felső margó századmilliméterben.
;<tt>ParaBottomMargin (hosszú egész szám)</tt>:alsó margó századmilliméterben.
;<tt>ParaTabStops (struktúratömb)</tt>:a tabulátorok típusa és helye (<idl>com.sun.star.style.TabStop</idl> típusú struktúrák tömbje).
;<tt>ParaStyleName (karakterlánc)</tt>:a bekezdéssablon neve.

=== Példa: egyszerű HTML-exportálás ===

A következő példa bemutatja a formázási információkkal végzett munkát. Végig lépked egy szöveges dokumentumon, és létrehoz egy egyszerű HTML-fájlt. Minden bekezdést a <tt><nowiki></nowiki></tt> HTML-parancs jelöl. A félkövér bekezdésrészeket a <tt><nowiki></nowiki></tt> HTML-parancs jelöli exportáláskor.

<source lang="oobas">
Dim FileNo As Integer, Filename As String, CurLine As String
Dim Doc As Object
Dim Enum1 As Object, Enum2 As Object
Dim TextElement As Object, TextPortion As Object

Filename = "c:\text.html"
FileNo = FreeFile
Open Filename For Output As #FileNo
Print #FileNo, "<HTML><BODY>"
Doc = StarDesktop.CurrentComponent
Enum1 = Doc.Text.createEnumeration

' a ciklus végiglépdel az összes bekezdésen
While Enum1.hasMoreElements
TextElement = Enum1.nextElement

If TextElement.supportsService("com.sun.star.text.Paragraph") Then
Enum2 = TextElement.createEnumeration
CurLine = ""

' a ciklus végiglépdel az összes bekezdésrészen
While Enum2.hasMoreElements
TextPortion = Enum2.nextElement

If TextPortion.CharWeight = com.sun.star.awt.FontWeight.BOLD THEN
CurLine = CurLine & "" & TextPortion.String & ""
Else
CurLine = CurLine & TextPortion.String
End If

Wend

' sor kiírása
CurLine = CurLine & ""
Print #FileNo, CurLine
End If

Wend

' HTML-lábléc kiírása
Print #FileNo, "</BODY></HTML>"
Close #FileNo
</source>

A példa alapja az előzőekben bemutatott módszerhez hasonló, amikor a program végiglépked a szöveg bekezdésrészein. Ehhez a kódhoz lett hozzáadva a HTML-fájl írására szolgáló kód és a bekezdésrészletek betűsúlyát megvizsgáló kód, amely a félkövér bekezdésrészeket ellátja a szükséges HTML-paranccsal.

=== A karakter- és bekezdéstulajdonságok alapértelmezett értékei ===

A '''közvetlen''' formázás mindig elsőbbséget élvez a '''közvetett''' formázással szemben. Más szóval a sablonokat használó formázás hozzárendelése kisebb prioritású, mint a közvetlen formázásé.

Annak megállapítása, hogy egy adott dokumentumszakasz közvetlenül vagy közvetetten van formázva, nem egyszerű. Az {{OOo}} eszköztárán láthatók a leggyakoribb szövegtulajdonságok, mint például a betűtípus, -súly és –méret. De az, hogy az adott beállítások sablonokon vagy közvetlen formázáson alapulnak ebből nem látható.

Az {{OOo}} Basic rendelkezik egy <tt>getPropertyState</tt> metódussal, amellyel a programozó meg tudja állapítani, egy adott tulajdonság hogyan van formázva. A metódusnak paraméterként a tulajdonság nevét kell megadni, és visszaad egy állandót, amely információt nyújt a formázás eredetéről. A következő, <idl>com.sun.star.beans.PropertyState</idl> enumerációjában megadott visszatérési értékek lehetségesek:

;<idl>com.sun.star.beans.PropertyState.DIRECT_VALUE</idl>:a tulajdonság közvetlenül a szövegben van megadva (közvetlen formázás);
;<idl>com.sun.star.beans.PropertyState.DEFAULT_VALUE</idl>:a tulajdonságot egy sablon formázza (közvetett formázás);
;<idl>com.sun.star.beans.PropertyState.AMBIGUOUS_VALUE</idl>:a tulajdonság formázása nem egyértelmű. Ez akkor lehetséges, ha például beolvassuk egy bekezdés félkövér-tulajdonságát, amely félkövér és normál szavakat is tartalmaz.

A következő példa bemutatja, hogyan szerkeszthetők a formázási tulajdonságok az {{OOo}} programban. A program megkeresi a szövegben a félkövérként megjelenő bekezdésrészleteket, amelyeket közvetlen formázással formáztak. Ha talál ilyen bekezdésrészletet, akkor törli a közvetlen formázást a <tt>setPropertyToDefault</tt> metódussal, és hozzárendeli a <tt>Félkövér</tt> karaktersablont az adott bekezdésrészhez.

<source lang="oobas">
Dim Doc As Object
Dim Enum1 As Object
Dim Enum2 As Object
Dim TextElement As Object
Dim TextPortion As Object

Doc = StarDesktop.CurrentComponent
Enum1 = Doc.Text.createEnumeration

' a ciklus végiglépdel az összes bekezdésen
While Enum1.hasMoreElements
TextElement = Enum1.nextElement

If TextElement.supportsService("com.sun.star.text.Paragraph") Then
Enum2 = TextElement.createEnumeration
' a ciklus végiglépdel az összes bekezdésrészen

While Enum2.hasMoreElements
TextPortion = Enum2.nextElement

If TextPortion.CharWeight = _
com.sun.star.awt.FontWeight.BOLD AND _
TextPortion.getPropertyState("CharWeight") = _
com.sun.star.beans.PropertyState.DIRECT_VALUE Then
TextPortion.setPropertyToDefault("CharWeight")
TextPortion.CharStyleName = "Félkövér"
End If
Wend
End If
Wend
</source>

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Structure of Text Documents}}
{{PDL1}}

HU/Documentation/BASIC Guide/Structure of Spreadsheets

2009-05-15T14:41:16Z

Timarandras: /* Munkalapok létrehozása, törlése és átnevezése */

{{DISPLAYTITLE:A munkafüzet-dokumentumok felépítése}}
{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Spreadsheets
|NextPage=HU/Documentation/BASIC Guide/Rows and Columns
|spread=block
}}

A munkafüzet dokumentumobjektuma a <idl>com.sun.star.sheet.SpreadsheetDocument</idl> szolgáltatáson alapul. A dokumentumok mindegyike több munkafüzetet is tartalmazhat. Ebben az útmutatóban a táblázat alapú dokumentum vagy munkafüzet-dokumentum a teljes dokumentum, míg a munkalap egy lapja (táblázata) a dokumentumnak.

{{Documentation/Note|A VBA és az {{OOo}} Basic eltérő neveket használ az egyes objektumok megnevezésére. Míg a dokumentumobjektum neve VBA-ban Workbook és az egyes lapjai a Worksheet objektumok, addig az {{OOo}} Basicben SpreadsheetDocument objektumnak és Sheet objektumnak hívják ugyanazt.}}

== Munkafüzetek ==

A munkafüzet-dokumentum egyes munkalapjait a <tt>Sheets</tt> listával érhetjük el.

Az alábbi példa bemutatja, hogyan érhető el egy munkalap a száma vagy neve alapján.

'''1. példa: hozzáférés szám alapján (a számozás 0-nál kezdődik)'''

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object

Doc = ThisComponent
Sheet = Doc.Sheets(0)
</source>

{{Documentation/Note|A <tt>ThisComponent</tt> az utoljára aktív dokumentumot adja vissza.}}

'''2. példa: hozzáférés név alapján'''

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object

Doc = ThisComponent
Sheet = Doc.Sheets.getByName("Sheet 1")
</source>

Az első példában a munkalapot a száma alapján éri el a program (a számozás 0-nál kezdődik). A második példában pedig a neve alapján, a <tt>getByName</tt> metódus használatával.

A <tt>getByName</tt> metódus által visszaadott <tt>Sheet</tt> objektum a <idl>com.sun.star.sheet.Spreadsheet</idl> szolgáltatást támogatja. A tartalom szerkesztéséhez használt számos felületen kívül ez a szolgáltatás a következő tulajdonságokat biztosítja:

;<tt>IsVisible (logikai érték)</tt>:a munkafüzet látható.
;<tt>PageStyle (karakterlánc)</tt>:a munkafüzet oldalsablonjának neve.

=== Munkalapok létrehozása, törlése és átnevezése ===

A <tt>munkafüzet-objektum</tt> <tt>Sheets</tt> listája szintén használható az egyes munkalapok létrehozásához, törléséhez és átnevezéséhez. A következő példa a <tt>hasByName</tt> metódussal ellenőrzi, hogy létezik-e egy '''SajátMunkalap''' nevű munkalap. Ha létezik, a metódus létrehozza a megfelelő objektumhivatkozást a <tt>getByName</tt> metódus használatával, és menti a hivatkozást a <tt>Sheet</tt> nevű változóba. Ha az adott munkalap nem létezik, a <tt>createInstance</tt> metódus létrehozza azt, és az <tt>insertByName</tt> beszúrja a munkafüzet-objektumba.

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object

Doc = ThisComponent
Sheet = Doc.Sheets(0)

If Doc.Sheets.hasByName("SajátMunkalap") Then
Sheet = Doc.Sheets.getByName("SajátMunkalap")
Else
Sheet = Doc.createInstance("com.sun.star.sheet.Spreadsheet")
Doc.Sheets.insertByName("SajátMunkalap", Sheet)
End If
</source>

The A <tt>getByName</tt> és az <tt>insertByName</tt> metódust a <idl>com.sun.star.container.XnameContainer</idl> felület tartalmazza. Ezek leírását [[HU/Documentation/BASIC Guide/API Intro|A StarOffice API bemutatása]] fejezetben találjuk.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Structure of Spreadsheets}}
{{PDL1}}

HU/Documentation/BASIC Guide/Structure of Spreadsheets

2009-05-15T14:40:59Z

Timarandras: /* Munkalapok létrehozása, törlése és átnevezése */

{{DISPLAYTITLE:A munkafüzet-dokumentumok felépítése}}
{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Spreadsheets
|NextPage=HU/Documentation/BASIC Guide/Rows and Columns
|spread=block
}}

A munkafüzet dokumentumobjektuma a <idl>com.sun.star.sheet.SpreadsheetDocument</idl> szolgáltatáson alapul. A dokumentumok mindegyike több munkafüzetet is tartalmazhat. Ebben az útmutatóban a táblázat alapú dokumentum vagy munkafüzet-dokumentum a teljes dokumentum, míg a munkalap egy lapja (táblázata) a dokumentumnak.

{{Documentation/Note|A VBA és az {{OOo}} Basic eltérő neveket használ az egyes objektumok megnevezésére. Míg a dokumentumobjektum neve VBA-ban Workbook és az egyes lapjai a Worksheet objektumok, addig az {{OOo}} Basicben SpreadsheetDocument objektumnak és Sheet objektumnak hívják ugyanazt.}}

== Munkafüzetek ==

A munkafüzet-dokumentum egyes munkalapjait a <tt>Sheets</tt> listával érhetjük el.

Az alábbi példa bemutatja, hogyan érhető el egy munkalap a száma vagy neve alapján.

'''1. példa: hozzáférés szám alapján (a számozás 0-nál kezdődik)'''

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object

Doc = ThisComponent
Sheet = Doc.Sheets(0)
</source>

{{Documentation/Note|A <tt>ThisComponent</tt> az utoljára aktív dokumentumot adja vissza.}}

'''2. példa: hozzáférés név alapján'''

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object

Doc = ThisComponent
Sheet = Doc.Sheets.getByName("Sheet 1")
</source>

Az első példában a munkalapot a száma alapján éri el a program (a számozás 0-nál kezdődik). A második példában pedig a neve alapján, a <tt>getByName</tt> metódus használatával.

A <tt>getByName</tt> metódus által visszaadott <tt>Sheet</tt> objektum a <idl>com.sun.star.sheet.Spreadsheet</idl> szolgáltatást támogatja. A tartalom szerkesztéséhez használt számos felületen kívül ez a szolgáltatás a következő tulajdonságokat biztosítja:

;<tt>IsVisible (logikai érték)</tt>:a munkafüzet látható.
;<tt>PageStyle (karakterlánc)</tt>:a munkafüzet oldalsablonjának neve.

=== Munkalapok létrehozása, törlése és átnevezése ===

A <tt>munkafüzet-objektum</tt> <tt>Sheets</tt> listája szintén használható az egyes munkalapok létrehozásához, törléséhez és átnevezéséhez. A következő példa a <tt>hasByName</tt> metódussal ellenőrzi, hogy létezik-e egy '''SajátMunkalap''' nevű munkalap. Ha létezik, a metódus létrehozza a megfelelő objektumhivatkozást a <tt>getByName</tt> metódus használatával, és menti a hivatkozást a <tt>Sheet</tt> nevű változóba. Ha az adott munkalap nem létezik, a <tt>createInstance</tt> metódus létrehozza azt, és az <tt>insertByName</tt> beszúrja a munkafüzet-objektumba.

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object

Doc = ThisComponent
Sheet = Doc.Sheets(0)

If Doc.Sheets.hasByName("SajátMunkalap") Then
Sheet = Doc.Sheets.getByName("SajátMunkalap")
Else
Sheet = Doc.createInstance("com.sun.star.sheet.Spreadsheet")
Doc.Sheets.insertByName("SajátMunkalap", Sheet)
End If
</source>

The A <tt>getByName</tt> és az <tt>insertByName</tt> metódust a <idl>com.sun.star.container.XnameContainer</idl> felület tartalmazza. Ezek leírását a [[HU/Documentation/BASIC Guide/API Intro|A StarOffice API bemutatása]] fejezetben találjuk.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Structure of Spreadsheets}}
{{PDL1}}

HU/Documentation/BASIC Guide/Structure of Spreadsheets

2009-05-15T14:40:19Z

Timarandras: New page: {{DISPLAYTITLE:A munkafüzet-dokumentumok felépítése}} {{HU/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=HU/Documentation/BASIC Guide/Spreadsheets |N...

{{DISPLAYTITLE:A munkafüzet-dokumentumok felépítése}}
{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Spreadsheets
|NextPage=HU/Documentation/BASIC Guide/Rows and Columns
|spread=block
}}

A munkafüzet dokumentumobjektuma a <idl>com.sun.star.sheet.SpreadsheetDocument</idl> szolgáltatáson alapul. A dokumentumok mindegyike több munkafüzetet is tartalmazhat. Ebben az útmutatóban a táblázat alapú dokumentum vagy munkafüzet-dokumentum a teljes dokumentum, míg a munkalap egy lapja (táblázata) a dokumentumnak.

{{Documentation/Note|A VBA és az {{OOo}} Basic eltérő neveket használ az egyes objektumok megnevezésére. Míg a dokumentumobjektum neve VBA-ban Workbook és az egyes lapjai a Worksheet objektumok, addig az {{OOo}} Basicben SpreadsheetDocument objektumnak és Sheet objektumnak hívják ugyanazt.}}

== Munkafüzetek ==

A munkafüzet-dokumentum egyes munkalapjait a <tt>Sheets</tt> listával érhetjük el.

Az alábbi példa bemutatja, hogyan érhető el egy munkalap a száma vagy neve alapján.

'''1. példa: hozzáférés szám alapján (a számozás 0-nál kezdődik)'''

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object

Doc = ThisComponent
Sheet = Doc.Sheets(0)
</source>

{{Documentation/Note|A <tt>ThisComponent</tt> az utoljára aktív dokumentumot adja vissza.}}

'''2. példa: hozzáférés név alapján'''

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object

Doc = ThisComponent
Sheet = Doc.Sheets.getByName("Sheet 1")
</source>

Az első példában a munkalapot a száma alapján éri el a program (a számozás 0-nál kezdődik). A második példában pedig a neve alapján, a <tt>getByName</tt> metódus használatával.

A <tt>getByName</tt> metódus által visszaadott <tt>Sheet</tt> objektum a <idl>com.sun.star.sheet.Spreadsheet</idl> szolgáltatást támogatja. A tartalom szerkesztéséhez használt számos felületen kívül ez a szolgáltatás a következő tulajdonságokat biztosítja:

;<tt>IsVisible (logikai érték)</tt>:a munkafüzet látható.
;<tt>PageStyle (karakterlánc)</tt>:a munkafüzet oldalsablonjának neve.

=== Munkalapok létrehozása, törlése és átnevezése ===

A <tt>munkafüzet-objektum</tt> <tt>Sheets</tt> listája szintén használható az egyes munkalapok létrehozásához, törléséhez és átnevezéséhez. A következő példa a <tt>hasByName</tt> metódussal ellenőrzi, hogy létezik-e egy '''SajátMunkalap''' nevű munkalap. Ha létezik, a metódus létrehozza a megfelelő objektumhivatkozást a <tt>getByName</tt> metódus használatával, és menti a hivatkozást a <tt>Sheet</tt> nevű változóba. Ha az adott munkalap nem létezik, a <tt>createInstance</tt> metódus létrehozza azt, és az <tt>insertByName</tt> beszúrja a munkafüzet-objektumba.

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object

Doc = ThisComponent
Sheet = Doc.Sheets(0)

If Doc.Sheets.hasByName("SajátMunkalap") Then
Sheet = Doc.Sheets.getByName("SajátMunkalap")
Else
Sheet = Doc.createInstance("com.sun.star.sheet.Spreadsheet")
Doc.Sheets.insertByName("SajátMunkalap", Sheet)
End If
</source>

The A <tt>getByName</tt> és az <tt>insertByName</tt> metódust a <idl>com.sun.star.container.XnameContainer</idl> felület tartalmazza. Ezek leírását a következő helyen találjuk [[HU/Documentation/BASIC Guide/API Intro|A StarOffice API bemutatása]].

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Structure of Spreadsheets}}
{{PDL1}}

HU/Documentation/BASIC Guide/Structure of Drawings

2009-05-15T14:39:59Z

Timarandras: New page: {{HU/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=HU/Documentation/BASIC Guide/Drawings Presentations |NextPage=HU/Documentation/BASIC Guide/Editing Dra...

{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Drawings Presentations
|NextPage=HU/Documentation/BASIC Guide/Editing Drawing Objects
|draw=block
}}
{{DISPLAYTITLE:A rajzok felépítése}}
__NOTOC__
Az {{OOo}} nem korlátozza az oldalak számát egy rajzdokumentumban. Minden oldalt külön készíthetünk el. Szintén nincs korlátozás az egy oldalon szereplő rajzelemek számában.

== Oldalak ==

A rajzdokumentum oldalai a <tt>DrawPages</tt> listán keresztül érhetők el. Az egyes oldalak a nevük vagy számuk alapján érhető el. Ha a dokumentumban egy oldal van, és ennek neve '''Dia 1''', akkor a következő példák azonosak.

'''1. példa:'''

<source lang="oobas">
Dim Doc As Object
Dim Page As Object

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)
</source>

'''2. példa:'''

<source lang="oobas">
Dim Doc As Object
Dim Page As Object

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages.getByName("Dia 1")
</source>

Az 1. példában az oldalt a száma alapján éri el a program (a számozás 0-nál kezdődik). A második példában pedig a neve alapján, a <tt>getByName</tt> metódus használatával.

<source lang="oobas">
Dim sUrl As String, sFilter As String
Dim sOptions As String
Dim oSheets As Object, oSheet As Object

oSheets = oDocument.Sheets

If oSheets.hasByName("Link") Then
oSheet = oSheets.getByName("Link")
Else
oSheet = oDocument.createInstance("com.sun.star.sheet.Spreadsheet")
oSheets.insertByName("Link", oSheet)
oSheet.IsVisible = False
End If
</source>

Az előző példa egy olyan oldalobjektumot ad vissza, mely támogatja a <tt>com.sun.star.drawing.DrawPage</tt> szolgáltatást. A szolgáltatás a következő tulajdonságokkal rendelkezik:

;<tt>BorderLeft (hosszú egész)</tt>:a bal oldali keret századmilliméterben.
;<tt>BorderRight (hosszú egész)</tt>:a jobb oldali keret századmilliméterben.
;<tt>BorderTop (hosszú egész)</tt>:a felső keret századmilliméterben.
;<tt>BorderBottom (hosszú egész)</tt>:az alsó keret századmilliméterben.
;<tt>Width (hosszú egész)</tt>:az oldal szélessége századmilliméterben.
;<tt>Height (hosszú egész)</tt>:az oldal magassága századmilliméterben.
;<tt>Number (rövid egész)</tt>:oldalak száma (a számozás 1-től kezdődik), csak olvasható.
;<tt>Orientation (enumeráció)</tt>:az oldal tájolása (a <tt>com.sun.star.view.PaperOrientation</tt> enumerációnak megfelelően).

Ha ezeket a beállításokat módosítjuk, akkor az hatással lesz a dokumentum '''összes''' oldalára.

A következő példa a megnyitott rajzdokumentum oldalméretét 20 x 20 centiméterre állítja, az oldalmargót pedig 0,5 centiméterre:

<source lang="oobas">
Dim Doc As Object
Dim Page As Object

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

Page.BorderLeft = 500
Page.BorderRight = 500
Page.BorderTop = 500
Page.BorderBottom = 500

Page.Width = 20000
Page.Height = 20000
</source>

== A rajzobjektumok alapvető tulajdonságai ==

A rajzobjektumok magukban foglalják az alakzat- (négyszögek, körök stb.), vonal-és szövegobjektumokat. Ezek mindegyike rendelkezik számos azonos funkcióval, és támogatják a <tt>com.sun.star.drawing.Shape</tt> szolgáltatást. Ez a szolgáltatás meghatározza a rajzobjektum <tt>Size</tt> és <tt>Position</tt> tulajdonságát.

Az {{OOo}} Basic számtalan más szolgáltatást is biztosít, amelyeken keresztül módosíthatjuk az olyan tulajdonságokat, mint például a formázás, valamint kitöltéseket használhatunk. A rendelkezésre álló formázási lehetőségek a rajzobjektum típusától függenek.

A következő példa létrehoz és beszúr egy négyszöget a rajzobjektumba:

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim RectangleShape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

Point.x = 1000
Point.y = 1000
Size.Width = 10000
Size.Height = 10000

RectangleShape = Doc.createInstance("com.sun.star.drawing.RectangleShape")
RectangleShape.Size = Size
RectangleShape.Position = Point

Page.add(RectangleShape)
</source>

Ez a példa a <tt>StarDesktop.CurrentComponent</tt> hívást használja annak megállapítására, hogy melyik dokumentum van megnyitva. Az így meghatározott dokumentumobjektum a <tt>drawPages(0)</tt> függvényhívással visszaadja a rajzobjektum első oldalát.

Ezután a program inicializál egy <tt>Point</tt> és egy <tt>Size</tt> struktúrát a rajzobjektum kezdőpontjával (bal felső sarok) és méretével. A hosszméretek századmilliméterben vannak megadva.

A program ezután a <tt>Doc.createInstance</tt> használatával létrehoz egy négyszöget a <idl>com.sun.star.drawing.RectangleShape</idl> szolgáltatás alapján. Végül a program a rajzobjektumot hozzárendeli egy oldalhoz a <tt>Page.add</tt> használatával.

=== Rajztulajdonságok ===

Ez a szakasz négy szolgáltatást ismertet, és mindegyiknél a példaprogram egy négyszög-rajzelemet használ a különböző formázási típusok bemutatására. A kitöltési tulajdonságok a <idl>com.sun.star.drawing.FillProperties</idl> szolgáltatásban vannak összegyűjtve.

Az {{OOo}} a kitöltési terület négy fő formázási típusát ismeri fel. A legegyszerűbb az egyszínű kitöltés. A színátmenet és a vonalkázás már több színt is használ. A negyedik változat egy adott ábrát vetít a kitöltési területre.

Egy rajzobjektum kitöltési módját a <tt>FillStyle</tt> tulajdonság határozza meg. A használható értékeket a <idl>com.sun.star.drawing.FillStyle</idl> tartalmazza.

=== Egyszínű kitöltés ===

Az egyszínű kitöltés főtulajdonsága a

;<tt>FillColor (hosszú egész szám)</tt>:a terület kitöltési színe.

A kitöltési mód használatához a <tt>FillStyle</tt> tulajdonságot a <tt>SOLID</tt> kitöltési módra kell állítani.

A következő példa létrehoz egy négyszögalakzatot, és kitölti azt pirossal (RGB-érték: 255, 0, 0):

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim RectangleShape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size

Point.x = 1000
Point.y = 1000
Size.Width = 10000
Size.Height = 10000

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

RectangleShape = Doc.createInstance("com.sun.star.drawing.RectangleShape")
RectangleShape.Size = Size
RectangleShape.Position = Point

RectangleShape.FillStyle = com.sun.star.drawing.FillStyle.SOLID
RectangleShape.FillColor = RGB(255,0,0)

Page.add(RectangleShape)
</source>

=== Színátmenet ===

Ha a <tt>FillStyle</tt> tulajdonságot a <tt>GRADIENT</tt> értékre állítjuk az {{OOo}}-dokumentum kitöltési területén színátmenetet alkalmazhatunk.

Ha egy előre definiált színátmenetet akarunk alkalmazni, akkor használjuk a <tt>FillTransparenceGradientName</tt> tulajdonság megfelelő nevét. Ha saját színátmenetet akarunk használni, töltsük ki a <idl>com.sun.star.awt.Gradient</idl> struktúrát, és rendeljük hozzá a <tt>FillGradient</tt> tulajdonsághoz. Ez a tulajdonság a következő lehetőségeket biztosítja:

;<tt>Style (enumeráció)</tt>:a színátmenet típusa, például egyenletes vagy sugárirányú, (alapértelmezett értékek a <idl>com.sun.star.awt.GradientStyle</idl> tulajdonságnak megfelelően).
;<tt>StartColor (hosszú egész)</tt>:a színátmenet kezdőszíne.
;<tt>EndColor (hosszú egész)</tt>:a színátmenet befejezőszíne.
;<tt>Angle (rövid egész)</tt>:színátmenet szöge tizedfokban.
;<tt>XOffset (rövid egész)</tt>:a színátmenet kezdésének X koordinátája századmilliméterben megadva.
;<tt>XOffset (rövid egész)</tt>:a színátmenet kezdésének Y koordinátája századmilliméterben megadva.
;<tt>StartIntensity (rövid egész)</tt>:a <tt>StartColor</tt> intenzitása százalékban (az {{OOo}} Basicben 100-nál nagyobb érték is megadható).
;<tt>EndIntensity (rövid egész)</tt>:az <tt>EndColor</tt> intenzitása százalékban (az {{OOo}} Basicben 100-nál nagyobb érték is megadható).
;<tt>StepCount (rövid egész)</tt>:színátmenet színeinek száma, amelyekre az {{OOo}} kiszámítja színátmenetet.

A következő példa bemutatja a színátmenetek használatát a <idl>com.sun.star.awt.Gradient</idl> struktúra használatával:

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim RectangleShape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size
Dim Gradient As New com.sun.star.awt.Gradient

Point.x = 1000
Point.y = 1000
Size.Width = 10000
Size.Height = 10000

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

RectangleShape = Doc.createInstance("com.sun.star.drawing.RectangleShape")
RectangleShape.Size = Size
RectangleShape.Position = Point
Gradient.Style = com.sun.star.awt.GradientStyle.LINEAR
Gradient.StartColor = RGB(255,0,0)
Gradient.EndColor = RGB(0,255,0)
Gradient.StartIntensity = 150
Gradient.EndIntensity = 150
Gradient.Angle = 450
Gradient.StepCount = 100

RectangleShape.FillStyle = com.sun.star.drawing.FillStyle.GRADIENT
RectangleShape.FillGradient = Gradient

Page.add(RectangleShape)
</source>

Ez a példa egy egyenletes színátmenetet hoz létre (<tt>Style = LINEAR</tt>). Az átmenet pirossal kezdődik (<tt>StartColor</tt>) a bal felső sarokban, és egy 45 fokos (<tt>Angle</tt>) átmenetben zöld lesz (<tt>EndColor</tt>) a jobb alsó sarokban. A kezdő és befejező szín intenzitása 150 százalék (<tt>StartIntensity</tt> és <tt>EndIntensity</tt>), ami azt eredményezi, hogy a színek fényesebbnek látszanak a <tt>StartColor</tt> és a <tt>EndColor</tt> tulajdonságban megadottaknál. A színátmenet száz különböző színnel jelenik meg (<tt>StepCount</tt>).

=== Vonalkázás ===

Ha vonalkázott kitöltést akarunk használni, állítsuk a <tt>FillStyle</tt> tulajdonságot <tt>HATCH</tt> értékre. A vonalkázást meghatározó programrészlet nagyon hasonló a színátmenetet meghatározóhoz. Ismét egy külső struktúrát, ebben az esetben a <idl>com.sun.star.drawing.Hatch</idl>, használunk a vonalkázás meghatározásához. A vonalkázás struktúrája a következő tulajdonságokkal rendelkezik:

;<tt>Style (enumeráció)</tt>:a vonalkázás típusa: egyszerű, négyszögletes vagy négyszögletes átlós vonalakkal (alapértelmezett értékek a <tt>com.sun.star.awt.HatchStyle</tt> tulajdonság szerint).
;<tt>Color (hosszú egész)</tt>:vonalak színe.
;<tt>Distance (hosszú egész)</tt>:a vonalak közti távolság századmilliméterben.
;<tt>Angle (rövid egész)</tt>:vonalkázás szöge tizedfokban.

A következő példa bemutatja a vonalkázás struktúrájának használatát:

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim RectangleShape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size
Dim Hatch As New com.sun.star.drawing.Hatch

Point.x = 1000
Point.y = 1000
Size.Width = 10000
Size.Height = 10000

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

RectangleShape = Doc.createInstance("com.sun.star.drawing.RectangleShape")
RectangleShape.Size = Size
RectangleShape.Position = Point

RectangleShape.FillStyle = com.sun.star.drawing.FillStyle.HATCH

Hatch.Style = com.sun.star.drawing.HatchStyle.SINGLE
Hatch.Color = RGB(64,64,64)
Hatch.Distance = 20
Hatch.Angle = 450

RectangleShape.FillHatch = Hatch

Page.add(RectangleShape)
</source>

A program létrehoz egy egyszerű vonalkázási struktúrát (<tt>HatchStyle = SINGLE</tt>), amelynek vonalai 45 fokos szögben állnak (<tt>Angle</tt>). A vonalak sötétszürkék (<tt>Color</tt>), és egymástól 0,2 milliméterre vannak (<tt>Distance</tt>).

=== Bitképek ===

Ha kitöltésként egy bitképet akarunk használni, állítsuk a <tt>FillStyle</tt> tulajdonságot a <tt>BITMAP</tt> értékre. Ha a bitkép már szerepel az {{OOo}} programban, akkor csak meg kell adnia a nevét a <tt>FillBitMapName</tt> tulajdonságban, és a megjelenítési típusát (egyszerű, mozaik vagy nyújtott) a <tt>FillBitmapMode</tt> tulajdonságban (alapértelmezett értékek a <idl>com.sun.star.drawing.BitmapMode</idl> tulajdonság szerint).

Ha külső bitképfájlt akarunk használni, adjuk meg az URL-jét a <tt>FillBitmapURL</tt> tulajdonságban.

A következő példa létrehoz egy négyszöget, és kitölti az {{OOo}} programban megtalálható a Sky bitképpel mozaikkitöltés használatával:

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim RectangleShape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size

Point.x = 1000
Point.y = 1000
Size.Width = 10000
Size.Height = 10000

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

RectangleShape = Doc.createInstance("com.sun.star.drawing.RectangleShape")
RectangleShape.Size = Size
RectangleShape.Position = Point

RectangleShape.FillStyle = com.sun.star.drawing.FillStyle.BITMAP
RectangleShape.FillBitmapName = "Sky"
RectangleShape.FillBitmapMode = com.sun.star.drawing.BitmapMode.REPEAT

Page.add(RectangleShape)
</source>

=== Átlátszóság ===

Minden kitöltés átlátszóságát beállíthatjuk. A legegyszerűbb módja egy rajzelem átlátszósága beállításának a <tt>FillTransparence</tt> tulajdonság használata.

A következő példa létrehoz egy piros négyszöget 50 százalékos átlátszósággal.

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim RectangleShape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size

Point.x = 1000
Point.y = 1000
Size.Width = 10000
Size.Height = 10000

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

RectangleShape = Doc.createInstance("com.sun.star.drawing.RectangleShape")
RectangleShape.Size = Size
RectangleShape.Position = Point

RectangleShape.FillStyle = com.sun.star.drawing.FillStyle.SOLID
RectangleShape.FillTransparence = 50
RectangleShape.FillColor = RGB(255,0,0)

Page.add(RectangleShape)
</source>

Ha a kitöltést teljesen átlátszóvá akarjuk tenni, állítsuk a <tt>FillTransparence</tt> tulajdonságot 100 értékre.

A <tt>FillTransparence</tt> tulajdonságon felül a <idl>com.sun.star.drawing.FillProperties</idl> szolgáltatás a <tt>FillTransparenceGradient</tt> tulajdonságot is biztosítja. Ezzel a tulajdonsággal lehet megadni a kitöltési terület átlátszóságát szabályozó színátmenetet.

=== Vonaltulajdonságok ===

Minden rajzobjektum, amelynek lehet kerete, támogatja a <idl>com.sun.star.drawing.LineStyle</idl> szolgáltatást. Néhány tulajdonság, amelyet a szolgáltatás biztosít:

;<tt>LineStyle (enumeráció)</tt>:vonal típusa (alapértelmezett értékek a <idl>com.sun.star.drawing.LineStyle</idl> tulajdonságnak megfelelően).
;<tt>LineColor (hosszú egész)</tt>:a vonal színe.
;<tt>LineTransparence (rövid egész)</tt>:a vonal átlátszósága.
;<tt>LineWidth (hosszú egész)</tt>:a vonal vastagsága századmilliméterben.
;<tt>LineJoint (enumeráció)</tt>:az összekötési pontok átmenete (alapértelmezett értékek a <idl>com.sun.star.drawing.LineJoint</idl> tulajdonságnak megfelelően).

A következő példa létrehoz egy négyszöget sima kerettel (<tt>LineStyle = SOLID</tt>), amely 5 milliméter vastag (<tt>LineWidth</tt>), és 50 százalékban átlátszó. A keret vonalának bal és jobb széle túlnyúlik a metszéspontjukon (<tt>LineJoint = MITER</tt>), így egy derékszöget képeznek.

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim RectangleShape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size

Point.x = 1000
Point.y = 1000
Size.Width = 10000
Size.Height = 10000

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

RectangleShape = Doc.createInstance("com.sun.star.drawing.RectangleShape")
RectangleShape.Size = Size
RectangleShape.Position = Point

RectangleShape.LineColor = RGB(128,128,128)
RectangleShape.LineTransparence = 50
RectangleShape.LineWidth = 500
RectangleShape.LineJoint = com.sun.star.drawing.LineJoint.MITER

RectangleShape.LineStyle = com.sun.star.drawing.LineStyle.SOLID

Page.add(RectangleShape)
</source>

A felsorolt tulajdonságokon felül a <idl>com.sun.star.drawing.LineStyle</idl> szolgáltatás lehetővé teszi pontozott és szaggatott vonal létrehozását is. További információkért lásd: {{OOo}} API-referencia.

=== Szövegtulajdonságok (rajzobjektumok) ===

A <idl>com.sun.star.style.CharacterProperties</idl> és a <idl>com.sun.star.style.ParagraphProperties</idl> szolgáltatással formázható a szöveg a rajzobjektumokban. Ezek a szolgáltatások az egyes karakterekre és bekezdésekre vonatkoznak, és részletes információt a [[HU/Documentation/BASIC Guide/Text Documents|Szöveges dokumentumok]] fejezetben találhatunk róluk.

A következő példa szöveget szúr be egy négyszögbe, és formázza a betűtípusát a <idl>com.sun.star.style.CharacterProperties</idl> szolgáltatással.

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim RectangleShape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size
Point.x = 1000
Point.y = 1000
Size.Width = 10000
Size.Height = 10000
Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

RectangleShape = Doc.createInstance("com.sun.star.drawing.RectangleShape")
RectangleShape.Size = Size
RectangleShape.Position = Point

Page.add(RectangleShape)

RectangleShape.String = "Ez egy teszt."
RectangleShape.CharWeight = com.sun.star.awt.FontWeight.BOLD
RectangleShape.CharFontName = "Arial"
</source>

A program a négyszög <tt>String</tt> tulajdonságával szúrja be a szöveget, és a <tt>com.sun.star.style.CharacterProperties</tt> szolgáltatás <tt>CharWeight</tt>, illetve <idl>CharFontName</idl> tulajdonságával formázza a szöveg betűtípusát.

A szöveg csak azután szúrható be, miután a rajzobjektum hozzá lett adva az oldalhoz. A <idl>com.sun.star.drawing.Text</idl> szolgáltatással beállítható a rajzobjektum szövegének helye és formátuma. Az alábbiakban láthatók ennek a szolgáltatásnak a legfőbb tulajdonságai:

;<tt>TextAutoGrowHeight (logikai érték)</tt>:a rajzelem magasságát az általa tartalmazott szöveghez igazítja.
;<tt>TextAutoGrowWidth (logikai érték)</tt>:a rajzelem szélességét az általa tartalmazott szöveghez igazítja.
;<tt>TextHorizontalAdjust (enumeráció)</tt>:a szöveg vízszintes helye a rajzelemen belül (alapértelmezett értékek a <idl>com.sun.star.drawing.TextHorizontalAdjust</idl> tulajdonság szerint).
;<tt>TextVerticalAdjust (enumeráció)</tt>:a szöveg függőleges helye a rajzelemen belül (alapértelmezett értékek a <idl>com.sun.star.drawing.TextVerticalAdjust</idl> tulajdonság szerint).
;<tt>TextLeftDistance (hosszú egész)</tt>:a szöveg bal oldala és a rajzelem közti távolság századmilliméterben.
;<tt>TextRightDistance (hosszú egész)</tt>:a szöveg jobb oldala és a rajzelem közti távolság századmilliméterben.
;<tt>TextUpperDistance (hosszú egész)</tt>:a szöveg felső oldala és a rajzelem közti távolság századmilliméterben.
;<tt>TextLowerDistance (hosszú egész)</tt>:a szöveg alsó oldala és a rajzelem közti távolság századmilliméterben.

A következő példa bemutatja a fent említett tulajdonságok használatát.

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim RectangleShape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size

Point.x = 1000
Point.y = 1000
Size.Width = 10000
Size.Height = 10000

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

RectangleShape = Doc.createInstance("com.sun.star.drawing.RectangleShape")
RectangleShape.Size = Size
RectangleShape.Position = Point

Page.add(RectangleShape)

RectangleShape.String = "Ez egy teszt." ' Csak a Page.add után állhat!

RectangleShape.TextVerticalAdjust = com.sun.star.drawing.TextVerticalAdjust.TOP
RectangleShape.TextHorizontalAdjust = com.sun.star.drawing.TextHorizontalAdjust.LEFT

RectangleShape.TextLeftDistance = 300
RectangleShape.TextRightDistance = 300
RectangleShape.TextUpperDistance = 300
RectangleShape.TextLowerDistance = 300
</source>

Ez a program beszúr egy rajzelemet egy oldalra, majd szöveget ír a rajzobjektum bal felső sarkába a <tt>TextVerticalAdjust</tt> és a <tt>TextHorizontalAdjust</tt> tulajdonsággal. A szöveg széle és a rajzobjektum közti minimális távolság három milliméter.

=== Árnyéktulajdonságok ===

Árnyékot adhatunk a legtöbb rajzobjektumhoz a <idl>com.sun.star.drawing.ShadowProperties</idl> szolgáltatással. A szolgáltatás tulajdonságai:

;<tt>Shadow (logikai érték)</tt>:az árnyék aktiválása.
;<tt>ShadowColor (hosszú egész)</tt>:az árnyék színe.
;<tt>ShadowTransparence (rövid egész)</tt>:az árnyék átlátszósága.
;<tt>ShadowXDistance (hosszú egész)</tt>:az árnyék rajzobjektumtól mért függőleges távolsága századmilliméterben.
;<tt>ShadowYDistance (hosszú egész)</tt>:az árnyék rajzobjektumtól mért vízszintes távolsága századmilliméterben.

A következő példa létrehoz egy négyszöget egy árnyékkal, amely függőlegesen és vízszintesen 2 milliméterre van a négyszögtől. Az árnyék sötétszürkén jelenik meg, 50 százalékos átlátszósággal.

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim RectangleShape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size

Point.x = 1000
Point.y = 1000
Size.Width = 10000
Size.Height = 10000

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

RectangleShape = Doc.createInstance("com.sun.star.drawing.RectangleShape")
RectangleShape.Size = Size
RectangleShape.Position = Point

RectangleShape.Shadow = True
RectangleShape.ShadowColor = RGB(192,192,192)
RectangleShape.ShadowTransparence = 50
RectangleShape.ShadowXDistance = 200
RectangleShape.ShadowYDistance = 200

Page.add(RectangleShape)
</source>

== A különböző rajzobjektumok áttekintése ==

=== Négyszögalakzat ===

A négyszögalakzat-objektumok (<idl>com.sun.star.drawing.RectangleShape</idl>) a következő objektumokat támogatják a formázáshoz:

;<tt>Kitöltési tulajdonságok</tt>:<idl>com.sun.star.drawing.FillProperties</idl>
;<tt>Vonaltulajdonságok</tt>:<idl>com.sun.star.drawing.LineProperties</idl>
;<tt>Szövegtulajdonságok</tt>:<idl>com.sun.star.drawing.Text</idl> (a <idl>com.sun.star.style.CharacterProperties</idl> és a <idl>com.sun.star.style.ParagraphProperties</idl> szolgáltatással)
;<tt>Árnyéktulajdonságok</tt>:<idl>com.sun.star.drawing.ShadowProperties</idl>
;<tt>CornerRadius (hosszú egész)</tt>:a sarkok kerekítési sugara századmilliméterben.

=== Körök és ellipszisek ===

A <idl>com.sun.star.drawing.EllipseShape</idl> szolgáltatással lehet köröket és ellipsziseket létrehozni. A szolgáltatás a következőket támogatja:

;<tt>Kitöltési tulajdonságok</tt>:<idl>com.sun.star.drawing.FillProperties</idl>
;<tt>Vonaltulajdonságok</tt>:<idl>com.sun.star.drawing.LineProperties</idl>
;<tt>Szövegtulajdonságok</tt>:<idl>com.sun.star.drawing.Text</idl> (a <idl>com.sun.star.style.CharacterProperties</idl> és a <idl>com.sun.star.style.ParagraphProperties</idl> szolgáltatással)
;<tt>Árnyéktulajdonságok</tt>:<idl>com.sun.star.drawing.ShadowProperties</idl>

Ezeken a szolgáltatásokon felül a körök és ellipszisek is támogatják ezeket a tulajdonságokat:

;<tt>CircleKind (enumeráció)</tt>:a kör vagy ellipszis típusa (alapértelmezett értékek a <idl>com.sun.star.drawing.CircleKind</idl> tulajdonságnak megfelelően)
;<tt>CircleStartAngle (hosszú egész)</tt>:kezdőszög tizedfokban (csak kör- vagy ellipszisszeleteknél)
;<tt>CircleEndAngle (hosszú egész)</tt>:befejezőszög tizedfokban (csak kör- vagy ellipszisszeleteknél)

A <tt>CircleKind</tt> tulajdonság meghatározza, hogy egy objektum teljes kör, körszelet vagy körcikk. A következő értékek használhatók:

;<idl>com.sun.star.drawing.CircleKind.FULL</idl>:teljes kör vagy ellipszis.
;<idl>com.sun.star.drawing.CircleKind.CUT</idl>:körszelet (a kör egy része, amelynek határolófelületei közvetlenül érintkeznek).
;<idl>com.sun.star.drawing.CircleKind.SECTION</idl>:körcikk.
;<idl>com.sun.star.drawing.CircleKind.ARC</idl>:szög (körvonal nélkül).

A következő példa létrehoz egy 70 fokos körcikket (amely a 20 fokos kezdéstől a 90 fokos befejezésig tart).

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim EllipseShape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size

Point.x = 1000
Point.y = 1000
Size.Width = 10000
Size.Height = 10000

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

EllipseShape = Doc.createInstance("com.sun.star.drawing.EllipseShape")
EllipseShape.Size = Size
EllipseShape.Position = Point

EllipseShape.CircleStartAngle = 2000
EllipseShape.CircleEndAngle = 9000
EllipseShape.CircleKind = com.sun.star.drawing.CircleKind.SECTION

Page.add(EllipseShape)
</source>

=== Vonalak ===

Az {{OOo}} a <idl>com.sun.star.drawing.LineShape</idl> szolgáltatást biztosítja a vonalobjektumokhoz. A vonalobjektumok támogatják az összes általános formázási szolgáltatást, kivéve a területekre vonatkozókat. A <tt>LineShape</tt> szolgáltatáson keresztül a következő tulajdonságok érhetők el:

;<tt>Vonaltulajdonságok</tt>:<idl>com.sun.star.drawing.LineProperties</idl>
;<tt>Szövegtulajdonságok</tt>:<idl>com.sun.star.drawing.Text</idl> (a <idl>com.sun.star.style.CharacterProperties</idl> és a <idl>com.sun.star.style.ParagraphProperties</idl> szolgáltatással)
;<tt>Árnyéktulajdonságok</tt>:<idl>com.sun.star.drawing.ShadowProperties</idl>

A következő példa létrehoz és formáz egy vonalat a fent említett tulajdonságok használatával. A vonal kezdőpontját a <tt>Location</tt> tulajdonság határozza meg, míg a <tt>Size</tt> tulajdonságban megadott koordináták meghatározzák a vonal végét.

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim LineShape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size

Point.x = 1000
Point.y = 1000
Size.Width = 10000
Size.Height = 10000

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

LineShape = Doc.createInstance("com.sun.star.drawing.LineShape")
LineShape.Size = Size
LineShape.Position = Point

Page.add(LineShape)
</source>

=== Polipoligon-alakzatok ===

Az {{OOo}} támogatja az összetett poligonális alakzatokat a <idl>com.sun.star.drawing.PolyPolygonShape</idl> szolgáltatáson keresztül. Szigorúan véve a polipoligon nem egyetlen poligon, hanem több. Több független, sarokpontokat tartalmazó lista megadható és kombinálható, amelyek együtt egy teljes objektumot alkotnak.

Ahogy a négyszögalakzatoknál is, úgy a polipoligonoknál is a rajzobjektumok összes tulajdonsága rendelkezésre áll.

;<tt>Kitöltési tulajdonságok</tt>:<idl>com.sun.star.drawing.FillProperties</idl>
;<tt>Vonaltulajdonságok</tt>:<idl>com.sun.star.drawing.LineProperties</idl>
;<tt>Szövegtulajdonságok</tt>:<idl>com.sun.star.drawing.Text</idl> (a <idl>com.sun.star.style.CharacterProperties</idl> és a <idl>com.sun.star.style.ParagraphProperties</idl> szolgáltatással)
;<tt>Árnyéktulajdonságok</tt>:<idl>com.sun.star.drawing.ShadowProperties</idl>

A <tt>PolyPolygonShape</tt> szolgáltatás rendelkezik egy tulajdonsággal, amellyel megadhatók egy poligon koordinátái:

* <tt>PolyPolygon (tömb)</tt>:a poligon koordinátáit tartalmazó tömb (dupla pontosságú értékeket tartalmazó tömb, <idl>com.sun.star.awt.Point</idl> típusú pontokkal).

A következő példa bemutatja, hogyan hozható létre egy háromszög a <tt>PolyPolygonShape</tt> szolgáltatással.

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim PolyPolygonShape As Object
Dim PolyPolygon As Variant
Dim Coordinates(2) As New com.sun.star.awt.Point

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

PolyPolygonShape = Doc.createInstance("com.sun.star.drawing.PolyPolygonShape")
Page.add(PolyPolygonShape) ' A Page.add metódusnak meg kell előznie a koordináták beállítását.

Coordinates(0).x = 1000
Coordinates(1).x = 7500
Coordinates(2).x = 10000
Coordinates(0).y = 1000
Coordinates(1).y = 7500
Coordinates(2).y = 5000

PolyPolygonShape.PolyPolygon = Array(Coordinates())
</source>

Mivel a poligon pontjai abszolút értékek, nem kell megadnunk a poligon méretét vagy kezdőpontját. Ehelyett, létre kell hozni egy tömböt a pontokból, beágyazni ezt a tömböt egy másik tömbbe (az <tt> Array(koordináták)</tt> függvénnyel), majd ezt a tömböt hozzárendelni a poligonhoz. A függvényhívás előtt a poligont be kell szúrni a dokumentumba.

A dupla pontosságú tömbbel lehetővé válik, hogy összetett alakzatokat hozzunk létre több poligon összevonásából. Például létrehozhatunk egy négyszöget, majd beszúrhatunk egy másik négyszöget annak belsejébe, és létrehozhatunk egy lyukat az eredeti négyszögben:

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim PolyPolygonShape As Object
Dim PolyPolygon As Variant
Dim Square1(3) As New com.sun.star.awt.Point
Dim Square2(3) As New com.sun.star.awt.Point
Dim Square3(3) As New com.sun.star.awt.Point

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

PolyPolygonShape = Doc.createInstance("com.sun.star.drawing.PolyPolygonShape")

Page.add(PolyPolygonShape) ' A Page.add metódusnak meg kell előznie a koordináták beállítását.

Square1(0).x = 5000
Square1(1).x = 10000
Square1(2).x = 10000
Square1(3).x = 5000
Square1(0).y = 5000
Square1(1).y = 5000
Square1(2).y = 10000
Square1(3).y = 10000

Square2(0).x = 6500
Square2(1).x = 8500
Square2(2).x = 8500
Square2(3).x = 6500
Square2(0).y = 6500
Square2(1).y = 6500
Square2(2).y = 8500
Square2(3).y = 8500

Square3(0).x = 6500
Square3(1).x = 8500
Square3(2).x = 8500
Square3(3).x = 6500
Square3(0).y = 9000
Square3(1).y = 9000
Square3(2).y = 9500
Square3(3).y = 9500

PolyPolygonShape.PolyPolygon = Array(Square1(), Square2(), Square3())
</source>

Arra tekintettel, hogy melyik terület jelenti a kitöltött részt, és melyik terület a lyukat, az {{OOo}} egy egyszerű szabályt alkalmaz: a külső alakzat körvonala mindig a poligon külső kerete. A következő vonal befelé az alakzat belső kerete, és jelzi a lyuk kezdetét. Ha még egy vonal van befelé, akkor az ismét egy lyuk kezdete.

=== Képek ===

A legutoljára bemutatott rajzelemek a képobjektumok, amelyek a <idl>com.sun.star.drawing.GraphicObjectShape</idl> szolgáltatáson alapulnak. Ezek bármilyen képpel használhatók az {{OOo}} programban, amelyek megjelenése számos tulajdonsággal módosítható.

A képobjektumok az általános formázótulajdonságok közül kettőt támogatnak:

;<tt>Szövegtulajdonságok</tt>:<idl>com.sun.star.drawing.Text</idl> (a <idl>com.sun.star.style.CharacterProperties</idl> és a <idl>com.sun.star.style.ParagraphProperties</idl> szolgáltatással)
;<tt>Árnyéktulajdonságok</tt>:<idl>com.sun.star.drawing.ShadowProperties</idl>

A képobjektumok által támogatott egyéb tulajdonságok:

;<tt>GraphicURL (karakterlánc)</tt>:a kép URL-je.
;<tt>AdjustLuminance (rövid egész)</tt>:színek fényereje százalékban (negatív értékek is megadhatók).
;<tt>AdjustContrast (rövid egész)</tt>:színek kontrasztja százalékban (negatív értékek is megadhatók).
;<tt>AdjustRed (rövid egész)</tt>:piros szín százalékban (negatív értékek is megadhatók).
;<tt>AdjustGreen (rövid egész)</tt>:zöld szín százalékban (negatív értékek is megadhatók).
;<tt>AdjustBlue (rövid egész)</tt>:kék szín százalékban (negatív értékek is megadhatók).
;<tt>Gamma (rövid egész)</tt>:kép gammaértéke.
;<tt>Transparency (rövid egész)</tt>:kép átlátszósága százalékban.
;<tt>GraphicColorMode (enumeráció)</tt>:színmód, például normál, szürkeárnyalatok, fekete-fehér (alapértelmezett érték a <idl>com.sun.star.drawing.ColorMode</idl> tulajdonságnak megfelelően.)

A következő példa bemutatja, hogyan szúrható be egy oldal egy képobjektumba.

<source lang="oobas">
Dim Doc As Object
Dim Page As Object
Dim GraphicObjectShape As Object
Dim Point As New com.sun.star.awt.Point
Dim Size As New com.sun.star.awt.Size

Point.x = 1000 ' specifikációk, nem számít a tartalmuk, mert
a koordináták később vannak összekapcsolva
Point.y = 1000
Size.Width = 10000
Size.Height = 10000

Doc = StarDesktop.CurrentComponent
Page = Doc.drawPages(0)

GraphicObjectShape = Doc.createInstance("com.sun.star.drawing.GraphicObjectShape")

GraphicObjectShape.Size = Size
GraphicObjectShape.Position = Point

GraphicObjectShape.GraphicURL = "file:///c:/test.jpg"
GraphicObjectShape.AdjustBlue = -50
GraphicObjectShape.AdjustGreen = 5
GraphicObjectShape.AdjustBlue = 10
GraphicObjectShape.AdjustContrast = 20
GraphicObjectShape.AdjustLuminance = 50
GraphicObjectShape.Transparency = 40
GraphicObjectShape.GraphicColorMode = com.sun.star.drawing.ColorMode.STANDARD

Page.add(GraphicObjectShape)
</source>

A kód beszúrja a <tt>test.jpg</tt> képet, és beállítja a megjelenését az <tt>Adjust</tt> tulajdonságokkal. Ebben a példában a kép 40 százalékos átlátszósággal jelenik meg, és nincs más színkonverzió (<tt>GraphicColorMode = STANDARD</tt>).

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Structure of Drawings}}
{{PDL1}}

HU/Documentation/BASIC Guide/Structure of Charts

2009-05-15T14:39:27Z

Timarandras: New page: {{HU/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=HU/Documentation/BASIC Guide/Charts in Spreadsheets |NextPage=HU/Documentation/BASIC Guide/Chart Types...

{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Charts in Spreadsheets
|NextPage=HU/Documentation/BASIC Guide/Chart Types
|chart=block
}}
{{DISPLAYTITLE:A diagramok felépítése}}
__NOTOC__
Egy diagram felépítése – és ezáltal az általa támogatott szolgáltatások és felületek listája – annak típusától függ. Például a Z tengely metódusai és tulajdonságai csak térhatású diagramoknál érhetők el, síkbelieknél nem, illetve a tortadiagramoknál nincsenek felületek a tengelyek kezelésére.

== Cím, alcím és jelmagyarázat ==

A cím, alcím és jelmagyarázat minden diagramnál alapelem. A <tt>Chart</tt> objektum a következő tulajdonságokkal rendelkezik ezeknek az elemeknek a kezeléséhez:

;<tt>HasMainTitle (logikai érték)</tt>:a cím aktiválása.
;<tt>Title (objektum)</tt>:a diagram címéről részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartTitle</idl> szolgáltatást).
;<tt>HasSubTitle(logikai érték)</tt>:az alcím aktiválása
;<tt>Subtitle (objektum)</tt>:a diagram alcíméről részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartTitle</idl> szolgáltatást).
;<tt>HasLegend (logikai érték)</tt>:a jelmagyarázat aktiválása.
;<tt>Legend (objektum)</tt>:a diagram jelmagyarázatáról részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartLegend</idl> szolgáltatást).

A <tt>com.sun.star.chart.ChartTitle</tt> és a <tt>com.sun.star.chart.ChartLegend</tt> szolgáltatások egyaránt támogatják a <tt>com.sun.star.drawing.Shape</tt> szolgáltatást. Ezért a felhasználók az elemek helyét és méretét meg tudják állapítani a <tt>Size</tt> és a <tt>Position</tt> tulajdonsággal. Mivel a jelmagyarázat és a címek méretét a program automatikusan számítja ki például az aktuális tartalom és a karaktermagasság függvényében, a méret tulajdonság csak olvasható.

Az elemek formázásához kitöltési tulajdonságok és vonaltulajdonságok (a <idl>com.sun.star.drawing.FillProperties</idl> és a <idl>com.sun.star.drawing.LineProperties</idl> szolgáltatás), valamint karaktertulajdonságok (a <idl>com.sun.star.style.CharacterProperties</idl> szolgáltatás) állnak rendelkezésre.

A <idl>com.sun.star.chart.ChartTitle</idl> objektum nem csak az említett formázási tulajdonságokat tartalmazza, hanem két másik tulajdonságot is:

;<tt>String (karakterlánc)</tt>:a címként vagy alcímként megjelenítendő szöveg.
;<tt>TextRotation (hosszú egész szám)</tt>:a szöveg forgatása századfokban.

A diagram jelmagyarázata (<idl>com.sun.star.chart.ChartLegend</idl> szolgáltatás) a következő további tulajdonságokat tartalmazza:

;<tt>Alignment (enumeráció)</tt>:a jelmagyarázat helye (<idl>com.sun.star.chart.ChartLegendPosition</idl> típusú érték).

A következő példa létrehoz egy diagramot, és hozzárendeli a „Főcím” címet, az „Alcím” alcímet és egy jelmagyarázatot. A jelmagyarázat háttérszíne szürke lesz, a diagram alján fog elhelyezkedni, és a karaktermérete 7 pontos lesz.

<source lang="oobas">
Dim Doc As Object
Dim Charts As Object
Dim Chart as Object
Dim Rect As New com.sun.star.awt.Rectangle
Dim RangeAddress(0) As New com.sun.star.table.CellRangeAddress

Rect.X = 8000
Rect.Y = 1000
Rect.Width = 10000
Rect.Height = 7000
RangeAddress(0).Sheet = 0
RangeAddress(0).StartColumn = 0
RangeAddress(0).StartRow = 0
RangeAddress(0).EndColumn = 2
RangeAddress(0).EndRow = 12

Doc = StarDesktop.CurrentComponent

Charts = Doc.Sheets(0).Charts
Charts.addNewByName("SajátDiagram", Rect, RangeAddress(), True, True)
Chart = Charts.getByName("SajátDiagram").EmbeddedObject
Chart.HasMainTitle = True
Chart.Title.String = "Főcím"
Chart.HasSubTitle = True
Chart.Subtitle.String = "Alcím"
Chart.HasLegend = True
Chart.Legend.Alignment = com.sun.star.chart.ChartLegendPosition.BOTTOM
Chart.Legend.FillStyle = com.sun.star.drawing.FillStyle.SOLID
Chart.Legend.FillColor = RGB(210, 210, 210)
Chart.Legend.CharHeight = 7
</source>

== Háttér ==

Minden diagramnak van háttérterülete. A <tt>Chart</tt> objektum <tt>Area</tt> tulajdonságának segítségével formázható a háttér:

;<tt>Area (objektum)</tt>:a diagram háttérterülete (a <idl>com.sun.star.chart.ChartArea</idl> szolgáltatást támogatja).

A diagram háttérterülete lefedi a diagram teljes területét, beleértve a cím, az alcím és a jelmagyarázat alatti területet is. A kapcsolódó <idl>com.sun.star.chart.ChartArea</idl> szolgáltatás támogatja a vonal- és kitöltési tulajdonságokat.

== Diagram ==

A <tt>Chart</tt> objektum <tt>Diagram</tt> tulajdonságának segítségével formázható a koordinátarendszer a tengelyekkel és a beosztással, ahol az adatok végül megjelennek:

;<tt>Diagram (Object)</tt>:a koordinátarendszert formázó objektum. Támogatja a <idl>com.sun.star.chart.Diagram</idl> szolgáltatást, és a következőket:
:* <idl>com.sun.star.chart.StackableDiagram</idl>
:* <idl>com.sun.star.chart.ChartAxisXSupplier</idl>
:* <idl>com.sun.star.chart.ChartAxisYSupplier</idl>
:* <idl>com.sun.star.chart.ChartAxisZSupplier</idl>
:* <idl>com.sun.star.chart.ChartTwoAxisXSupplier</idl>
:* <idl>com.sun.star.chart.ChartTwoAxisYSupplier</idl>

A különböző szolgáltatások támogatása a diagram típusától függ (lásd:
[[Documentation/BASIC_Guide/Chart_Types|Diagramtípusok]]).

== Diagramhátterek és -alapsíkok ==

A diagram háttere a koordinátarendszer háttere.
A térbeli diagramoknál általában két háttér létezik: egy az adatterület mögött és egy a jobb vagy a bal oldalon. Ez a diagram elhelyezkedésétől függ. A térbeli diagramok rendszerint rendelkeznek alapsíkkal is.

A <tt>Chart</tt> objektum rendelkezik a <tt>Wall</tt> és a <tt>Floor</tt> tulajdonságokkal:

;<tt>Wall (objektum)</tt>:a koordinátarendszer háttérterülete (a <idl>com.sun.star.chart.ChartArea</idl> szolgáltatást támogatja).
;<tt>Floor (objektum)</tt>:a koordinátarendszer alapsíkja (csak térbeli diagramoknál, a <idl>com.sun.star.chart.ChartArea</idl> szolgáltatást támogatja).

Ezek az objektumok a <tt>com.sun.star.chart.ChartArea</tt> szolgáltatást támogatják, amely viszont rendelkezik a szokásos vonal- és kitöltési tulajdonságokkal (a <idl>com.sun.star.drawing.FillProperties</idl> és a <idl>com.sun.star.drawing.LineProperties</idl> szolgáltatás, lásd: [[Documentation/BASIC_Guide/Drawings_Presentations|Rajzok és bemutatók]]).

A következő példa bemutatja, hogyan használható fel egy, az {{OOo}} programban megtalálható ábra (Sky) a diagram háttérterületében. A koordinátarendszer háttere kékre van állítva.

<source lang="oobas">
Dim Doc As Object
Dim Charts As Object
Dim Chart as Object
Dim Rect As New com.sun.star.awt.Rectangle
Dim RangeAddress(0) As New com.sun.star.table.CellRangeAddress

Rect.X = 8000
Rect.Y = 1000
Rect.Width = 10000
Rect.Height = 7000
RangeAddress(0).Sheet = 0
RangeAddress(0).StartColumn = 0
RangeAddress(0).StartRow = 0
RangeAddress(0).EndColumn = 2
RangeAddress(0).EndRow = 12

Doc = StarDesktop.CurrentComponent

Charts = Doc.Sheets(0).Charts
Charts.addNewByName("SajátDiagram", Rect, RangeAddress(), True, True)
Chart = Charts.getByName("SajátDiagram").EmbeddedObject
Chart.Area.FillStyle = com.sun.star.drawing.FillStyle.BITMAP
Chart.Area.FillBitmapName = "Sky"
Chart.Area.FillBitmapMode = com.sun.star.drawing.BitmapMode.REPEAT

Chart.Diagram.Wall.FillStyle = com.sun.star.drawing.FillStyle.SOLID
Chart.Diagram.Wall.FillColor = RGB(00,132,209)
</source>

== Tengelyek ==

Az {{OOo}} öt különböző tengelyt tud használni a diagramokban. A legegyszerűbb esetben ez az X és Y tengely. Térhatású diagramoknál általában van egy Z tengely is. Az olyan diagramoknál, ahol az adatsorok értékei jelentősen eltérnek egymástól, az {{OOo}} biztosít egy másodlagos X és Y tengelyt a méretezéshez.

A <tt>Diagram</tt> objektum a következő tulajdonságokkal rendelkezik a tengelyek eléréséhez:

;<tt>HasXAxis (logikai érték)</tt>:aktiválja az X tengelyt.
;<tt>XAxis (objektum)</tt>:az X tengelyről részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartAxis</idl> szolgáltatást).
;<tt>HasXAxisDescription (logikai érték)</tt>:aktiválja a beosztás feliratait az X tengelynél..

;<tt>HasYAxis (logikai érték)</tt>:aktiválja az Y tengelyt.
;<tt>YAxis (objektum)</tt>:az Y tengelyről részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartAxis</idl> szolgáltatást).
;<tt>HasYAxisDescription (logikai érték)</tt>:aktiválja a beosztás feliratait az Y tengelynél.

;<tt>HasZAxis (logikai érték)</tt>:aktiválja a Z tengelyt.
;<tt>ZAxis (objektum)</tt>:a Z tengelyről részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartAxis</idl> szolgáltatást).
;<tt>HasZAxisDescription (logikai érték)</tt>:aktiválja a beosztás feliratait a Z tengelynél.

;<tt>HasSecondaryXAxis (logikai érték)</tt>:aktiválja a másodlagos X tengelyt.
;<tt>SecondaryXAxis (objektum)</tt>:a másodlagos X tengelyről részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartAxis</idl> szolgáltatást).
;<tt>HasSecondaryXAxisDescription (logikai érték)</tt>:aktiválja a beosztás feliratait a másodlagos X tengelynél.

;<tt>HasSecondaryYAxis (logikai érték)</tt>:aktiválja a másodlagos Y tengelyt.
;<tt>SecondaryYAxis (objektum)</tt>:a másodlagos Y tengelyről részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartAxis</idl> szolgáltatást).
;<tt>HasSecondaryYAxisDescription (logikai érték)</tt>:aktiválja a beosztás feliratait a másodlagos Y tengelynél.

== A tengelyek tulajdonságai ==

Egy {{OOo}}-diagram tengelyobjektuma a <idl>com.sun.star.chart.ChartAxis</idl> szolgáltatást támogatja. A karaktertulajdonságokon <idl>(com.sun.star.style.CharacterProperties</idl> szolgáltatás, lásd: [[Documentation/BASIC_Guide/Text_Documents|Szöveges dokumentumok]]) és vonaltulajdonságokon <idl>(com.sun.star.drawing.LineStyle</idl> szolgáltatás, lásd: [[Documentation/BASIC_Guide/Drawings_Presentations| Rajzok és bemutatók]]) felül a következő tulajdonságokat biztosítja:

===Skálatulajdonságok===
;<tt>Max (dupla pontosságú érték)</tt>:a tengely maximális értéke.
;<tt>Min (dupla pontosságú érték)</tt>:a tengely minimális értéke.
;<tt>Origin (dupla pontosságú érték)</tt>:az egymást keresztező tengelyek metszési pontja.
;<tt>StepMain (dupla pontosságú érték)</tt>:a tengely két elsődleges beosztása közti távolság.
;<tt>StepHelp (dupla pontosságú érték)</tt>:a tengely két albeosztása közti távolság (az OpenOffice.org 3.0 óta elavultnak számít, használjuk helyette a <tt>StepHelpCount</tt> tulajdonságot).
;<tt>StepHelpCount (hosszú egész szám)</tt>:Egy főbeosztáson belüli albeosztások számát adja meg. Ha például a StepHelpCount 5, akkor a főbeosztás 5 részre lesz osztva, és 4 kis beosztásjel lesz behúzva. (Az OpenOffice.org 3.0 óta érhető el.)
;<tt>AutoMax (logikai érték)</tt>:ha igaz, akkor a program a tengely maximális értékét automatikusan beállítja.
;<tt>AutoMin (logikai érték)</tt>:ha igaz, akkor a program a tengely minimális értékét automatikusan beállítja.
;<tt>AutoOrigin (logikai érték)</tt>:ha igaz, akkor a program az egymást keresztező tengelyek metszési pontját automatikusan beállítja.
;<tt>AutoStepMain (logikai érték)</tt>:ha igaz, akkor a <tt>StepMain</tt> értékét a program automatikusan meghatározza.
;<tt>AutoStepHelp (logikai érték)</tt>:ha igaz, akkor a <tt>StepHelpCount </tt> értékét a program automatikusan meghatározza.
;<tt>Logarithmic (logikai érték)</tt>:a tengelyeket logaritmikusan méretezi (lineáris méretezés helyett).
;<tt>ReverseDirection (logikai érték)</tt>:meghatározza, hogy a tengely irányítása matematikai vagy fordított. (Az OpenOffice.org 2.4 óta érhető el.)

===Címketulajdonságok:===
;<tt>DisplayLabels (logikai érték)</tt>:aktiválja a beosztásjelek szövegcímkéit.
;<tt>TextRotation (hosszú egész szám)</tt>:a szövegcímkék forgatása századfokban.
;<tt>ArrangeOrder (enumeráció)</tt>:a címkék összetorlódhatnak, ezért két sorba felváltva helyezkednek el (az értékek a <idl>com.sun.star.chart.ChartAxisArrangeOrderType</idl> szerint)
;<tt>TextBreak (logikai érték)</tt>:sortörések engedélyezése a tengelycímkéken belül
;<tt>TextCanOverlap (logikai érték)</tt>:tengelycímkék átfedésének engedélyezése
;<tt>NumberFormat (hosszú egész szám)</tt>:a tengelycímkékhez használt számformátum
;<tt>LinkNumberFormatToSource (logikai érték)</tt>:meghatározza, hogy a számformátumot a diagramot tároló dokumentumból vagy a <tt>NumberFormat</tt> tulajdonságból kell-e venni. (Az OpenOffice.org 2.3 óta érhető el.)

===Beosztásjelek tulajdonságai===
;<tt>Marks (állandó)</tt>:meghatározza a főbeosztások helyét (az értékek a <idl>com.sun.star.chart.ChartAxisMarks</idl> tulajdonságnak megfelelően)
;<tt>HelpMarks (állandó)</tt>:meghatározza az albeosztások helyét (az értékek a <idl>com.sun.star.chart.ChartAxisMarks</idl> tulajdonságnak megfelelően)

===Csak sávdiagramoknál:===
;<tt>Overlap (hosszú egész szám)</tt>:százalékos arány, amely megadja, hogy a sávok mennyire fedik át egymást (100%: a sávok teljesen átfedik egymást, -100%: a sávok közt a sávok szélességével megegyező távolság van).
;<tt>GapWidth (hosszú egész szám)</tt>:százalékos arány, amely megadja, milyen távolság lehet a különböző sávcsoportok között (100%: a távolság megegyezik egy sáv szélességével).

== Rácsvonalak ==

Az elsődleges tengelyek által meghatározott rácsvonalak megjeleníthetők, amelyek megfelelnek a fő- és albeosztásnak.
A <tt>Diagram</tt> objektum a következő tulajdonságokkal rendelkezik a rácsvonalak eléréséhez:

;<tt>HasXAxisGrid (logikai érték)</tt>:aktiválja az X tengely fő vezetőrácsát.
;<tt>XMainGrid (objektum)</tt>:az X tengely fő vezetőrácsáról részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartGrid</idl> szolgáltatást).
;<tt>HasXAxisHelpGrid (logikai érték)</tt>:aktiválja az X tengely segédrácsát.
;<tt>XHelpGrid (objektum)</tt>:az X tengely segédrácsáról részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartGrid</idl> szolgáltatást).

Ugyanez y és z tengelyekre:

;<tt>HasYAxisGrid (logikai érték)</tt>:aktiválja az Y tengely fő vezetőrácsát.
;<tt>YMainGrid (objektum)</tt>:az Y tengely fő vezetőrácsáról részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartGrid</idl> szolgáltatást).
;<tt>HasYAxisHelpGrid (logikai érték)</tt>:aktiválja az Y tengely segédrácsát.
;<tt>YHelpGrid (objektum)</tt>:az Y tengely segédrácsáról részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartGrid</idl> szolgáltatást).

;<tt>HasZAxisGrid (logikai érték)</tt>:aktiválja a Z tengely fő vezetőrácsát.
;<tt>ZMainGrid (objektum)</tt>:az Z tengely fő vezetőrácsáról részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartGrid</idl> szolgáltatást).
;<tt>HasZAxisHelpGrid (logikai érték)</tt>:aktiválja a Z tengely segédrácsát.
;<tt>ZHelpGrid (objektum)</tt>:a Z tengely segédrácsáról részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartGrid</idl> szolgáltatást).

A rács objektum a <idl>com.sun.star.chart.ChartGrid</idl> szolgáltatáson alapul, amely viszont a <idl>com.sun.star.drawing.LineStyle</idl> szolgáltatás vonaltulajdonságait támogatja (lásd: [[Documentation/BASIC_Guide/Drawings_Presentations|Rajzok és bemutatók]]).

== Tengelyfeliratok ==

Minden tengelyhez megjeleníthető egy további tengelyfelirat is.
A <tt>Diagram</tt> objektum a következő tulajdonságokkal rendelkezik a tengelyfeliratok eléréséhez:

;<tt>HasXAxisTitle (logikai érték)</tt>:aktiválja az X tengely feliratát.
;<tt>XAxisTitle (objektum)</tt>:az X tengely feliratáról részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartTitle</idl> szolgáltatást).

Ugyanez y és z tengelyekre:

;<tt>HasYAxisTitle (logikai érték)</tt>:aktiválja az Y tengely feliratát.
;<tt>YAxisTitle (objektum)</tt>:az Y tengely feliratáról részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartTitle</idl> szolgáltatást).

;<tt>HasZAxisTitle (logikai érték)</tt>:aktiválja a Z tengely feliratát.
;<tt>ZAxisTitle (objektum)</tt>:a Z tengely feliratáról részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartTitle</idl> szolgáltatást).

Végül a másodlagos tengelyekre (az OpenOffice.org 3.0 óta érhetők el):

;<tt>HasSecondaryXAxisTitle (logikai érték)</tt>:aktiválja a másodlagos X tengely feliratát.
;<tt>SecondXAxisTitle (objektum)</tt>:a másodlagos X tengely feliratáról részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartTitle</idl> szolgáltatást).

;<tt>HasSecondaryYAxisTitle (logikai érték)</tt>:aktiválja a másodlagos Y tengely feliratát.
;<tt>SecondYAxisTitle (objektum)</tt>:a másodlagos Y tengely feliratáról részletes adatokat tartalmazó objektum (támogatja a <idl>com.sun.star.chart.ChartTitle</idl> szolgáltatást).

A tengelyfelirat formázására szolgáló objektumok a <idl>com.sun.star.chart.ChartTitle</idl> szolgáltatáson alapulnak, amely a diagramok címének kezelését is végzi.

=== Példa ===

A következő példa egy vonaldiagramot hoz létre. A diagramháttér színe fehérre van állítva. Az X és az Y tengelynek is szürke a segédrácsa a jobb láthatóság kedvéért. Az Y tengely minimális értéke 0-ra van állítva, a maximális értéke pedig 100-ra, így a diagram felbontása változatlan marad még akkor is, ha az értékek módosulnak. Az X tengely pontjai fordított irányban vannak, jobbról balra. Az X tengelynek van felirata.

<source lang="oobas">
Dim Doc As Object
Dim Charts As Object
Dim Chart as Object
Dim Rect As New com.sun.star.awt.Rectangle
Dim RangeAddress(0) As New com.sun.star.table.CellRangeAddress

Doc = StarDesktop.CurrentComponent
Charts = Doc.Sheets(0).Charts

Rect.X = 8000
Rect.Y = 1000
Rect.Width = 10000
Rect.Height = 7000
RangeAddress(0).Sheet = 0
RangeAddress(0).StartColumn = 0
RangeAddress(0).StartRow = 0
RangeAddress(0).EndColumn = 2
RangeAddress(0).EndRow = 12

Charts.addNewByName("MyChart", Rect, RangeAddress(), True, True)
Chart = Charts.getByName("MyChart").embeddedObject
Chart.Diagram = Chart.createInstance("com.sun.star.chart.LineDiagram")
Chart.Diagram.Wall.FillColor = RGB(255, 255, 255)
Chart.Diagram.HasXAxisGrid = True
Chart.Diagram.XMainGrid.LineColor = RGB(192, 192, 192)
Chart.Diagram.HasYAxisGrid = True
Chart.Diagram.YMainGrid.LineColor = RGB(192, 192, 192)
Chart.Diagram.YAxis.Min = 0
Chart.Diagram.YAxis.Max = 100

Chart.Diagram.XAxis.ReverseDirection = true 'OpenOffice.org 2.4 vagy újabb szükséges
Chart.Diagram.HasXAxisTitle = true
Chart.Diagram.XAxisTitle.String = "Példa fordított X tengelyre"
</source>

== Térbeli diagramok ==

Az {{OOo}} legtöbb diagramja megjeleníthető térbeli grafikával is. A térbeli diagramokhoz a <tt>Diagram</tt> objektumon keresztül a következő tulajdonságok érhetők el:

;<tt>Dim3D (logikai érték)</tt>:aktiválja a térhatású megjelenítést.
;<tt>Deep (logikai érték)</tt>:a sorozatok egymás mögé lesznek rendezve Z irányban.
;<tt>RightAngledAxes (logikai érték)</tt>:aktiválja a térbeli megjelenítést úgy, hogy az X és Y tengelyek derékszöget zárjanak be a síkba vetítéskor. (Az OpenOffice.org 2.3 óta érhető el.)
;<tt>D3DScenePerspective (enumeráció)</tt>:meghatározza, hogy a térbeli objektumokat perspektivikusan vagy axonometrikusan kell-e megrajzolni (az értékek a <idl>com.sun.star.drawing.ProjectionMode</idl> tulajdonságának megfelelően)
;<tt>Perspective (hosszú egész szám)</tt>:a térbeli diagramok perspektívája ( [0,100] ) (az OpenOffice.org 2.4.1-ben jelent meg)
;<tt>RotationHorizontal (hosszú egész szám)</tt>:a térbeli diagramok vízszintes elforgatása ( [-180,180] ) (az OpenOffice.org 2.4.1-ben jelent meg)
;<tt>RotationVertical (hosszú egész szám)</tt>:a térbeli diagramok függőleges elforgatása ( [-180,180] ) (az OpenOffice.org 2.4.1-ben jelent meg)

A következő példa egy térbeli területdiagramot hoz létre.

<source lang="oobas">
Dim Doc As Object
Dim Charts As Object
Dim Chart as Object
Dim Rect As New com.sun.star.awt.Rectangle
Dim RangeAddress(0) As New com.sun.star.table.CellRangeAddress

Doc = StarDesktop.CurrentComponent
Charts = Doc.Sheets(0).Charts

Rect.X = 8000
Rect.Y = 1000
Rect.Width = 10000
Rect.Height = 7000
RangeAddress(0).Sheet = 0
RangeAddress(0).StartColumn = 0
RangeAddress(0).StartRow = 0
RangeAddress(0).EndColumn = 2
RangeAddress(0).EndRow = 12

Charts.addNewByName("MyChart", Rect, RangeAddress(), True, True)
Chart = Charts.getByName("MyChart").embeddedObject
Chart.Diagram = Chart.createInstance("com.sun.star.chart.AreaDiagram")
Chart.Diagram.Dim3D = true
Chart.Diagram.Deep = true
Chart.Diagram.RightAngledAxes = true 'OpenOffice.org 2.3 vagy újabb szükséges
Chart.Diagram.D3DScenePerspective = com.sun.star.drawing.ProjectionMode.PERSPECTIVE
Chart.Diagram.Perspective = 100 'OpenOffice.org 2.4.1 vagy újabb szükséges
Chart.Diagram.RotationHorizontal = 60 'OpenOffice.org 2.4.1 vagy újabb szükséges
Chart.Diagram.RotationVertical = 30 'OpenOffice.org 2.4.1 vagy újabb szükséges
</source>

== Halmozott diagramok ==

A halmozott diagramok olyan diagramok, amelyekben több érték van egymáson megjelenítve, és így adják meg a végösszeget. Ez a típus nem csak az egyes értékeket jeleníti meg, hanem áttekintést nyújt az értékek összegéről is.

Az {{OOo}} számos diagramja megjeleníthető halmozott formában. Ezek mindegyike támogatja a <idl>com.sun.star.chart.StackableDiagram</idl> szolgáltatást, amely viszont a következő tulajdonságokat biztosítja:

;<tt>Stacked (logikai érték)</tt>:a halmozott megjelenítési mód aktiválása.
;<tt>Percent (logikai érték)</tt>:az abszolút értékek helyett százalékos megjelenítés.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Structure of Charts}}
{{PDL1}}

HU/Documentation/BASIC Guide/Strings (Runtime Library)

2009-05-15T14:39:08Z

Timarandras: New page: {{HU/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=HU/Documentation/BASIC Guide/Conversion Functions (Runtime Library) |NextPage=HU/Documentation/BASIC G...

{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Conversion Functions (Runtime Library)
|NextPage=HU/Documentation/BASIC Guide/Date and Time (Runtime Library)
|runtime=block
}}
{{DISPLAYTITLE:Karakterláncok ({{OOo}} futásidejű programkönyvtár)}}
__NOTOC__
== Karakterkészletekkel végzett munka ==

Karakterláncok kezelésénél az {{OOo}} Basic a Unicode karakterkészletet használja. Az <tt>Asc</tt> és a <tt>Chr</tt> függvénnyel megállapítható egy karakter Unicode-értéke és/vagy megállapítható egy Unicode-érték karaktere. A következő kifejezések különböző Unicode-értékeket rendelnek a Kod változóhoz:

<source lang="oobas">
Kod = Asc("A") ' Latin A betű (Unicode-érték: 65)
Kod = Asc("€") ' Euró karakter (Unicode-érték: 8364)
Kod = Asc("Л") ' Cirill Л betű (Unicode-érték: 1083)
</source>

Ennek megfelelően a

<source lang="oobas">
SajatKarakterlanc = Chr(13)
</source>

kifejezés a <tt>SajatKarakterlanc</tt> változóhoz a <tt>13</tt>-as karaktert rendeli, amely a sortörés kódja.

A <tt>Chr</tt> parancsot gyakran használják Basic-programokban vezérlőkarakterek karakterláncokba történő beszúrásához. A

<source lang="oobas">
SajatKarakterlanc = Chr(9) + "Ez egy teszt." + Chr(13)
</source>

kifejezésben a szöveget egy tabulátorkarakter (Unicode-érték: 9) előzi meg, és egy sortörés (Unicode-érték: 13) lesz utána.

== Hozzáférés a karakterlánc részeihez ==

Az {{OOo}} Basic három függvényt biztosít a karakterláncok részeinek kezeléséhez, plusz egyet a hossz megállapításához:

;<tt>Left(Karakterlánc, Hossz)</tt>:visszaadja a <tt>Karakterlánc</tt> első <tt>Hossz</tt> darab karakterét.
;<tt>Right(Karakterlánc, Hossz)</tt>:visszaadja a <tt>Karakterlánc</tt> utolsó <tt>Hossz</tt> darab karakterét.
;<tt>Mid(Karakterlánc, Kezdet, Hossz)</tt>:visszaadja a <tt>Karakterlánc</tt> <tt>Hossz</tt> darab karakterét a <tt>Kezdet</tt> pozíciótól.
;<tt>Len(Karakterlánc)</tt>:visszaadja a <tt>Karakterlánc</tt> karaktereinek számát.

Az előbb említett függvényekre láthatunk példát az alábbiakban:

<source lang="oobas">
Dim MyString As String
Dim MyResult As String
Dim MyLen As Integer

MyString = "Ez egy teszt"
MyResult = Left(MyString,5) ' Az "Ez egy" karakterláncot adja vissza.
MyResult = Right(MyString, 5) ' A "teszt" karakterláncot adja vissza.
MyResult = Mid(MyString, 4, 5) ' Az "egy te" karakterláncot adja vissza.
MyLen = Len(MyString) ' A 12-t adja vissza.
</source>

== Keresés és csere ==

Az {{OOo}} Basic rendelkezik egy <tt>InStr</tt> függvénnyel egy karakterlánc másik karakterláncban történő megkereséséhez:

<source lang="oobas">
ResultString = InStr (SearchString, MyString)
</source>

A <tt>SearchString</tt> paraméter a keresendő karakterlánc, amelyet meg akarunk találni a <tt>MyString</tt> karakterláncban. A függvény visszaad egy számot, ahol a <tt>SearchString</tt> először megtalálható a <tt>MyString</tt> karakterláncban. Ha a karakterláncnak másik előfordulását akarjuk megtalálni, a függvény lehetőséget biztosít, hogy megadjunk egy kezdőpozíciót, ahonnan az {{OOo}} Basic elkezdi a keresést. Ebben az esetben a függvény szintaxisa a következő:

<source lang="oobas">
ResultString = InStr(StartPosition, MyString, SearchString)
</source>

Ez előző példában az <tt>InStr</tt> nem különböztette meg a kis- és nagybetűket. Ha azt akarjuk, hogy az <tt>InStr</tt> megkülönböztesse a kis- és nagybetűket, akkor adjuk a függvényhez a <tt>0</tt> paramétert, ahogy az a következő példában látható:

<source lang="oobas">
ResultString = InStr(MyString, SearchString, 0)
</source>

Az előző függvényekkel a programozók megkereshetnek és lecserélhetnek egy karakterláncot egy másikban:

<source lang="oobas">
Function Replace(Source As String, Search As String, NewPart As String)
Dim Result As String
Dim StartPos As Long
Dim CurrentPos As Long

Result = ""
StartPos = 1
CurrentPos = 1

If Search = "" Then
Result = Source
Else
Do While CurrentPos <> 0
CurrentPos = InStr(StartPos, Search, Source)
If CurrentPos <> 0 Then
Result = Result + Mid(Source, StartPos, _
CurrentPos - StartPos)
Result = Result + NewPart
StartPos = CurrentPos + Len(Search)
Else
Result = Result + Mid(Source, StartPos, Len(Source))
End If ' Position <> 0
Loop
End If

Replace = Result
End Function
</source>

A függvény megkeresi a <tt>Search</tt> karakterláncot az <tt>InStr</tt> függvény használatával a <tt>Source</tt> karakterláncban. Ha a függvény megtalálja a keresett szöveget, akkor az adott szöveg előtti részt a <tt>Result</tt> visszatérési pufferbe menti. Ezután hozzáadja a <tt>NewPart</tt> karakterláncot a <tt>Search</tt> karakterlánc helyén. Ha nincs több találat, akkor a függvény a karakterláncból hátralévő részt hozzáadja a visszatérési pufferhez. Ezután visszaadja az így létrehozott karakterláncot a cserefolyamat eredményeként.

Mivel a karakterláncok egy részének lecserélése az egyik leggyakoribb feladat, azért a <tt>Mid</tt> függvény ki van bővítve az {{OOo}} Basic programban, így ezt automatikusan el tudja végezni. A következő példa lecserél három karaktert a <tt>volt</tt> szóra a <tt>MyString</tt> karakterlánc negyedik karakterétől.

<source lang="oobas">
Dim MyString As String

MyString = "Ez itt az én szövegem."
Mid(MyString, 4, 3, "volt")
</source>

== Karakterláncok formázása ==

A <tt>Format</tt> függvény a számokat karakterláncként formázza. Ehhez meg kell adnunk egy <tt>Format</tt> formázási kifejezést, amelyet a program sablonként használ a számok formázásához. A sablonban minden helyfoglaló meghatározza a kimenet egy adott karakterét. A sablon öt legfontosabb helyfoglaló karaktere a nulla (<tt>0</tt>), a kettőskereszt (<tt>#</tt>), a pont (<tt>.</tt>), a vessző (<tt>,</tt>) és a dollárjel (<tt>$</tt>).

A <tt>0</tt> karakter a sablonban biztosítja, hogy egy adott szám a megfelelő helyre kerüljön. Ha nincs megadva szám, akkor 0 jelenik meg helyette.

A <tt>.</tt> helyett az operációs rendszer területi beállításainak megfelelő tizedesjel jelenik meg.

Az alábbi példa bemutatja, hogyan adhatók meg a tizedesjel utáni számjegyek a <tt>0</tt> és a <tt>.</tt> használatával:

<source lang="oobas">
MyFormat = "0.00"
MyString = Format(-1579.8, MyFormat) ' -1579,80 lesz az eredmény
MyString = Format(1579,8, MyFormat) ' 1579,80 lesz az eredmény
MyString = Format(0,4, MyFormat) ' 0,40 lesz az eredmény
MyString = Format(0,434, MyFormat) ' 0,43 lesz az eredmény
</source>

Ehhez hasonlóan kezdő nullák adhatók hozzá a számhoz a kívánt hossz eléréséhez:

<source lang="oobas">
MyFormat = "0000.00"
MyString = Format(-1579.8, MyFormat) ' -1579,80 lesz az eredmény
MyString = Format(1579,8, MyFormat) ' 1579,80 lesz az eredmény
MyString = Format(0.4, MyFormat) ' 0000,40 lesz az eredmény
MyString = Format(0.434, MyFormat) ' 0000,43 lesz az eredmény
</source>

A <tt>,</tt> az operációs rendszer által ezreselválasztóként használt karaktert helyettesíti, és a <tt>#</tt> olyan számjegyet vagy helyet jelöl, amely csak akkor jelenik meg, ha szükség van rá.

<source lang="oobas">
MyFormat = "#,##0.00"
MyString = Format(-1579.8, MyFormat) ' -1 579,80 lesz az eredmény
MyString = Format(1579,8, MyFormat) ' 1 579,80 lesz az eredmény
MyString = Format(0,4, MyFormat) ' 0,40 lesz az eredmény
MyString = Format(0,434, MyFormat) ' 0,43 lesz az eredmény
</source>

A <tt>$</tt> helyén a <tt>Format</tt> függvény a rendszer pénznemjelét jeleníti meg (ebben a példában feltettük, hogy Magyarország van beállítva):

<source lang="oobas">
MyFormat = "#,##0.00 $"
MyString = Format(-1579.8, MyFormat) ' -1 579,80 Ft lesz az eredmény
MyString = Format(1579,8, MyFormat) ' 1 579,80 Ft lesz az eredmény
MyString = Format(0,4, MyFormat) ' 0,40 Ft lesz az eredmény
MyString = Format(0,434, MyFormat) ' 0,43 Ft lesz az eredmény
</source>

A VBA-ban használt dátum- és időformázási utasítások szintén használhatóak:

<source lang="oobas">
Sub Main
Dim MyDate As Date
MyDate = "01/06/98"
TestStr = Format(MyDate, "mm-dd-yyyy") ' 01-06-1998
MsgBox TestStr
End Sub
</source>

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Strings (Runtime Library)}}
{{PDL1}}

HU/Documentation/BASIC Guide/Strings

2009-05-15T14:38:51Z

Timarandras: New page: {{DISPLAYTITLE:String (karakterlánc) változók}} {{HU/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=HU/Documentation/BASIC Guide/Working With Variables...

{{DISPLAYTITLE:String (karakterlánc) változók}}
{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Working With Variables
|NextPage=HU/Documentation/BASIC Guide/Numbers
|lang=block
}}
__NOTOC__
A string (karakterlánc) típusú változók és a számok a legfontosabb alaptípusok az {{OOo}} Basicben. Egy string (karakterlánc) karakterek egymás utáni sorozatából áll. A számítógép a string (karakterlánc) változókat számsorozatként menti, ahol minden szám egy adott karakternek felel meg.

==Az ASCII karakterkészlettől a Unicode-ig==

A karakterkészletek egy karakterlánc karaktereinek egy táblázatban található kódot feleltetnek meg, amely leírja, hogyan jelenítse meg a számítógép az adott karakterláncot.

===Az ASCII karakterkészlet===

Az ASCII karakterkészlet egy olyan kódkészlet, amely a számokat, karaktereket és speciális jeleket egy bájton tárolja. A 0-tól 127-ig terjedő ASCII-kódok az ábécé betűinek és néhány gyakori jelnek felelnek meg (például százalék, zárójel, vessző), valamint néhány képernyő- és nyomtató-vezérlőkódnak. Az ASCII karakterkészlet általánosan használt a két számítógép közötti adatátvitelben.

Viszont ez a karakterkészlet nem tartalmaz számos speciális, Európában használt karaktert, például az á, ä és í betűt, valamint az egyéb karakterformátumokat, például a cirill betűket.

===Az ANSI karakterkészlet===

A Microsoft a Windows rendszert az American National Standards Institute (ANSI) karakterkészletére alapozta, amelyet fokozatosan bővítettek, hogy tartalmazza az ASCII karakterkészletből hiányzó karaktereket.

===Kódlapok===

Az ISO 8859 karakterkészlet egy nemzetközi szabvány. Az ISO karakterkészlet első 128 karaktere megfelel az ASCII karakterkészletnek. Az ISO szabvány új karakterkészleteket ('''kódlapokat''' ) vezetett be, így már több nyelvet is helyesen meg lehet jeleníteni. Viszont így ugyanaz a karakterérték más karaktert jelent a különböző nyelveken.

===Unicode===

A Unicode megnövelte a karakterek hosszát négy bájtra, és a különböző karakterkészletek kombinálásával hoz létre egy szabványt, amely a lehető legtöbb nyelvet képes megjeleníteni. A Unicode 2.0-s verzióját már számos program támogatja – többek közt az {{OOo}} és az {{OOo}} Basic.

==String (karakterlánc) változók==

Az {{OOo}} Basic a karakterláncokat string (karakterlánc) típusú változókban tárolja, Unicode-ban. Egy string (karakterlánc) változó maximum 65535 karaktert tárolhat. A belső tárolásnál az {{OOo}} Basic minden karakter Unicode-értékét tárolja. A string (karakterlánc) változókhoz szükséges memória az adott karakterlánc hosszától függ.

Példa string (karakterlánc) változó deklarálására:

<source lang="oobas">
Dim Valtozo As String
</source>

Ez a deklaráció a következő módon is megírható:

<source lang="oobas">
Dim Valtozo$
</source>

{{Documentation/Note|A VBA-alkalmazások átalakításakor figyeljünk arra, hogy az {{OOo}} Basicben a string (karakterlánc) változó hossza legfeljebb 65535 karakter lehet.}}

==Explicit karakterláncok megadása==

Ha egy adott karakterláncot akarunk egy string (karakterlánc) változóhoz rendelni, a karakterláncot tegyük idézőjelbe.

<source lang="oobas">
Dim SajatKarakterlanc As String
SajatKarakterlanc = "Ez egy teszt."
</source>

Ha a karakterláncot két sorban akarjuk írni, akkor írjuk egy & jelet az első sor végére:

<source lang="oobas">
Dim SajatKarakterlanc As String
SajatKarakterlanc = "Ez a karakterlánc olyan hosszú," & _
"hogy csak két sorba fér ki."
</source>

Ha idézőjelet (") akarunk a karakterláncban használni, írjuk be azt kétszer az adott helyre:

<source lang="oobas">
Dim SajatKarakterlanc As String
SajatKarakterlanc = "ők a ""nagy öreg"" programozók" ' idézőjelet jelenít meg a szövegben
</source>

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Strings}}
{{PDL1}}

HU/Documentation/BASIC Guide/StarDesktop

2009-05-15T14:38:16Z

Timarandras: /* Fájlnevek URL-jelölésben */

{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Documents
|NextPage=HU/Documentation/BASIC Guide/Templates
|docs=block
}}
{{DISPLAYTITLE:A StarDesktop}}
__NOTOC__
Amikor dokumentumokkal dolgozunk, leggyakrabban két szolgáltatást használunk:

* Az egyik a <idl>com.sun.star.frame.Desktop</idl> szolgáltatás, amely hasonlít az {{OOo}} főszolgáltatására. Ez a szolgáltatás biztosítja az {{OOo}} keretobjektumának funkcióit, amely alá tartozik az összes dokumentumablak. A dokumentumok is ezzel az objektummal hozhatók létre, nyithatók meg és importálhatók.
* A másik szolgáltatás az egyes dokumentumobjektumok alapfunkcionalitását biztosító <idl>com.sun.star.document.OfficeDocument</idl>. Ez a szolgáltatás biztosítja a dokumentumok mentését, exportálását és nyomtatását végző metódusokat.

A <idl>com.sun.star.frame.Desktop</idl> szolgáltatás automatikusan létrejön az {{OOo}} indításakor. Ezt a szolgáltatást az {{OOo}} Basicben a <tt>StarDesktop</tt> globális név használatával címezhetjük meg.

A <tt>StarDesktop</tt> legfontosabb felülete a <idl>com.sun.star.frame.XComponentLoader</idl>. Ez tulajdonképpen a <tt>loadComponentFromURL</tt> metódust fedi le, amely felelős a dokumentumok létrehozásáért, importálásáért és megnyitásáért.

A <tt>StarDesktop</tt> objektum neve a StarOffice 5 programból származik, ahol minden dokumentumablak egyetlen közös, <tt>StarDesktop</tt> nevű alkalmazásba volt beágyazva. Az {{OOo}} jelenlegi verziójában a látható <tt>StarDesktop</tt> objektum már nem használt. Ennek ellenére a <tt>StarDesktop</tt> név megmaradt az {{OOo}} keretobjektuma számára, mert ez egyértelműen jelzi, hogy ez a teljes alkalmazás keretobjektuma.

A <tt>StarDesktop</tt> objektum a StarOffice 5 <tt>Application</tt> objektumának szerepét tölti be, amely a régebbi verzióban a gyökérobjektum volt. De a régi <tt>Application</tt> objektummal ellentétben a <tt>StarDesktop</tt> elsődlegesen az új dokumentumok megnyitásáért felelős. A régi <tt>Application</tt> objektumban megtalálható, az {{OOo}} megjelenítését végző függvények (például a <tt>FullScreen</tt>, <tt>FunctionBarVisible</tt>, <tt>Height</tt>, <tt>Width</tt>, <tt>Top</tt>, <tt>Visible</tt>) már nem használtak.

{{Documentation/Note|Míg Wordben az aktív dokumentumot az <tt>Application.ActiveDocument</tt> objektumon keresztül lehet elérni, és Excelben az <tt>Application.ActiveWorkbook</tt> objektummal, addig az {{OOo}} programban a <tt>StarDesktop</tt> felelős ezért. Az {{OOo}} programban a dokumentumobjektum a <tt>StarDesktop.CurrentComponent</tt> tulajdonsággal vagy a <tt>ThisComponent</tt> segítségével érhető el.}}

== ThisComponent ==
A <tt>ThisComponent</tt> globális név általában ugyanazt az objektumot adja vissza, mint a <tt>StarDesktop.CurrentComponent</tt>, de van egy fontos előnye. Ha a BASIC IDE-ben dolgozunk a makró futtatása, hibakeresése vagy böngészése közben, akkor a <tt>StarDesktop</tt> a BASIC IDE-t adja vissza. Ez valószínűleg nem az, amit szeretnénk. A <tt>ThisComponent</tt> az utoljára aktív dokumentumot adja vissza.

== Alapvető információk az {{OOo}}-dokumentumokról ==

Az{{OOo}}-dokumentumokkal végzett munka során hasznos lehet, ha ismerjük a dokumentumok alapvető kezelését az {{OOo}} programban. Ez magában foglalja az {{OOo}}-dokumentumok fájlnevei strukturálásának módját, akárcsak a nem mentett fájlok formátumát.

=== Fájlnevek URL-jelölésben ===

Mivel az {{OOo}} egy platformfüggetlen alkalmazás, ezért URL-jelölést használ (amely független az operációs rendszertől), amely a fájlnevekről szóló RFC 1738-as internetszabványban van definiálva. A fájlnevek ebben a rendszerben a <tt>file:///</tt> előtaggal kezdődnek, amelyet a helyi elérési út követ. Ha a fájlnév alkönyvtárakat tartalmaz, akkor ezek törtjellel elválasztva szerepelnek, és nem fordított törtjellel, ahogy azt a Windows használja általában. A következő elérési út a C: meghajtó doc könyvtárának <tt>test.odt</tt> fájljára hivatkozik.

file:///C:/doc/test.odt

A helyi fájlnevek URL-lé történő konvertálásához az {{OOo}} a <tt>ConvertToUrl</tt> függvényt biztosítja. Egy URL helyi fájlnévvé történő konvertálásához az {{OOo}} a <tt>ConvertFromUrl</tt> függvényt biztosítja.

<source lang="oobas">
MsgBox ConvertToUrl("C:\doc\test.odt")
' a file:///C:/doc/test.odt elérési utat jeleníti meg
MsgBox ConvertFromUrl("file:///C:/doc/test.odt")
' a c:\doc\test.odt elérési utat jeleníti meg (Windows alatt)
</source>

Ez a példa konvertálja a helyi fájlnevet URL-lé, és megjeleníti azt egy üzenetablakban. Ezután konvertálja az URL-t helyi fájlnévvé, és azt is megjeleníti.

Az RFC 1738-as internetszabvány, amelyen ez alapul, a <tt>0-9</tt>, <tt>a-z</tt> és <tt>A-Z</tt> karakterek használatát engedélyezi. Az összes többi karakter vezérlőkódként lesz beszúrva az URL-ekbe. Ehhez át lesznek konvertálva az UTF-8 kódolás szerinti hexadecimális értékükre, és egy százalékjel előzi meg őket. Például a szóköz a fájlnevekben a <tt>%20</tt> karakterláncra lesz konvertálva az URL-ekben.

=== Az XML fájlformátum ===

Az {{OOo}}-dokumentumokat az XML fájlformátumon alapulnak. Az XML-alapú fájlok más programokkal is megnyithatók és szerkeszthetők.

=== Fájlok tömörítése ===

Mivel az XML normál szövegfájlokon alapul, az eredmény általában meglehetősen nagy méretű. Éppen ezért az {{OOo}} tömöríti a fájlokat, és ZIP-fájlként menti őket. A <tt>storeAsURL</tt> metódus használatával lehetőség van közvetlenül az eredeti XLM-fájlok mentésére. Lásd alább: [[HU/Documentation/BASIC Guide/StarDesktop#storeAsURL Method Options|storeAsURL metódus]].

== Dokumentumok létrehozása, megnyitása és importálása ==

A dokumentumok megnyitását, importálását és létrehozását a következő metódus végzi

<source lang="oobas">
StarDesktop.loadComponentFromURL(URL, Frame, SearchFlags, FileProperties)
</source>

A <tt>loadComponentFromURL</tt> első paramétere az adott fájl URL-jét adja meg.

Második paraméterként a <tt>loadComponentFromURL</tt> az {{OOo}} által belsőleg létrehozott ablak keretobjektumának a nevét várja. Általában ez az előre definiált <tt>_blank</tt> név, amelynek hatására az {{OOo}} egy új ablakot hoz létre. Megadható még a <tt>_hidden</tt> név is, amely lehetővé teszi, hogy az adott dokumentum betöltődjön, de rejtve maradjon.

Ezekkel a paraméterekkel a felhasználó megnyithat egy {{OOo}}-dokumentumot, mert az utolsó két paraméterként helyfoglalók (üres értékek) is megadhatók:

<source lang="oobas">
Dim Doc As Object
Dim Url As String
Dim Dummy() 'A PropertyValues (tulajdonságértékek) üres tömbje

Url = "file:///C:/test.odt"

Doc = StarDesktop.loadComponentFromURL(Url, "_blank", 0, Dummy)
</source>

Ez a metódushívás megnyitja a <tt>text.odt</tt> fájlt, és megjeleníti egy új ablakban.

Tetszőleges számú dokumentum megnyitható így az {{OOo}} Basicben, majd szerkeszthető a visszaadott dokumentumobjektum használatával.

{{Documentation/Note|A <tt>StarDesktop.loadComponentFromURL</tt> metódus leváltotta a régi {{OOo}} API <tt>Documents.Add</tt> és <tt>Documents.Open</tt> metódusát.}}

=== A dokumentumablak tartalmának lecserélése ===

A <tt>_blank</tt> és a <tt>_hidden</tt> érték a <tt>Frame</tt> paraméterben azt eredményezi, hogy az {{OOo}} új ablakot hoz létre a <tt>loadComponentFromURL</tt> minden meghívásakor. Néhányszor hasznos lehet egy meglévő ablak tartalmának lecserélése. Ebben az esetben az ablak keretobjektumának egy nevet kell tartalmaznia. Ez a név nem kezdődhet aláhúzással. Ezenfelül a <tt>SearchFlags</tt> paramétert úgy kell beállítani, hogy a megfelelő keretobjektum létrejöjjön, ha még nincs létrehozva. A <tt>SearchFlags</tt> megfelelő állandója a következő:

<source lang="oobas">
SearchFlags = com.sun.star.frame.FrameSearchFlag.CREATE + _
com.sun.star.frame.FrameSearchFlag.ALL
</source>

A következő példa bemutatja, hogyan cserélhető le egy megnyitott ablak tartalma a keretparaméter és a <tt>SearchFlags</tt> használatával:

<source lang="oobas">
Dim Doc As Object
Dim Dummy()
Dim Url As String
Dim SearchFlags As Long

SearchFlags = com.sun.star.frame.FrameSearchFlag.CREATE + _
com.sun.star.frame.FrameSearchFlag.ALL
Url = "file:///C:/test.odt"
Doc = StarDesktop.loadComponentFromURL(Url, "SajátKeret", SearchFlags, Dummy)
MsgBox "Nyomja meg az OK gombot a második dokumentum megjelenítéséhez."

Url = "file:///C:/test2.odt"
Doc = StarDesktop.loadComponentFromURL(Url, "SajátKeret", _
SearchFlags, Dummy)
</source>

Ez a példa először megnyitja a <tt>test.odt</tt> fájlt egy új, <tt>SajátKeret</tt> nevű ablakban. Ha a felhasználó jóváhagyja az üzenetpanelt, a program lecseréli az ablak tartalmát a <tt>test2.odt</tt> fájllal.

=== A loadComponentFromURL metódus lehetőségei ===

A <tt>loadComponentFromURL</tt> metódus negyedik paramétere egy <tt>PropertyValue</tt> adatmező, amely az {{OOo}} számára számos lehetőséget biztosít dokumentumok megnyitásához és létrehozásához. Az adatmezőnek biztosítania kell egy <tt>PropertyValue</tt> struktúrát minden lehetőséghez, amelyben a lehetőség neve van mentve karakterláncként, valamint a hozzá tartozó érték.

A <tt>loadComponentFromURL</tt> a következő lehetőségeket támogatja:

;<tt>AsTemplate (logikai érték)</tt>:ha true (igaz), akkor betölt egy új, névtelen dokumentumot a megadott URL-ről. Ha false (hamis), akkor sablonfájlokat tölt be szerkesztéshez.
;<tt>CharacterSet (karakterlánc)</tt>:megadja, milyen karakterkészleten alapul a dokumentum.
;<tt>FilterName (karakterlánc)</tt>:megad egy speciális szűrőt a <tt>loadComponentFromURL</tt> függvény számára. Az elérhető szűrőnevek a <tt>\share\config\registry\instance\org\openoffice\office\TypeDetection.xml</tt> fájlban vannak definiálva.
;<tt>FilterOptions (karakterlánc)</tt>:további lehetőségeket definiált a szűrők számára.
;<tt>JumpMark (karakterlánc)</tt>:amikor egy dokumentum megnyílik, a program a JumpMark által megadott helyre ugrik.
;<tt>Password (karakterlánc)</tt>:átad egy jelszót egy védett fájlnak.
;<tt>ReadOnly (logikai érték)</tt>:betölt egy csak olvasható dokumentumot.

A következő példa bemutatja, hogyan nyitható meg egy vesszővel elválasztott fájl az {{OOo}} Calc programban a <tt>FilterName</tt> használatával.

<source lang="oobas">
Dim Doc As Object
Dim FileProperties(1) As New com.sun.star.beans.PropertyValue
Dim Url As String

Url = "file:///C:/doc.csv"
FileProperties(0).Name = "FilterName"
FileProperties(0).Value ="Text - txt - csv (StarCalc)"
FileProperties(1).Name = "FilterOptions"
FileProperties(1).value = "44,34,0,1"

Doc = StarDesktop.loadComponentFromURL(Url, "_blank", 0, FileProperties())
</source>

A <tt>FileProperties</tt> adatmező csak egyetlen értéket fed le, mivel csak egy lehetőséget tartalmaz. A <tt>Filtername</tt> tulajdonság megadja, hogy az {{OOo}} egy {{OOo}} Calc-szövegszűrőt használjon-e a fájlok megnyitásához.

=== Új dokumentumok létrehozása ===

Az {{OOo}} automatikusan létrehoz egy új dokumentumot, ha az URL-ben megadott dokumentum egy sablon.

Ha viszont csak egy üres dokumentumra van szükségünk mindenféle igazítás nélkül, akkor megadhatjuk a <tt>private:factory</tt> URL-t:

<source lang="oobas">
Dim Dummy()
Dim Url As String
Dim Doc As Object

Url = "private:factory/swriter"
Doc = StarDesktop.loadComponentFromURL(Url, "_blank", 0, Dummy())
</source>

Ez a metódushívás létrehoz egy üres {{OOo}} Writer-dokumentumot.

== Dokumentumobjektumok ==

Az előző részben bemutatott <tt>loadComponentFromURL</tt> függvény egy dokumentumobjektumot ad vissza. Ez támogatja a <idl>com.sun.star.document.OfficeDocument</idl> szolgáltatást, amely viszont két fő felületet biztosít:

* a <idl>com.sun.star.frame.XStorable</idl> felületet, amely felelős a dokumentumok mentéséért, valamint
* a <idl>com.sun.star.view.XPrintable</idl> felületet, amely tartalmazza a dokumentumok nyomtatásához szükséges metódusokat.

=== Dokumentumok mentése és exportálása ===

Az {{OOo}}-dokumentumokat közvetlenül a dokumentumobjektumon keresztül lehet menteni, A <tt>com.sun.star.frame.XStorable</tt> felület <idl>store</idl> metódusa használható erre a célra:

<source lang="oobas">
Doc.store()
</source>

Ez a metódushívás így működik, feltéve, hogy a dokumentumhoz már hozzá van rendelve egy memóriatartomány. Ez viszont nem így van új dokumentumoknál. Ebben a helyzetben a <tt>storeAsURL</tt> metódust kell használni. Ez a metódus a <idl>com.sun.star.frame.XStorable</idl> felületben is definiálva van, és a dokumentum helyének megadására használható:

<source lang="oobas">
Dim URL As String
Dim Dummy()

Url = "file:///C:/test3.odt"
Doc.storeAsURL(URL, Dummy())
</source>

Az előbbi metódusokon felül a <idl>com.sun.star.frame.XStorable</idl> felület biztosít néhány segítő metódust, amelyek hasznosak lehetnek dokumentumok mentésekor. Ezek a következők:

;<tt>hasLocation()</tt>:megadja, hogy a dokumentumhoz van-e már rendelve URL.
;<tt>isReadonly()</tt>:megadja, hogy a dokumentum csak olvasható-e.
;<tt>isModified()</tt>:megadja, hogy a dokumentumot módosították-e az utolsó mentése óta.

A dokumentum mentéséhez használt kód kiegészíthető ezekkel a lehetőségekkel, így például megadható, hogy a dokumentum csak akkor legyen mentve, ha az objektum ténylegesen módosult, és a fájlnév csak akkor legyen lekérdezve, ha arra tényleg szükség van:

<source lang="oobas">
If (Doc.isModified) Then
If (Doc.hasLocation And (Not Doc.isReadOnly)) Then
Doc.store()
Else
Doc.storeAsURL(URL, Dummy())
End If
End If
</source>

A példaprogram először ellenőrzi, hogy az adott dokumentum módosult-e az utolsó mentése óta. Csak akkor folytatja a mentési folyamatot, ha ez igaz. Ha a dokumentumhoz már hozzá van rendelve egy URL, és a dokumentum nem írásvédett, akkor a program menti a meglévő URL-lel. Ha nem rendelkezik URL-lel, vagy csak olvashatóként van megnyitva, akkor a program egy új URL-lel menti.

=== A storeAsURL metódus lehetőségei ===

Ahogy a <tt>loadComponentFromURL</tt> metódusnál is, úgy a <tt>storeAsURL</tt> metódus használatánál is megadható néhány lehetőség egy <tt>PropertyValue</tt> adatmező formájában. Ezek meghatározzák az {{OOo}} által használt dokumentummentési folyamatot. A <tt>storeAsURL</tt> metódus a következő lehetőségekkel rendelkezik:

;<tt>CharacterSet (karakterlánc)</tt>:megadja, milyen karakterkészleten alapul a dokumentum.
;<tt>FilterName (karakterlánc)</tt>:megad egy speciális szűrőt a <tt>loadComponentFromURL</tt> függvény számára. Az elérhető szűrőnevek a <tt>\share\config\registry\instance\org\openoffice\office\TypeDetection.xml</tt> fájlban vannak definiálva.
;<tt>FilterOptions (karakterlánc)</tt>:további lehetőségeket definiált a szűrők számára.
;<tt>Overwrite (logikai érték)</tt>:lehetővé teszi, hogy a program rákérdezés nélkül felülírjon egy létező fájlt.
;<tt>Password (karakterlánc)</tt>:átadja a jelszót egy védett fájlnak.
;<tt>Unpacked (logikai érték)</tt>:alkönyvtárakba menti a dokumentumot (tömörítés nélkül).

A következő példa bemutatja, hogyan használható az <tt>Overwrite</tt> lehetőség a <tt>storeAsURL</tt> metódussal együtt:

<source lang="oobas">
Dim Doc As Object
Dim FileProperties(0) As New com.sun.star.beans.PropertyValue
Dim Url As String
' ... a dokumentum inicializálása

Url = "file:///c:/test3.odt"
FileProperties(0).Name = "Overwrite"
FileProperties(0).Value = True
Doc.storeAsURL(Url, FileProperties())
</source>

Ezután a példaprogram menti a <tt>Doc</tt> objektumot a megadott fájlnévvel, ha már létezik ilyen nevű fájl.

=== Dokumentumok nyomtatása ===

A mentéshez hasonlóan a dokumentumokat közvetlenül a dokumentumobjektummal lehet kinyomtatni. A <tt>com.sun.star.view.Xprintable</tt> felület <idl>Print</idl> metódusa használható erre a célra: A legegyszerűbb formájában a nyomtatás így néz ki:

<source lang="oobas">
Dim Dummy()

Doc.print(Dummy())
</source>

Ahogy a <tt>loadComponentFromURL</tt> metódus esetében is, úgy itt is a Dummy paraméter egy <tt>PropertyValue</tt> adatmező, amelyen keresztül az {{OOo}} számos lehetőséget meg tud adni a nyomtatáshoz.

=== A print metódus lehetőségei ===

A <tt>print</tt> metódus egy <tt>PropertyValue</tt> adatmezőt vár paraméterként, amely az {{OOo}} Nyomtatás párbeszédablakának beállításait tartalmazza:

;<tt>CopyCount (egész szám)</tt>:a kinyomtatandó példányok számát adja meg.
;<tt>FileName (karakterlánc)</tt>:a megadott fájlba nyomtatja a dokumentumot.
;<tt>Collate (logikai érték)</tt>:arra utasítja a nyomtatót, hogy válogassa szét a kinyomtatott példányok lapjait.
;<tt>Sort (logikai érték)</tt>:rendezi a példányokat több példány nyomtatásánál (<tt>CopyCount</tt> > 1).
;<tt>Pages (karakterlánc)</tt>:a kinyomtatandó oldalak listáját tartalmazza (a szintaxis a Nyomtatás párbeszédablakéval azonos).

A következő példa bemutatja, hogyan nyomtatható ki több oldal a <tt>Pages</tt> lehetőséggel:

<source lang="oobas">
Dim Doc As Object
Dim PrintProperties(0) As New com.sun.star.beans.PropertyValue

PrintProperties(0).Name="Pages"
PrintProperties(0).Value="1-3; 7; 9"
Doc.print(PrintProperties())
</source>

=== Nyomtatókiválasztás és -beállítások ===

A <idl>com.sun.star.view.XPrintable</idl> felület biztosítja a <tt>Printer</tt> tulajdonságot, amely kijelöli a nyomtatót. Ez a tulajdonság egy <tt>PropertyValue</tt> adatmezőt kap a következő beállításokkal:

;<tt>Name (karakterlánc)</tt>:megadja a nyomtató nevét.
;<tt>PaperOrientation (enumeráció)</tt>:megadja a papír tájolását (a <idl>com.sun.star.view.PaperOrientation.PORTRAIT</idl> érték jelenti az álló tájolást, a <idl>com.sun.star.view.PaperOrientation.LANDSCAPE</idl> pedig a fekvőt).
;<tt>PaperFormat (enumeráció)</tt>:megadja a papír formátumát (például a <idl>com.sun.star.view.PaperFormat.A4</idl> a DIN A4 méretű papírt jelenti, a <idl>com.sun.star.view.PaperFormat.Letter</idl> pedig az amerikai Letter szabványút).
;<tt>PaperSize (méret)</tt>:megadja a papír méretét századmilliméterben.

A következő példa bemutatja, hogyan módosítható a nyomtató, és hogyan állítható be a papírméret a <tt>Printer</tt> tulajdonsággal.

<source lang="oobas">
Dim Doc As Object
Dim PrinterProperties(1) As New com.sun.star.beans.PropertyValue
Dim PaperSize As New com.sun.star.awt.Size

PaperSize.Width = 20000 ' 20 cm
PaperSize.Height = 20000 ' 20 cm
PrinterProperties (0).Name="Name"
PrinterProperties (0).Value="Irodai HP Laserjet"
PrinterProperties (1).Name="PaperSize"
PrinterProperties (1).Value=PaperSize
Doc.Printer = PrinterProperties()
</source>

Ez a példa definiál egy <tt>PaperSize</tt> nevű objektumot, amely <idl>com.sun.star.awt.Size</idl> típusú. Ez a papírméret megadásához szükséges. Ezenfelül a program létrehoz egy <tt>PrinterProperties</tt> nevű adatmezőt a két <tt>PropertyValue</tt> elem számára. Ezután inicializálja ezt az adatmezőt a <tt>Printer</tt> tulajdonság beállítani kívánt értékeivel. Az UNO szemszögéből nézve a Printer nem egy valódi tulajdonság, hanem egy imitált tulajdonság.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/StarDesktop}}
{{PDL1}}

HU/Documentation/BASIC Guide/StarDesktop

2009-05-15T14:37:39Z

Timarandras:

{{HU/Documentation/BASICGuideTOC/v2
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=HU/Documentation/BASIC Guide/Documents
|NextPage=HU/Documentation/BASIC Guide/Templates
|docs=block
}}
{{DISPLAYTITLE:A StarDesktop}}
__NOTOC__
Amikor dokumentumokkal dolgozunk, leggyakrabban két szolgáltatást használunk:

* Az egyik a <idl>com.sun.star.frame.Desktop</idl> szolgáltatás, amely hasonlít az {{OOo}} főszolgáltatására. Ez a szolgáltatás biztosítja az {{OOo}} keretobjektumának funkcióit, amely alá tartozik az összes dokumentumablak. A dokumentumok is ezzel az objektummal hozhatók létre, nyithatók meg és importálhatók.
* A másik szolgáltatás az egyes dokumentumobjektumok alapfunkcionalitását biztosító <idl>com.sun.star.document.OfficeDocument</idl>. Ez a szolgáltatás biztosítja a dokumentumok mentését, exportálását és nyomtatását végző metódusokat.

A <idl>com.sun.star.frame.Desktop</idl> szolgáltatás automatikusan létrejön az {{OOo}} indításakor. Ezt a szolgáltatást az {{OOo}} Basicben a <tt>StarDesktop</tt> globális név használatával címezhetjük meg.

A <tt>StarDesktop</tt> legfontosabb felülete a <idl>com.sun.star.frame.XComponentLoader</idl>. Ez tulajdonképpen a <tt>loadComponentFromURL</tt> metódust fedi le, amely felelős a dokumentumok létrehozásáért, importálásáért és megnyitásáért.

A <tt>StarDesktop</tt> objektum neve a StarOffice 5 programból származik, ahol minden dokumentumablak egyetlen közös, <tt>StarDesktop</tt> nevű alkalmazásba volt beágyazva. Az {{OOo}} jelenlegi verziójában a látható <tt>StarDesktop</tt> objektum már nem használt. Ennek ellenére a <tt>StarDesktop</tt> név megmaradt az {{OOo}} keretobjektuma számára, mert ez egyértelműen jelzi, hogy ez a teljes alkalmazás keretobjektuma.

A <tt>StarDesktop</tt> objektum a StarOffice 5 <tt>Application</tt> objektumának szerepét tölti be, amely a régebbi verzióban a gyökérobjektum volt. De a régi <tt>Application</tt> objektummal ellentétben a <tt>StarDesktop</tt> elsődlegesen az új dokumentumok megnyitásáért felelős. A régi <tt>Application</tt> objektumban megtalálható, az {{OOo}} megjelenítését végző függvények (például a <tt>FullScreen</tt>, <tt>FunctionBarVisible</tt>, <tt>Height</tt>, <tt>Width</tt>, <tt>Top</tt>, <tt>Visible</tt>) már nem használtak.

{{Documentation/Note|Míg Wordben az aktív dokumentumot az <tt>Application.ActiveDocument</tt> objektumon keresztül lehet elérni, és Excelben az <tt>Application.ActiveWorkbook</tt> objektummal, addig az {{OOo}} programban a <tt>StarDesktop</tt> felelős ezért. Az {{OOo}} programban a dokumentumobjektum a <tt>StarDesktop.CurrentComponent</tt> tulajdonsággal vagy a <tt>ThisComponent</tt> segítségével érhető el.}}

== ThisComponent ==
A <tt>ThisComponent</tt> globális név általában ugyanazt az objektumot adja vissza, mint a <tt>StarDesktop.CurrentComponent</tt>, de van egy fontos előnye. Ha a BASIC IDE-ben dolgozunk a makró futtatása, hibakeresése vagy böngészése közben, akkor a <tt>StarDesktop</tt> a BASIC IDE-t adja vissza. Ez valószínűleg nem az, amit szeretnénk. A <tt>ThisComponent</tt> az utoljára aktív dokumentumot adja vissza.

== Alapvető információk az {{OOo}}-dokumentumokról ==

Az{{OOo}}-dokumentumokkal végzett munka során hasznos lehet, ha ismerjük a dokumentumok alapvető kezelését az {{OOo}} programban. Ez magában foglalja az {{OOo}}-dokumentumok fájlnevei strukturálásának módját, akárcsak a nem mentett fájlok formátumát.

=== Fájlnevek URL-jelölésben ===

Mivel az {{OOo}} egy platformfüggetlen alkalmazás, ezért URL-jelölést használ (amely független az operációs rendszertől), amely a fájlnevekről szóló RFC 1738-as internetszabványban van definiálva. A fájlnevek ebben a rendszerben a <tt>file:///</tt> előtaggal kezdődnek, amelyet a helyi elérési út követ. Ha a fájlnév alkönyvtárakat tartalmaz, akkor ezek törtjellel elválasztva szerepelnek, és nem fordított törtjellel, ahogy azt a Windows használja általában. A következő elérési út a C: meghajtó doc könyvtárának <tt>test.odt</tt> fájljára hivatkozik.

file:///C:/doc/test.odt

A helyi fájlnevek URL-lé történő konvertálásához az {{OOo}} a <tt>ConvertToUrl</tt> függvényt biztosítja. Egy URL helyi fájlnévvé történő konvertálásához az {{OOo}} a <tt>ConvertFromUrl</tt> függvényt biztosítja.

<source lang="oobas">
MsgBox ConvertToUrl("C:\doc\test.odt")
' a file:///C:/doc/test.odt elérési utat jeleníti meg
MsgBox ConvertFromUrl("file:///C:/doc/test.odt")
' a c:\doc\test.odt elérési utat jeleníti meg (Windows alatt)
</source>

Ez a példa konvertálja a helyi fájlnevet URL-lé, és megjeleníti azt egy üzenetablakban. Ezután konvertálja az URL-t helyi fájlnévvé, és azt is megjeleníti.

Az RFC 1738-as internetszabvány, amelyen ez alapul, a <tt>0-9</tt>, <tt>a-z</literal> és <tt>A-Z</tt> karakterek használatát engedélyezi. Az összes többi karakter vezérlőkódként lesz beszúrva az URL-ekbe. Ehhez át lesznek konvertálva az UTF-8 kódolás szerinti hexadecimális értékükre, és egy százalékjel előzi meg őket. Például a szóköz a fájlnevekben a <tt>%20</tt> karakterláncra lesz konvertálva az URL-ekben.

=== Az XML fájlformátum ===

Az {{OOo}}-dokumentumokat az XML fájlformátumon alapulnak. Az XML-alapú fájlok más programokkal is megnyithatók és szerkeszthetők.

=== Fájlok tömörítése ===

Mivel az XML normál szövegfájlokon alapul, az eredmény általában meglehetősen nagy méretű. Éppen ezért az {{OOo}} tömöríti a fájlokat, és ZIP-fájlként menti őket. A <tt>storeAsURL</tt> metódus használatával lehetőség van közvetlenül az eredeti XLM-fájlok mentésére. Lásd alább: [[HU/Documentation/BASIC Guide/StarDesktop#storeAsURL Method Options|storeAsURL metódus]].

== Dokumentumok létrehozása, megnyitása és importálása ==

A dokumentumok megnyitását, importálását és létrehozását a következő metódus végzi

<source lang="oobas">
StarDesktop.loadComponentFromURL(URL, Frame, SearchFlags, FileProperties)
</source>

A <tt>loadComponentFromURL</tt> első paramétere az adott fájl URL-jét adja meg.

Második paraméterként a <tt>loadComponentFromURL</tt> az {{OOo}} által belsőleg létrehozott ablak keretobjektumának a nevét várja. Általában ez az előre definiált <tt>_blank</tt> név, amelynek hatására az {{OOo}} egy új ablakot hoz létre. Megadható még a <tt>_hidden</tt> név is, amely lehetővé teszi, hogy az adott dokumentum betöltődjön, de rejtve maradjon.

Ezekkel a paraméterekkel a felhasználó megnyithat egy {{OOo}}-dokumentumot, mert az utolsó két paraméterként helyfoglalók (üres értékek) is megadhatók:

<source lang="oobas">
Dim Doc As Object
Dim Url As String
Dim Dummy() 'A PropertyValues (tulajdonságértékek) üres tömbje

Url = "file:///C:/test.odt"

Doc = StarDesktop.loadComponentFromURL(Url, "_blank", 0, Dummy)
</source>

Ez a metódushívás megnyitja a <tt>text.odt</tt> fájlt, és megjeleníti egy új ablakban.

Tetszőleges számú dokumentum megnyitható így az {{OOo}} Basicben, majd szerkeszthető a visszaadott dokumentumobjektum használatával.

{{Documentation/Note|A <tt>StarDesktop.loadComponentFromURL</tt> metódus leváltotta a régi {{OOo}} API <tt>Documents.Add</tt> és <tt>Documents.Open</tt> metódusát.}}

=== A dokumentumablak tartalmának lecserélése ===

A <tt>_blank</tt> és a <tt>_hidden</tt> érték a <tt>Frame</tt> paraméterben azt eredményezi, hogy az {{OOo}} új ablakot hoz létre a <tt>loadComponentFromURL</tt> minden meghívásakor. Néhányszor hasznos lehet egy meglévő ablak tartalmának lecserélése. Ebben az esetben az ablak keretobjektumának egy nevet kell tartalmaznia. Ez a név nem kezdődhet aláhúzással. Ezenfelül a <tt>SearchFlags</tt> paramétert úgy kell beállítani, hogy a megfelelő keretobjektum létrejöjjön, ha még nincs létrehozva. A <tt>SearchFlags</tt> megfelelő állandója a következő:

<source lang="oobas">
SearchFlags = com.sun.star.frame.FrameSearchFlag.CREATE + _
com.sun.star.frame.FrameSearchFlag.ALL
</source>

A következő példa bemutatja, hogyan cserélhető le egy megnyitott ablak tartalma a keretparaméter és a <tt>SearchFlags</tt> használatával:

<source lang="oobas">
Dim Doc As Object
Dim Dummy()
Dim Url As String
Dim SearchFlags As Long

SearchFlags = com.sun.star.frame.FrameSearchFlag.CREATE + _
com.sun.star.frame.FrameSearchFlag.ALL
Url = "file:///C:/test.odt"
Doc = StarDesktop.loadComponentFromURL(Url, "SajátKeret", SearchFlags, Dummy)
MsgBox "Nyomja meg az OK gombot a második dokumentum megjelenítéséhez."

Url = "file:///C:/test2.odt"
Doc = StarDesktop.loadComponentFromURL(Url, "SajátKeret", _
SearchFlags, Dummy)
</source>

Ez a példa először megnyitja a <tt>test.odt</tt> fájlt egy új, <tt>SajátKeret</tt> nevű ablakban. Ha a felhasználó jóváhagyja az üzenetpanelt, a program lecseréli az ablak tartalmát a <tt>test2.odt</tt> fájllal.

=== A loadComponentFromURL metódus lehetőségei ===

A <tt>loadComponentFromURL</tt> metódus negyedik paramétere egy <tt>PropertyValue</tt> adatmező, amely az {{OOo}} számára számos lehetőséget biztosít dokumentumok megnyitásához és létrehozásához. Az adatmezőnek biztosítania kell egy <tt>PropertyValue</tt> struktúrát minden lehetőséghez, amelyben a lehetőség neve van mentve karakterláncként, valamint a hozzá tartozó érték.

A <tt>loadComponentFromURL</tt> a következő lehetőségeket támogatja:

;<tt>AsTemplate (logikai érték)</tt>:ha true (igaz), akkor betölt egy új, névtelen dokumentumot a megadott URL-ről. Ha false (hamis), akkor sablonfájlokat tölt be szerkesztéshez.
;<tt>CharacterSet (karakterlánc)</tt>:megadja, milyen karakterkészleten alapul a dokumentum.
;<tt>FilterName (karakterlánc)</tt>:megad egy speciális szűrőt a <tt>loadComponentFromURL</tt> függvény számára. Az elérhető szűrőnevek a <tt>\share\config\registry\instance\org\openoffice\office\TypeDetection.xml</tt> fájlban vannak definiálva.
;<tt>FilterOptions (karakterlánc)</tt>:további lehetőségeket definiált a szűrők számára.
;<tt>JumpMark (karakterlánc)</tt>:amikor egy dokumentum megnyílik, a program a JumpMark által megadott helyre ugrik.
;<tt>Password (karakterlánc)</tt>:átad egy jelszót egy védett fájlnak.
;<tt>ReadOnly (logikai érték)</tt>:betölt egy csak olvasható dokumentumot.

A következő példa bemutatja, hogyan nyitható meg egy vesszővel elválasztott fájl az {{OOo}} Calc programban a <tt>FilterName</tt> használatával.

<source lang="oobas">
Dim Doc As Object
Dim FileProperties(1) As New com.sun.star.beans.PropertyValue
Dim Url As String

Url = "file:///C:/doc.csv"
FileProperties(0).Name = "FilterName"
FileProperties(0).Value ="Text - txt - csv (StarCalc)"
FileProperties(1).Name = "FilterOptions"
FileProperties(1).value = "44,34,0,1"

Doc = StarDesktop.loadComponentFromURL(Url, "_blank", 0, FileProperties())
</source>

A <tt>FileProperties</tt> adatmező csak egyetlen értéket fed le, mivel csak egy lehetőséget tartalmaz. A <tt>Filtername</tt> tulajdonság megadja, hogy az {{OOo}} egy {{OOo}} Calc-szövegszűrőt használjon-e a fájlok megnyitásához.

=== Új dokumentumok létrehozása ===

Az {{OOo}} automatikusan létrehoz egy új dokumentumot, ha az URL-ben megadott dokumentum egy sablon.

Ha viszont csak egy üres dokumentumra van szükségünk mindenféle igazítás nélkül, akkor megadhatjuk a <tt>private:factory</tt> URL-t:

<source lang="oobas">
Dim Dummy()
Dim Url As String
Dim Doc As Object

Url = "private:factory/swriter"
Doc = StarDesktop.loadComponentFromURL(Url, "_blank", 0, Dummy())
</source>

Ez a metódushívás létrehoz egy üres {{OOo}} Writer-dokumentumot.

== Dokumentumobjektumok ==

Az előző részben bemutatott <tt>loadComponentFromURL</tt> függvény egy dokumentumobjektumot ad vissza. Ez támogatja a <idl>com.sun.star.document.OfficeDocument</idl> szolgáltatást, amely viszont két fő felületet biztosít:

* a <idl>com.sun.star.frame.XStorable</idl> felületet, amely felelős a dokumentumok mentéséért, valamint
* a <idl>com.sun.star.view.XPrintable</idl> felületet, amely tartalmazza a dokumentumok nyomtatásához szükséges metódusokat.

=== Dokumentumok mentése és exportálása ===

Az {{OOo}}-dokumentumokat közvetlenül a dokumentumobjektumon keresztül lehet menteni, A <tt>com.sun.star.frame.XStorable</tt> felület <idl>store</idl> metódusa használható erre a célra:

<source lang="oobas">
Doc.store()
</source>

Ez a metódushívás így működik, feltéve, hogy a dokumentumhoz már hozzá van rendelve egy memóriatartomány. Ez viszont nem így van új dokumentumoknál. Ebben a helyzetben a <tt>storeAsURL</tt> metódust kell használni. Ez a metódus a <idl>com.sun.star.frame.XStorable</idl> felületben is definiálva van, és a dokumentum helyének megadására használható:

<source lang="oobas">
Dim URL As String
Dim Dummy()

Url = "file:///C:/test3.odt"
Doc.storeAsURL(URL, Dummy())
</source>

Az előbbi metódusokon felül a <idl>com.sun.star.frame.XStorable</idl> felület biztosít néhány segítő metódust, amelyek hasznosak lehetnek dokumentumok mentésekor. Ezek a következők:

;<tt>hasLocation()</tt>:megadja, hogy a dokumentumhoz van-e már rendelve URL.
;<tt>isReadonly()</tt>:megadja, hogy a dokumentum csak olvasható-e.
;<tt>isModified()</tt>:megadja, hogy a dokumentumot módosították-e az utolsó mentése óta.

A dokumentum mentéséhez használt kód kiegészíthető ezekkel a lehetőségekkel, így például megadható, hogy a dokumentum csak akkor legyen mentve, ha az objektum ténylegesen módosult, és a fájlnév csak akkor legyen lekérdezve, ha arra tényleg szükség van:

<source lang="oobas">
If (Doc.isModified) Then
If (Doc.hasLocation And (Not Doc.isReadOnly)) Then
Doc.store()
Else
Doc.storeAsURL(URL, Dummy())
End If
End If
</source>

A példaprogram először ellenőrzi, hogy az adott dokumentum módosult-e az utolsó mentése óta. Csak akkor folytatja a mentési folyamatot, ha ez igaz. Ha a dokumentumhoz már hozzá van rendelve egy URL, és a dokumentum nem írásvédett, akkor a program menti a meglévő URL-lel. Ha nem rendelkezik URL-lel, vagy csak olvashatóként van megnyitva, akkor a program egy új URL-lel menti.

=== A storeAsURL metódus lehetőségei ===

Ahogy a <tt>loadComponentFromURL</tt> metódusnál is, úgy a <tt>storeAsURL</tt> metódus használatánál is megadható néhány lehetőség egy <tt>PropertyValue</tt> adatmező formájában. Ezek meghatározzák az {{OOo}} által használt dokumentummentési folyamatot. A <tt>storeAsURL</tt> metódus a következő lehetőségekkel rendelkezik:

;<tt>CharacterSet (karakterlánc)</tt>:megadja, milyen karakterkészleten alapul a dokumentum.
;<tt>FilterName (karakterlánc)</tt>:megad egy speciális szűrőt a <tt>loadComponentFromURL</tt> függvény számára. Az elérhető szűrőnevek a <tt>\share\config\registry\instance\org\openoffice\office\TypeDetection.xml</tt> fájlban vannak definiálva.
;<tt>FilterOptions (karakterlánc)</tt>:további lehetőségeket definiált a szűrők számára.
;<tt>Overwrite (logikai érték)</tt>:lehetővé teszi, hogy a program rákérdezés nélkül felülírjon egy létező fájlt.
;<tt>Password (karakterlánc)</tt>:átadja a jelszót egy védett fájlnak.
;<tt>Unpacked (logikai érték)</tt>:alkönyvtárakba menti a dokumentumot (tömörítés nélkül).

A következő példa bemutatja, hogyan használható az <tt>Overwrite</tt> lehetőség a <tt>storeAsURL</tt> metódussal együtt:

<source lang="oobas">
Dim Doc As Object
Dim FileProperties(0) As New com.sun.star.beans.PropertyValue
Dim Url As String
' ... a dokumentum inicializálása

Url = "file:///c:/test3.odt"
FileProperties(0).Name = "Overwrite"
FileProperties(0).Value = True
Doc.storeAsURL(Url, FileProperties())
</source>

Ezután a példaprogram menti a <tt>Doc</tt> objektumot a megadott fájlnévvel, ha már létezik ilyen nevű fájl.

=== Dokumentumok nyomtatása ===

A mentéshez hasonlóan a dokumentumokat közvetlenül a dokumentumobjektummal lehet kinyomtatni. A <tt>com.sun.star.view.Xprintable</tt> felület <idl>Print</idl> metódusa használható erre a célra: A legegyszerűbb formájában a nyomtatás így néz ki:

<source lang="oobas">
Dim Dummy()

Doc.print(Dummy())
</source>

Ahogy a <tt>loadComponentFromURL</tt> metódus esetében is, úgy itt is a Dummy paraméter egy <tt>PropertyValue</tt> adatmező, amelyen keresztül az {{OOo}} számos lehetőséget meg tud adni a nyomtatáshoz.

=== A print metódus lehetőségei ===

A <tt>print</tt> metódus egy <tt>PropertyValue</tt> adatmezőt vár paraméterként, amely az {{OOo}} Nyomtatás párbeszédablakának beállításait tartalmazza:

;<tt>CopyCount (egész szám)</tt>:a kinyomtatandó példányok számát adja meg.
;<tt>FileName (karakterlánc)</tt>:a megadott fájlba nyomtatja a dokumentumot.
;<tt>Collate (logikai érték)</tt>:arra utasítja a nyomtatót, hogy válogassa szét a kinyomtatott példányok lapjait.
;<tt>Sort (logikai érték)</tt>:rendezi a példányokat több példány nyomtatásánál (<tt>CopyCount</tt> > 1).
;<tt>Pages (karakterlánc)</tt>:a kinyomtatandó oldalak listáját tartalmazza (a szintaxis a Nyomtatás párbeszédablakéval azonos).

A következő példa bemutatja, hogyan nyomtatható ki több oldal a <tt>Pages</tt> lehetőséggel:

<source lang="oobas">
Dim Doc As Object
Dim PrintProperties(0) As New com.sun.star.beans.PropertyValue

PrintProperties(0).Name="Pages"
PrintProperties(0).Value="1-3; 7; 9"
Doc.print(PrintProperties())
</source>

=== Nyomtatókiválasztás és -beállítások ===

A <idl>com.sun.star.view.XPrintable</idl> felület biztosítja a <tt>Printer</tt> tulajdonságot, amely kijelöli a nyomtatót. Ez a tulajdonság egy <tt>PropertyValue</tt> adatmezőt kap a következő beállításokkal:

;<tt>Name (karakterlánc)</tt>:megadja a nyomtató nevét.
;<tt>PaperOrientation (enumeráció)</tt>:megadja a papír tájolását (a <idl>com.sun.star.view.PaperOrientation.PORTRAIT</idl> érték jelenti az álló tájolást, a <idl>com.sun.star.view.PaperOrientation.LANDSCAPE</idl> pedig a fekvőt).
;<tt>PaperFormat (enumeráció)</tt>:megadja a papír formátumát (például a <idl>com.sun.star.view.PaperFormat.A4</idl> a DIN A4 méretű papírt jelenti, a <idl>com.sun.star.view.PaperFormat.Letter</idl> pedig az amerikai Letter szabványút).
;<tt>PaperSize (méret)</tt>:megadja a papír méretét századmilliméterben.

A következő példa bemutatja, hogyan módosítható a nyomtató, és hogyan állítható be a papírméret a <tt>Printer</tt> tulajdonsággal.

<source lang="oobas">
Dim Doc As Object
Dim PrinterProperties(1) As New com.sun.star.beans.PropertyValue
Dim PaperSize As New com.sun.star.awt.Size

PaperSize.Width = 20000 ' 20 cm
PaperSize.Height = 20000 ' 20 cm
PrinterProperties (0).Name="Name"
PrinterProperties (0).Value="Irodai HP Laserjet"
PrinterProperties (1).Name="PaperSize"
PrinterProperties (1).Value=PaperSize
Doc.Printer = PrinterProperties()
</source>

Ez a példa definiál egy <tt>PaperSize</tt> nevű objektumot, amely <idl>com.sun.star.awt.Size</idl> típusú. Ez a papírméret megadásához szükséges. Ezenfelül a program létrehoz egy <tt>PrinterProperties</tt> nevű adatmezőt a két <tt>PropertyValue</tt> elem számára. Ezután inicializálja ezt az adatmezőt a <tt>Printer</tt> tulajdonság beállítani kívánt értékeivel. Az UNO szemszögéből nézve a Printer nem egy valódi tulajdonság, hanem egy imitált tulajdonság.

{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/StarDesktop}}
{{PDL1}}