Difference between revisions of "NL/Documentation/BASIC Guide/Formatting Spreadsheet Documents"

From Apache OpenOffice Wiki
Jump to: navigation, search
m
(11 intermediate revisions by the same user not shown)
Line 35: Line 35:
 
Het volgende voorbeeld schrijft het getal 1000 in de cel B2, verandert de achtergrondkleur naar rood met behulp van de eigenschap <tt>CellBackColor</tt> en maakt dan voor de cel een lichtgrijze schaduw welke 1 mm naar links en naar beneden verplaatst wordt.
 
Het volgende voorbeeld schrijft het getal 1000 in de cel B2, verandert de achtergrondkleur naar rood met behulp van de eigenschap <tt>CellBackColor</tt> en maakt dan voor de cel een lichtgrijze schaduw welke 1 mm naar links en naar beneden verplaatst wordt.
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
Dim Doc As Object
 
Dim Doc As Object
 
Dim Blad As Object
 
Dim Blad As Object
Line 54: Line 54:
  
 
Cel.ShadowFormat = SchaduwOpmaak
 
Cel.ShadowFormat = SchaduwOpmaak
−
</source>
+
</syntaxhighlight>
  
 
== Uitlijnen ==
 
== Uitlijnen ==
Line 68: Line 68:
 
;<tt>RotateAngle (Long)</tt>:draaihoek van de tekst in 100-en van een graad
 
;<tt>RotateAngle (Long)</tt>:draaihoek van de tekst in 100-en van een graad
  
−
The following example shows how you can "stack" the contents of a cell so that the individual characters are printed one under another in the top left corner of the cell. The characters are not rotated.
+
Het volgende voorbeeld toont hoe u de inhoud van een cel kunt “stapelen” zodat de individuele tekens onder elkaar worden afgedrukt in de linkerbovenhoek van de cel. De tekens worden niet gedraaid.
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
Dim Doc As Object
 
Dim Doc As Object
−
Dim Sheet As Object
+
Dim Blad As Object
−
Dim Cell As Object
+
Dim Cel As Object
  
 
Doc = ThisComponent
 
Doc = ThisComponent
−
Sheet = Doc.Sheets(0)
+
Blad = Doc.Sheets(0)
−
Cell = Sheet.getCellByPosition(1,1)
+
Cel = Blad.getCellByPosition(1,1)
  
−
Cell.Value = 1000
+
Cel.Value = 1000
  
−
Cell.HoriJustify = com.sun.star.table.CellHoriJustify.LEFT
+
Cel.HoriJustify = com.sun.star.table.CellHoriJustify.LEFT
−
Cell.VertJustify = com.sun.star.table.CellVertJustify.TOP
+
Cel.VertJustify = com.sun.star.table.CellVertJustify.TOP
−
Cell.Orientation = com.sun.star.table.CellOrientation.STACKED
+
Cel.Orientation = com.sun.star.table.CellOrientation.STACKED
−
</source>
+
</syntaxhighlight>
  
−
== Number, Date and Text Format ==
+
== Opmaken van getallen, datum en tekst ==
  
−
{{OOo}} provides a whole range of predefined date and time formats. Each of these formats has an internal number that is used to assign the format to cells using the <tt>NumberFormat</tt> property. {{OOo}} provides the <tt>queryKey</tt> and <tt>addNew</tt> methods so that you can access existing number formats as well as create your own number formats. The methods are accessed through the following object call:
+
{{OOo}} verschaft een heel bereik aan vooraf gedefinieerde opmaken voor datum en tijd. Elk van deze opmaken heeft een intern getal dat wordt gebruikt om de opmaak toe te wijzen aan cellen met behulp van de eigenschap <tt>NumberFormat</tt>. {{OOo}} verschaft de methoden <tt>queryKey</tt> en <tt>addNew</tt> zodat u bestaande opmaak voor getallen kunt benaderen en ook uw eigen opmaak voor getallen kunt maken. De methoden worden benaderd via de volgende aanroep voor het object:
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
NumberFormats = Doc.NumberFormats
 
NumberFormats = Doc.NumberFormats
−
</source>
+
</syntaxhighlight>
  
−
A format is specified using a format string that is structured in a similar way to the format function of {{OOo}} Basic. However there is one major difference: whereas the command format expects English abbreviations and decimal points or characters as thousands separators, the country-specified abbreviations must be used for the structure of a command format for the <tt>NumberFormats</tt> object.
+
Een opmaak wordt gespecificeerd met behulp van een tekenreeks voor opmaak die is gestructureerd op eenzelfde wijze als de functie voor opmaak van {{OOo}} BASIC. Er is echter één groot verschil: waar de opmaak via opdrachten Engelse afkortingen verwacht en decimale punten of tekens als scheidingsteken voor duizendtallen, moeten land-specifieke afkortingen worden gebruikt voor de structuur van een opmaak via opdrachten voor het object <tt>NumberFormats</tt>.
  
−
The following example formats the B2 cell so that numbers are displayed with three decimal places and use commas as a thousands separator.
+
Het volgende voorbeeld maakt de B2 cel op zodat getallen worden weergegeven met drie decimale plaatsen en komma's gebruikt als scheidingsteken voor duizendtallen.
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
Dim Doc As Object
 
Dim Doc As Object
−
Dim Sheet As Object
+
Dim Blad As Object
−
Dim Cell As Object
+
Dim Cel As Object
−
Dim NumberFormats As Object
+
Dim GetalOpmaak As Object
−
Dim NumberFormatString As String
+
Dim GetalOpmaakTekens As String
−
Dim NumberFormatId As Long
+
Dim NummerOpmaakId As Long
−
Dim LocalSettings As New com.sun.star.lang.Locale
+
Dim LocaleInstellingen As New com.sun.star.lang.Locale
  
 
Doc = ThisComponent
 
Doc = ThisComponent
−
Sheet = Doc.Sheets(0)
+
Blad = Doc.Sheets(0)
−
Cell = Sheet.getCellByPosition(1,1)
+
Cel = Blad.getCellByPosition(1,1)
  
−
Cell.Value = 23400.3523565
+
Cel.Value = 23400.3523565
  
−
LocalSettings.Language = "en"
+
LocaleInstellingen.Language = "en"
−
LocalSettings.Country = "us"
+
LocaleInstellingen.Country = "us"
  
−
NumberFormats = Doc.NumberFormats
+
GetalOpmaak = Doc.NumberFormats
−
NumberFormatString = "#,##0.000"
+
GetalOpmaakTekens = "#,##0.000"
  
−
NumberFormatId = NumberFormats.queryKey(NumberFormatString, LocalSettings, True)
+
GetalOpmaakId = GetalOpmaak.queryKey(GetalOpmaakTekens, LocaleInstellingen, True)
−
If NumberFormatId = -1 Then
+
If GetalOpmaakId = -1 Then
−
   NumberFormatId = NumberFormats.addNew(NumberFormatString, LocalSettings)
+
   GetalOpmaakId = GetalOpmaak.addNew(GetalOpmaakTekens, LocaleInstellingen)
 
End If
 
End If
  
−
MsgBox NumberFormatId
+
MsgBox GetalOpmaakId
−
Cell.NumberFormat = NumberFormatId
+
Cel.NumberFormats = GetalOpmaakId
−
</source>
+
</syntaxhighlight>
  
−
The '''Format Cells''' dialog in {{OOo}} Calc provides an overview of the different formatting options for cells.
+
Het dialoogvenster '''Cellen opmaken''' in {{OOo}} Calc verschaft een overzicht van de verschillende opties voor opmaak van cellen.
  
−
== Page Properties ==
+
== Eigenschappen voor pagina's ==
  
−
Page properties are the formatting options that position document content on a page as well as visual elements that are repeated page after page. These include
+
Eigenschappen voor pagina's zijn de opties voor opmaak die de inhoud van het document op een pagina plaatsen, net zoals de visuele elementen die pagina na pagina herhaald worden. Hierbij horen
  
−
* Paper formats
+
* Indeling van het papier
−
* Page margins
+
* Paginamarges
−
* Headers and footers.
+
* Kop- en voetteksten.
  
−
The procedure for defining page formats differs from other forms of formatting. Whereas cell, paragraph, and character elements can be formatted directly, page formats can also be defined and indirectly applied using page styles. For example, headers or footers are added to the page style.
+
De procedure voor het definiëren van opmaak van de pagina verschilt van andere vormen van opmaak. Waar dat bij cel, alinea, en teken-elementen direct kan, kan opmaak voor de pagina ook worden gedefinieerd en indirect worden toegepast met behulp van pagina-opmaakprofielen. Kop- en voetteksten worden bijvoorbeeld toegevoegd aan het pagina-opmaakprofiel.
  
−
The following sections describe the main formatting options for spreadsheet pages. Many of the styles that are described are also available for text documents. The page properties that are valid for both types of documents are defined in the <idl>com.sun.star.style.PageProperties</idl> service. The page properties that only apply to spreadsheet documents are defined in the <idl>com.sun.star.sheet.TablePageStyle</idl> service.
+
De volgende gedeelten beschrijven de belangrijkste opties voor opmaak van pagina's van werkbladen. Veel van de opmaakprofielen die worden beschreven zijn ook beschikbaar voor tekstdocumenten. De eigenschappen voor pagina's die geldig zijn voor beide typen van documenten worden gedefinieerd in de service <idl>com.sun.star.style.PageProperties</idl>. De  eigenschappen voor pagina's die alleen kunnen worden toegepast op werkbladdocumenten worden gedefinieerd in de service <idl>com.sun.star.sheet.TablePageStyle</idl>.
  
−
{{Documentation/VBAnote|The page properties (page margins, borders, and so on) for a Microsoft Office document are defined by means of a <tt>PageSetup</tt> object at the <tt>Worksheet</tt> object (Excel) or <tt>Document</tt> object (Word) level. In {{OOo}}, these properties are defined using a page style which in turn is linked to the associated document.}}
+
{{Documentation/VBAnote|De eigenschappen voor pagina's (paginamarges, randen enzovoort) voor een document in Microsoft Office worden gedefinieerd door middel van een object <tt>PageSetup</tt> op het niveau van het object <tt>Worksheet</tt> (Excel) of het object <tt>Document</tt> (Word). In {{OOo}} worden deze eigenschappen gedefinieerd met behulp van een pagina-opmaakprofiel dat op zijn beurt wordt gekoppeld aan het geassocieerde document.}}
  
−
== Page Background ==
+
== Achtergrond van pagina ==
  
−
The <idl>com.sun.star.style.PageProperties</idl> service defines the following properties of a pages background:
+
De service <idl>com.sun.star.style.PageProperties</idl> definieert de volgende eigenschappen van een achtergrond van een pagina:
  
−
;<tt>BackColor (long)</tt>:color of background
+
;<tt>BackColor (long)</tt>:kleur van de achtergrond
−
;<tt>BackGraphicURL (String)</tt>:URL of the background graphics that you want to use
+
;<tt>BackGraphicURL (String)</tt>:URL van de afbeelding voor de achtergrond die u wilt gebruiken
−
;<tt>BackGraphicFilter (String)</tt>:name of the filter for interpreting the background graphics
+
;<tt>BackGraphicFilter (String)</tt>:naam van het filter voor het interpreteren van de afbeelding voor de achtergrond
−
;<tt>BackGraphicLocation (Enum)</tt>:position of the background graphics (value according to enumeration)
+
;<tt>BackGraphicLocation (Enum)</tt>:positie van de afbeelding voor de achtergrond (waarde overeenkomstig de nummering)
−
;<tt>BackTransparent (Boolean)</tt>:makes the background transparent
+
;<tt>BackTransparent (Boolean)</tt>:maakt de achtergrond transparant
  
−
== Page Format ==
+
== Opmaak van de pagina ==
  
−
The page format is defined using the following properties of the <idl>com.sun.star.style.PageProperties</idl> service:
+
De opmaak van de pagina wordt gedefinieerd met behulp van de volgende eigenschappen van de service <idl>com.sun.star.style.PageProperties</idl>
  
−
;<tt>IsLandscape (Boolean)</tt>:landscape format
+
;<tt>IsLandscape (Boolean)</tt>:indeling Liggend
−
;<tt>Width (long)</tt>:width of page in hundredths of a millimeter
+
;<tt>Width (long)</tt>:breedte van de pagina in 100-en van een millimeter
−
;<tt>Height (long)</tt>:height of page in hundredths of a millimeter
+
;<tt>Height (long)</tt>:hoogte van de pagina in 100-en van een millimeter
−
;<tt>PrinterPaperTray (String)</tt>:name of the printer paper tray that you want to use
+
;<tt>PrinterPaperTray (String)</tt>:naam van de papierlade van de printer die u wilt gebruiken
  
−
The following example sets the page size of the "Default" page style to the DIN A5 landscape format (height 14.8 cm, width 21 cm):
+
Het volgende voorbeeld stelt de opmaak van de pagina van het paginaopmaakprofiel “Standaard” in op de indeling DIN A5 liggend (hoogte 14.8 cm, breedte 21 cm):
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
Dim Doc As Object
 
Dim Doc As Object
−
Dim Sheet As Object
+
Dim Blad As Object
−
Dim StyleFamilies As Object  
+
Dim Opmaakprofielen As Object  
−
Dim PageStyles As Object
+
Dim PaginaOpmaakprofielen As Object
−
Dim DefPage As Object
+
Dim DefPagina As Object
  
 
Doc = ThisComponent
 
Doc = ThisComponent
−
StyleFamilies = Doc.StyleFamilies
+
Opmaakprofielen = Doc.StyleFamilies
−
PageStyles = StyleFamilies.getByName("PageStyles")
+
PaginaOpmaakprofielen = Opmaakprofielen.getByName("PageStyles")
−
DefPage = PageStyles.getByName("Default")
+
DefPagina = PaginaOpmaakprofielen.getByName("Standaard")
  
−
DefPage.IsLandscape = True
+
DefPagina.IsLandscape = True
−
DefPage.Width = 21000
+
DefPagina.Width = 21000
−
DefPage.Height = 14800
+
DefPagina.Height = 14800
−
</source>
+
</syntaxhighlight>
  
−
== Page Margin, Border, and Shadow ==
+
== Paginamarge, rand en schaduw ==
  
−
The <idl>com.sun.star.style.PageProperties</idl> service provides the following properties for adjusting page margins as well as borders and shadows:
+
De service <idl>com.sun.star.style.PageProperties</idl> verschaft de volgende eigenschappen voor het aanpassen van de paginamarges, evenals voor omrandingen en schaduw:
  
−
;<tt>LeftMargin (long)</tt>:width of the left hand page margin in hundredths of a millimeter
+
;<tt>LeftMargin (long)</tt>:breedte van de linker paginamarge in 100-en van een millimeter
−
;<tt>RightMargin (long)</tt>:width of the right hand page margin in hundredths of a millimeter
+
;<tt>RightMargin (long)</tt>:breedte van de rechter paginamarge in 100-en van een millimeter
−
;<tt>TopMargin (long)</tt>:width of the top page margin in hundredths of a millimeter
+
;<tt>TopMargin (long)</tt>:breedte van de bovenste paginamarge in 100-en van een millimeter
−
;<tt>BottomMargin (long)</tt>:width of the bottom page margin in hundredths of a millimeter
+
;<tt>BottomMargin (long)</tt>:breedte van de onderste paginamarge in 100-en van een millimeter
−
;<tt>LeftBorder (struct)</tt>:specifications for left-hand line of page border (<idl>com.sun.star.table.BorderLine</idl> structure)
+
;<tt>LeftBorder (struct)</tt>:specificaties voor linker rand van de pagina (structuur <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>RightBorder (struct)</tt>:specifications for right-hand line of page border (<idl>com.sun.star.table.BorderLine</idl> structure)
+
;<tt>RightBorder (struct)</tt>:specificaties voor rechter rand van de pagina (structuur <idl>com.sun.star.table.BorderLine</idl> )
−
;<tt>TopBorder (struct)</tt>:specifications for top line of page border (<idl>com.sun.star.table.BorderLine</idl> structure)
+
;<tt>TopBorder (struct)</tt>:specificaties voor bovenste rand van de pagina (structuur <idl>com.sun.star.table.BorderLine</idl> )
−
;<tt>BottomBorder (struct)</tt>:specifications for bottom line of page border (<idl>com.sun.star.table.BorderLine</idl> structure)
+
;<tt>BottomBorder (struct)</tt>:specificaties voor onderste rand van de pagina (structuur <idl>com.sun.star.table.BorderLine</idl> )
−
;<tt>LeftBorderDistance (long)</tt>:distance between left-hand page border and page content in hundredths of a millimeter
+
;<tt>LeftBorderDistance (long)</tt>:afstand tussen de linker rand van de pagina en de inhoud van de pagina in 100-en van een millimeter
−
;<tt>RightBorderDistance (long)</tt>:distance between right-hand page border and page content in hundredths of a millimeter
+
;<tt>RightBorderDistance (long)</tt>:afstand tussen de rechter rand van de pagina en de inhoud van de pagina in 100-en van een millimeter
−
;<tt>TopBorderDistance (long)</tt>:distance between top page border and page content in hundredths of a millimeter
+
;<tt>TopBorderDistance (long)</tt>:afstand tussen de bovenste rand van de pagina en de inhoud van de pagina in 100-en van een millimeter
−
;<tt>BottomBorderDistance (long)</tt>:distance between bottom page border and page content in hundredths of a millimeter
+
;<tt>BottomBorderDistance (long)</tt>:afstand tussen de onderste rand van de pagina en de inhoud van de pagina in 100-en van een millimeter
−
;<tt>ShadowFormat (struct)</tt>:specifications for shadow of content area of page (<idl>com.sun.star.table.ShadowFormat</idl> structure)
+
;<tt>ShadowFormat (struct)</tt>:specificaties voor schaduw van het gebied van de inhoud van de pagina (structuur <idl>com.sun.star.table.ShadowFormat</idl>)
  
−
The following example sets the left and right-hand borders of the "Default" page style to 1 centimeter.
+
Het volgende voorbeeld stelt de linker en rechter rand van het paginaopmaakprofiel “Standaard” in op 1 centimeter.
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
Dim Doc As Object
 
Dim Doc As Object
−
Dim Sheet As Object
+
Dim Blad As Object
−
Dim StyleFamilies As Object  
+
Dim OpmaakProfielen As Object  
−
Dim PageStyles As Object
+
Dim PaginaOpmaakprofielen As Object
−
Dim DefPage As Object
+
Dim DefPagina As Object
  
 
Doc = ThisComponent
 
Doc = ThisComponent
−
StyleFamilies = Doc.StyleFamilies
+
OpmaakProfielen = Doc.StyleFamilies
−
PageStyles = StyleFamilies.getByName("PageStyles")
+
PaginaOpmaakprofielen = OpmaakProfielen.getByName("PageStyles")
−
DefPage = PageStyles.getByName("Default")
+
DefPagina = PaginaOpmaakprofielen.getByName("Standaard")
  
−
DefPage.LeftMargin = 1000
+
DefPagina.LeftMargin = 1000
−
DefPage.RightMargin = 1000
+
DefPagina.RightMargin = 1000
−
</source>
+
</syntaxhighlight>
  
−
== Headers and Footers ==
+
== Kop- en voetteksten ==
  
−
The headers and footers of a document form part of the page properties and are defined using the <idl>com.sun.star.style.PageProperties</idl> service. The properties for formatting headers are:
+
De kop- en voetteksten van een document vormen een deel van de pagina-eigenschappen en worden gedefinieerd met behulp van de service <idl>com.sun.star.style.PageProperties</idl>. De eigenschappen voor het opmaken van de kopteksten zijn:
  
−
;<tt>HeaderIsOn (Boolean)</tt>:header is activated
+
;<tt>HeaderIsOn (Boolean)</tt>:koptekst is actief
−
;<tt>HeaderLeftMargin (long)</tt>:distance between header and left-hand page margin in hundredths of a millimeter
+
;<tt>HeaderLeftMargin (long)</tt>:afstand tussen de koptekst en de linker paginamarge in 100-en van een millimeter
−
;<tt>HeaderRightMargin (long)</tt>:distance between header and right-hand page margin in hundredths of a millimeter
+
;<tt>HeaderRightMargin (long)</tt>:afstand tussen de koptekst en de rechter paginamarge in 100-en van een millimeter
−
;<tt>HeaderBodyDistance (long)</tt>:distance between header and main body of document in hundredths of a millimeter
+
;<tt>HeaderBodyDistance (long)</tt>:afstand tussen de koptekst en het gebied voor de inhoud in 100-en van een millimeter
−
;<tt>HeaderHeight (long)</tt>:height of header in hundredths of a millimeter
+
;<tt>HeaderHeight (long)</tt>:hoogte van de koptekst in 100-en van een millimeter
−
;<tt>HeaderIsDynamicHeight (Boolean)</tt>:height of header is automatically adapted to content
+
;<tt>HeaderIsDynamicHeight (Boolean)</tt>:hoogte van de koptekst wordt automatisch aangepast aan de inhoud
−
;<tt>HeaderLeftBorder (struct)</tt>:details of the left-hand border of frame around header (<idl>com.sun.star.table.BorderLine</idl> structure)
+
;<tt>HeaderLeftBorder (struct)</tt>:details van de linker rand van het kader rondom de koptekst (structuur <idl>com.sun.star.table.BorderLine</idl> )
−
;<tt>HeaderRightBorder (struct)</tt>:details of the right-hand border of frame around header (<idl>com.sun.star.table.BorderLine</idl> structure)
+
;<tt>HeaderRightBorder (struct)</tt>:details van de rechter rand van het kader rondom de koptekst (structuur <idl>com.sun.star.table.BorderLine</idl> )
−
;<tt>HeaderTopBorder (struct)</tt>:details of the top line of the border around header (<idl>com.sun.star.table.BorderLine</idl> structure)
+
;<tt>HeaderTopBorder (struct)</tt>:details van de bovenste rand van het kader rondom de koptekst (structuur <idl>com.sun.star.table.BorderLine</idl> )
−
;<tt>HeaderBottomBorder (struct)</tt>:details of the bottom line of the border around header (<idl>com.sun.star.table.BorderLine</idl> structure)
+
;<tt>HeaderBottomBorder (struct)</tt>:details van de onderste rand van het kader rondom de koptekst (structuur <idl>com.sun.star.table.BorderLine</idl> )
−
;<tt>HeaderLeftBorderDistance (long)</tt>:distance between left-hand border and content of header in hundredths of a millimeter
+
;<tt>HeaderLeftBorderDistance (long)</tt>:afstand tussen de linker rand en de inhoud van de koptekst in 100-en van een millimeter
−
;<tt>HeaderRightBorderDistance (long)</tt>:distance between right-hand border and content of header in hundredths of a millimeter
+
;<tt>HeaderRightBorderDistance (long)</tt>:afstand tussen de rechter rand en de inhoud van de koptekst in 100-en van een millimeter
−
;<tt>HeaderTopBorderDistance (long)</tt>:distance between top border and content of header in hundredths of a millimeter
+
;<tt>HeaderTopBorderDistance (long)</tt>:afstand tussen de bovenste rand en de inhoud van de koptekst in 100-en van een millimeter
−
;<tt>HeaderBottomBorderDistance (long)</tt>:distance between bottom border and content of header in hundredths of a millimeter
+
;<tt>HeaderBottomBorderDistance (long)</tt>:afstand tussen de onderste rand en de inhoud van de koptekst in 100-en van een millimeter
−
;<tt>HeaderIsShared (Boolean)</tt>:headers on even and odd pages have the same content (refer to <tt>HeaderText</tt> , <tt>HeaderTextLeft</tt>, and <tt>HeaderTextRight</tt> )
+
;<tt>HeaderIsShared (Boolean)</tt>:kopteksten op even en oneven pagina's hebben dezelfde inhoud (bekijk ook <tt>HeaderText</tt> , <tt>HeaderTextLeft</tt> en <tt>HeaderTextRight</tt> )
−
;<tt>HeaderBackColor (long)</tt>:background color of header
+
;<tt>HeaderBackColor (long)</tt>:kleur van de achtergrond van de koptekst
−
;<tt>HeaderBackGraphicURL (String)</tt>:URL of the background graphics that you want to use
+
;<tt>HeaderBackGraphicURL (String)</tt>:URL van de afbeelding voor de achtergrond die u wilt gebruiken
−
;<tt>HeaderBackGraphicFilter (String)</tt>:name of the filter for interpreting the background graphics for the header
+
;<tt>HeaderBackGraphicFilter (String)</tt>:naam van het filter voor het interpreteren van de afbeelding voor de achtergrond voor de koptekst
−
;<tt>HeaderBackGraphicLocation (Enum)</tt>:position of the background graphics for the header (value according to <idl>com.sun.star.style.GraphicLocation</idl> enumeration)
+
;<tt>HeaderBackGraphicLocation (Enum)</tt>:positie van de afbeelding voor de koptekst (waarde die overeenkomt met de opsomming <idl>com.sun.star.style.GraphicLocation</idl>)
−
;<tt>HeaderBackTransparent (Boolean)</tt>:shows the background of the header as transparent
+
;<tt>HeaderBackTransparent (Boolean)</tt>:geeft de achtergrond van de koptekst transparant weer
−
;<tt>HeaderShadowFormat (struct)</tt>:details of shadow of header (<idl>com.sun.star.table.ShadowFormat</idl> structure)
+
;<tt>HeaderShadowFormat (struct)</tt>:details voor de schaduw van de koptekst (structuur <idl>com.sun.star.table.ShadowFormat</idl> )
  
−
The properties for formatting footers are:
+
De eigenschappen voor het opmaken van voetteksten zijn:
  
−
;<tt>FooterIsOn (Boolean)</tt>:footer is activated
+
;<tt>FooterIsOn (Boolean)</tt>:voettekst is actief
−
;<tt>FooterLeftMargin (long)</tt>:distance between footer and left-hand page margin in hundredths of a millimeter
+
;<tt>FooterLeftMargin (long)</tt>:afstand tussen de voettekst en de linker paginamarge in 100-en van een millimeter
−
;<tt>FooterRightMargin (long)</tt>:distance between footer and right-hand page margin in hundredths of a millimeter
+
;<tt>FooterRightMargin (long)</tt>:afstand tussen de voettekst en de rechter paginamarge in 100-en van een millimeter
−
;<tt>FooterBodyDistance (long)</tt>:distance between footer and main body of document in hundredths of a millimeter
+
;<tt>FooterBodyDistance (long)</tt>:afstand tussen de voettekst en het gebied voor de inhoud in 100-en van een millimeter
−
;<tt>FooterHeight (long)</tt>:height of footer in hundredths of a millimeter
+
;<tt>FooterHeight (long)</tt>:hoogte van de voettekst in 100-en van een millimeter
−
;<tt>FooterIsDynamicHeight (Boolean)</tt>:height of footer is adapted automatically to the content
+
;<tt>FooterIsDynamicHeight (Boolean)</tt>:hoogte van de voettekst wordt automatisch aangepast aan de inhoud
−
;<tt>FooterLeftBorder (struct)</tt>:details of left-hand line of border around footer (<idl>com.sun.star.table.BorderLine</idl> structure)
+
;<tt>FooterLeftBorder (struct)</tt>:details van de linker rand van het kader rondom de voettekst (structuur <idl>com.sun.star.table.BorderLine</idl> )
−
;<tt>FooterRightBorder (struct)</tt>:details of right-hand line of border around footer (<idl>com.sun.star.table.BorderLine</idl> structure)
+
;<tt>FooterRightBorder (struct)</tt>:details van de rechter rand van het kader rondom de voettekst (structuur <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>FooterTopBorder (struct)</tt>:details of top line of border around footer (<idl>com.sun.star.table.BorderLine</idl> structure)
+
;<tt>FooterTopBorder (struct)</tt>:details van de bovenste rand van het kader rondom de voettekst (structuur <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>FooterBottomBorder (struct)</tt>:details of bottom line of border around footer (<idl>com.sun.star.table.BorderLine</idl> structure)
+
;<tt>FooterBottomBorder (struct)</tt>:details van de onderste rand van het kader rondom de voettekst (structuur <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>FooterLeftBorderDistance (long)</tt>:distance between left-hand border and content of footer in hundredths of a millimeter
+
;<tt>FooterLeftBorderDistance (long)</tt>:afstand tussen de linker rand en de inhoud van de voettekst in 100-en van een millimeter
−
;<tt>FooterRightBorderDistance (long)</tt>:distance between right-hand border and content of footer in hundredths of a millimeter
+
;<tt>FooterRightBorderDistance (long)</tt>:afstand tussen de rechter rand en de inhoud van de voettekst in 100-en van een millimeter
−
;<tt>FooterTopBorderDistance (long)</tt>:distance between top border and content of footer in hundredths of a millimeter
+
;<tt>FooterTopBorderDistance (long)</tt>:afstand tussen de bovenste rand en de inhoud van de voettekst in 100-en van een millimeter
−
;<tt>FooterBottomBorderDistance (long)</tt>:distance between bottom border and content of footer in hundredths of a millimeter
+
;<tt>FooterBottomBorderDistance (long)</tt>:afstand tussen de onderste rand en de inhoud van de voettekst in 100-en van een millimeter
−
;<tt>FooterIsShared (Boolean)</tt>:the footers on the even and odd pages have the same content (refer to <tt>FooterText</tt>, <tt>FooterTextLeft</tt>, and <tt>FooterTextRight</tt> )
+
;<tt>FooterIsShared (Boolean)</tt>:de voetteksten op de even en oneven pagina's hebben dezelfde inhoud (bekijk ook <tt>FooterText</tt>, <tt>FooterTextLeft</tt> en <tt>FooterTextRight</tt> )
−
;<tt>FooterBackColor (long)</tt>:background color of footer
+
;<tt>FooterBackColor (long)</tt>:kleur van de achtergrond van de voettekst
−
;<tt>FooterBackGraphicURL (String)</tt>:URL of the background graphics that you want to use
+
;<tt>FooterBackGraphicURL (String)</tt>:URL van de afbeelding voor de achtergrond die u wilt gebruiken
−
;<tt>FooterBackGraphicFilter (String)</tt>:name of the filter for interpreting the background graphics for the footer
+
;<tt>FooterBackGraphicFilter (String)</tt>:naam van het filter voor het interpreteren van de afbeelding voor de achtergrond voor de voettekst
−
;<tt>FooterBackGraphicLocation (Enum)</tt>:position of background graphics for the footer (value according to <idl>com.sun.star.style.GraphicLocation</idl> enumeration)
+
;<tt>FooterBackGraphicLocation (Enum)</tt>:positie van de afbeelding voor de voettekst (waarde die overeenkomt met de opsomming <idl>com.sun.star.style.GraphicLocation</idl>)
−
;<tt>FooterBackTransparent (Boolean) </tt>:shows the background of the footer as transparent
+
;<tt>FooterBackTransparent (Boolean) </tt>:geeft de achtergrond van de voettekst transparant weer
−
;<tt>FooterShadowFormat (struct)</tt>:details of shadow of footer (<idl>com.sun.star.table.ShadowFormat</idl> structure)
+
;<tt>FooterShadowFormat (struct)</tt>:details van de schaduw van de voettekst (structuur <idl>com.sun.star.table.ShadowFormat</idl>)
  
−
== Changing the Text of Headers and Footers ==
+
== Wijzigen van de tekst van kop- en voetteksten ==
  
−
The content of headers and footers in a spreadsheet is accessed through the following properties:
+
De inhoud van kop- en voetteksten in een werkblad wordt toegankelijk via de volgende eigenschappen:
  
−
;<tt>LeftPageHeaderContent (Object)</tt>:content of headers for even pages (<idl>com.sun.star.sheet.HeaderFooterContent</idl> service)
+
;<tt>LeftPageHeaderContent (Object)</tt>:inhoud van kopteksten op even pagina's (service <idl>com.sun.star.sheet.HeaderFooterContent</idl>)
−
;<tt>RightPageHeaderContent (Object)</tt>:content of headers for odd pages (<idl>com.sun.star.sheet.HeaderFooterContent</idl> service)
+
;<tt>RightPageHeaderContent (Object)</tt>:inhoud van kopteksten op oneven pagina's (service <idl>com.sun.star.sheet.HeaderFooterContent</idl>)
−
;<tt>LeftPageFooterContent (Object)</tt>:content of footers for even pages (<idl>com.sun.star.sheet.HeaderFooterContent</idl> service)
+
;<tt>LeftPageFooterContent (Object)</tt>:inhoud van kvoetteksten op even pagina's (service <idl>com.sun.star.sheet.HeaderFooterContent</idl>)
−
;<tt>RightPageFooterContent (Object)</tt>:content of footers for odd pages (<idl>com.sun.star.sheet.HeaderFooterContent</idl> service)
+
;<tt>RightPageFooterContent (Object)</tt>:inhoud van voetteksten op oneven pagina's(service <idl>com.sun.star.sheet.HeaderFooterContent</idl>)
  
−
If you do not need to distinguish between headers or footers for odd and even pages (the <tt>FooterIsShared</tt> property is <tt>False</tt>), then set the properties for headers and footers on odd pages.
+
Als u geen onderscheid hoeft te maken tussen kop- of voetteksten voor even en oneven pagina's (de eigenschap <tt>FooterIsShared</tt> is <tt>False</tt>), stel de eigenschappen voor kop- en voetteksten dan in op oneven pagina's.
  
−
All the named objects return an object that supports the <idl>com.sun.star.sheet.HeaderFooterContent</idl> service. By means of the (non-genuine) properties <tt>LeftText</tt>, <tt>CenterText</tt>, and <tt>RightText</tt>, this service provides three text elements for the headers and footers of {{OOo}} Calc.
+
Alle genoemde objecten geven een object terug dat de service <idl>com.sun.star.sheet.HeaderFooterContent</idl> ondersteunt. Door middel van de (niet-oorspronkelijke) eigenschappen <tt>LeftText</tt>, <tt>CenterText</tt> en <tt>RightText</tt> verschaft deze service drie tekstelementen voor de kop- en voetteksten van {{OOo}} Calc.
  
−
The following example writes the "Just a Test." value in the left-hand text field of the header from the "Default" template.
+
Het volgende voorbeeld schrijft de waarde "Alleen een test." in het linkertekstveld van de koptekst van het opmaakprofiel "Standaard".
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
Dim Doc As Object
 
Dim Doc As Object
−
Dim Sheet As Object
+
Dim Blad As Object
−
Dim StyleFamilies As Object  
+
Dim Opmaakprofielen As Object  
−
Dim PageStyles As Object
+
Dim PaginaOpmaakprofielen As Object
−
Dim DefPage As Object
+
Dim DefPagina As Object
−
Dim HText As Object
+
Dim KopTekst As Object
−
Dim HContent As Object
+
Dim KopInhoud As Object
 +
 
 
Doc = ThisComponent
 
Doc = ThisComponent
−
StyleFamilies = Doc.StyleFamilies
+
Opmaakprofielen = Doc.StyleFamilies
−
PageStyles = StyleFamilies.getByName("PageStyles")
+
PaginaOpmaakprofielen = Opmaakprofielen.getByName("PageStyles")
−
DefPage = PageStyles.getByName("Default")
+
DefPagina = Opmaakprofielen.getByName("Standaard")
 
   
 
   
−
DefPage.HeaderIsOn = True
+
DefPagina.HeaderIsOn = True
−
HContent = DefPage.RightPageHeaderContent
+
KopInhoud = DefPagina.RightPageHeaderContent
−
HText = HContent.LeftText
+
KopTekst = KopInhoud.LeftText
−
HText.String = "Just a Test."
+
KopTekst.String = "Alleen een test."
−
DefPage.RightPageHeaderContent = HContent
+
DefPagina.RightPageHeaderContent = KopInhoud
−
</source>
+
</syntaxhighlight>
  
−
Note the last line in the example: Once the text is changed, the <tt>TextContent</tt> object must be assigned to the header again so that the change is effective.
+
Let op de laatste regel in het voorbeeld: Als de tekst eenmaal is veranderd, moet het object <tt>TextContent</tt> opnieuw worden toegewezen aan de koptekst zodat de wijziging effectief wordt.
  
−
Another mechanism for changing the text of headers and footers is available for text documents ({{OOo}} Writer) because these consist of a single block of text. The following properties are defined in the <idl>com.sun.star.style.PageProperties</idl> service:
+
Een ander mechanisme voor het wijzigen van de tekst van kop- of voetteksten is beschikbaar voor tekstdocumenten (({{OOo}} Writer) omdat die bestaan uit één enkel blok van tekst. De volgende eigenschappen worden gedefinieerd in de service <idl>com.sun.star.style.PageProperties</idl>:
  
−
;<tt>HeaderText (Object) </tt>:text object with content of the header (<idl>com.sun.star.text.XText</idl> service)
+
;<tt>HeaderText (Object) </tt>:tekstobject met de inhoud van de koptekst (service <idl>com.sun.star.text.XText</idl>)
−
;<tt>HeaderTextLeft (Object)</tt>:text object with content of headers on left-hand pages (<idl>com.sun.star.text.XText</idl> service)
+
;<tt>HeaderTextLeft (Object)</tt>:tekstobject met de inhoud van de koptekst voor linker pagina's (service <idl>com.sun.star.text.XText</idl>)
−
;<tt>HeaderTextRight (Object)</tt>:text object with content of headers on right-hand pages (<idl>com.sun.star.text.XText</idl> service)
+
;<tt>HeaderTextRight (Object)</tt>:tekstobject met de inhoud van de koptekst voor rechter pagina's (service <idl>com.sun.star.text.XText</idl>)
−
;<tt>FooterText (Object)</tt>:text object with content of the footer (<idl>com.sun.star.text.XText</idl> service)
+
;<tt>FooterText (Object)</tt>:tekstobject met de inhoud van de voettekst (service <idl>com.sun.star.text.XText</idl>)
−
;<tt>FooterTextLeft (Object)</tt>:text object with content of footers on left-hand pages (<idl>com.sun.star.text.XText</idl> service)
+
;<tt>FooterTextLeft (Object)</tt>:tekstobject met de inhoud van de voettekst voor linker pagina's (service <idl>com.sun.star.text.XText</idl>)
−
;<tt>FooterTextRight (Object)</tt>:text object with content of footers on right-hand pages (<idl>com.sun.star.text.XText</idl> service)
+
;<tt>FooterTextRight (Object)</tt>:tekstobject met de inhoud van de voettekst voor rechter pagina's (service <idl>com.sun.star.text.XText</idl>)
  
−
The following example creates a header in the "Default" page style for text documents and adds the text "Just a Test" to the header.
+
Het volgende voorbeeld maakt een koptekst in het pagina-opmaakprofiel “Standaard” voor tekstdocumenten en voegt de tekst “Alleen een test” aan de koptekst toe.
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
Dim Doc As Object
 
Dim Doc As Object
−
Dim Sheet As Object
+
Dim Blad As Object
−
Dim StyleFamilies As Object  
+
Dim Opmaakprofielen As Object  
−
Dim PageStyles As Object
+
Dim PaginaOpmaakprofielen As Object
−
Dim DefPage As Object
+
Dim DefPagina As Object
−
Dim HText As Object
+
Dim KopTekst As Object
  
 
Doc = ThisComponent
 
Doc = ThisComponent
−
StyleFamilies = Doc.StyleFamilies
+
Opmaakprofielen = Doc.StyleFamilies
−
PageStyles = StyleFamilies.getByName("PageStyles")
+
PaginaOpmaakprofielen = Opmaakprofielen.getByName("PageStyles")
−
DefPage = PageStyles.getByName("Default")
+
DefPagina = PaginaOpmaakprofielen.getByName("Standaard")
−
 
+
−
DefPage.HeaderIsOn = True
+
−
HText = DefPage.HeaderText
+
  
−
HText.String = "Just a Test."
+
DefPagina.HeaderIsOn = True
−
</source>
+
KopTekst = DefPagina.HeaderText
  
−
In this instance, access is provided directly through the <tt>HeaderText</tt> property of the page style rather than the <tt>HeaderFooterContent</tt> object.
+
KopTekst.String = "Alleen een test."
 +
</syntaxhighlight>
  
−
== Centering (Spreadsheets Only) ==
+
In dit geval wordt directe toegang verschaft via de eigenschap <tt>HeaderText</tt> van het pagina-opmaakprofiel in plaats van via het object <tt>HeaderFooterContent</tt>.
  
−
The <idl>com.sun.star.sheet.TablePageStyle</idl> service is only used in {{OOo}} Calc page styles and allows cell ranges that you want printed to be centered on the page. This service provides the following properties:
+
== Centreren (alleen voor werkbladdocumenten) ==
  
−
;<tt>CenterHorizontally (Boolean)</tt>:table content is centered horizontally
+
De service <idl>com.sun.star.sheet.TablePageStyle</idl> wordt alleen gebruikt in paginaopmaak voor {{OOo}} Calc en stelt u in staat celbereiken die u wilt afdrukken te centreren op de pagina. Deze service verschaft de volgende eigenschappen:
−
;<tt>CenterVertically (Boolean)</tt>:table content is centered vertically
+
  
−
== Definition of Elements to be Printed (Spreadsheets Only) ==
+
;<tt>CenterHorizontally (Boolean)</tt>:tabelinhoud wordt horizontaal gecentreerd
 +
;<tt>CenterVertically (Boolean)</tt>:tabelinhoud wordt verticaal gecentreerd
  
−
When you format sheets, you can define whether page elements are visible. For this purpose, the <idl>com.sun.star.sheet.TablePageStyle</idl> service provides the following properties:
+
== Definitie van af te drukken elementen (alleen voor werkbladdocumenten) ==
  
−
;<tt>PrintAnnotations (Boolean)</tt>:prints cell comments
+
Als u werkbladen opmaakt kunt u definiëren of elementen van de pagina zichtbaar moeten zijn. Voor dit doel verschaft de service <idl>com.sun.star.sheet.TablePageStyle</idl> de volgende eigenschappen:
−
;<tt>PrintGrid (Boolean)</tt>:prints the cell gridlines
+
−
;<tt>PrintHeaders (Boolean)</tt>:prints the row and column headings
+
−
;<tt>PrintCharts (Boolean)</tt>:prints charts contained in a sheet
+
−
;<tt>PrintObjects (Boolean)</tt>:prints embedded objects
+
−
;<tt>PrintDrawing (Boolean)</tt>:prints draw objects
+
−
;<tt>PrintDownFirst (Boolean)</tt>:if the contents of a sheet extend across several pages, they are first printed in vertically descending order, and then down the right-hand side.
+
−
;<tt>PrintFormulas (Boolean)</tt>:prints the formulas instead of the calculated values
+
−
;<tt>PrintZeroValues (Boolean)</tt>:prints the zero values
+
  
 +
;<tt>PrintAnnotations (Boolean)</tt>:drukt notities voor cellen af
 +
;<tt>PrintGrid (Boolean)</tt>:drukt de randen van de cellen af
 +
;<tt>PrintHeaders (Boolean)</tt>:drukt de rij- en kolomkoppen af
 +
;<tt>PrintCharts (Boolean)</tt>:drukt diagrammen af die zijn opgenomen op een blad
 +
;<tt>PrintObjects (Boolean)</tt>:drukt ingebedde objecten af
 +
;<tt>PrintDrawing (Boolean)</tt>:drukt tekenobjecten af
 +
;<tt>PrintDownFirst (Boolean)</tt>:als de inhoud van een blad zich over meerdere pagina's uitstrekt, worden zij eerst afgedrukt in verticaal aflopende volgorde en dan vanaf de rechterkant.
 +
;<tt>PrintFormulas (Boolean)</tt>:drukt de formules af in plaats van de berekende waarden
 +
;<tt>PrintZeroValues (Boolean)</tt>:drukt nulwaarden af
 
   
 
   
 
{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Formatting Spreadsheet Documents}}
 
{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Formatting Spreadsheet Documents}}
 
{{PDL1}}
 
{{PDL1}}

Revision as of 12:58, 31 December 2019

Book.png


Een werkbladdocument verschaft eigenschappen en methoden voor het opmaken van cellen en pagina's.

Celeigenschappen

Er zijn vele opties voor het opmaken van cellen, zoals het specificeren van het lettertype en afmeting voor tekst. Elke cel ondersteunt de services com.sun.star.style.CharacterProperties en com.sun.star.style.ParagraphProperties, waarvan de belangrijkste eigenschappen werden beschreven in Tekstdocumenten. Speciale celopmaak wordt behandeld door de service com.sun.star.table.CellProperties. De belangrijkste eigenschappen voor deze service worden beschreven in de volgende gedeelten.

U kunt alle genoemde eigenschappen toepassen op individuele cellen en ook op celbereiken.

Documentation note.png VBA : Het object CellProperties in de API van Apache OpenOffice is vergelijkbaar met het object Interior uit VBA dat ook specifieke eigenschappen voor cellen definieert.


Achtergrondkleur en schaduw

De service com.sun.star.table.CellProperties verschaft de volgende eigenschappen voor het definiëren van achtergrondkleuren en schaduw:

CellBackColor (Long)
achtergrondkleur van de tabelcel
IsCellBackgroundTransparent (Boolean)
stelt de achtergrondkleur op transparant in
ShadowFormat (struct)
specificeert de schaduw voor cellen (structuur die overeenkomt met com.sun.star.table.ShadowFormat)

De structuur com.sun.star.table.ShadowFormat en de gedetailleerde specificaties voor de schaduw voor cellen hebben de volgende structuur:

Location (enum)
positie van de schaduw (waarde van de structuur com.sun.star.table.ShadowLocation).
ShadowWidth (Short)
grootte van de schaduw in 100-en van een millimeter
IsTransparent (Boolean)
stelt de schaduw in op transparant
Color (Long)
kleur van de schaduw

Het volgende voorbeeld schrijft het getal 1000 in de cel B2, verandert de achtergrondkleur naar rood met behulp van de eigenschap CellBackColor en maakt dan voor de cel een lichtgrijze schaduw welke 1 mm naar links en naar beneden verplaatst wordt. 

Dim Doc As Object
Dim Blad As Object
Dim Cel As Object
Dim SchaduwOpmaak As New com.sun.star.table.ShadowFormat
 
Doc = ThisComponent
Blad = Doc.Sheets(0)
Cel = Blad.getCellByPosition(1,1)
 
Cel.Value = 1000
 
Cel.CellBackColor = RGB(255, 0, 0)
 
SchaduwOpmaak.Location = com.sun.star.table.ShadowLocation.BOTTOM_RIGHT
SchaduwOpmaak.ShadowWidth = 100
SchaduwOpmaak.Color = RGB(160, 160, 160)
 
Cel.ShadowFormat = SchaduwOpmaak

Uitlijnen

Apache OpenOffice verschaft verschillende functies die u toestaan de uitlijning van een tekst in een tabel te veranderen.

De volgende eigenschappen definiëren de horizontale en verticale uitlijning van een tekst:

HoriJustify (enum)
horizontale uitlijning van de tekst (waarde uit com.sun.star.table.CellHoriJustify)
VertJustify (enum)
verticale uitlijning van de tekst (waarde uit com.sun.star.table.CellVertJustify)
Orientation (enum)
richting van de tekst (waarde die overeenkomt met com.sun.star.table.CellOrientation)
IsTextWrapped (Boolean)
staat automatische regeleinden binnen de cel toe
RotateAngle (Long)
draaihoek van de tekst in 100-en van een graad

Het volgende voorbeeld toont hoe u de inhoud van een cel kunt “stapelen” zodat de individuele tekens onder elkaar worden afgedrukt in de linkerbovenhoek van de cel. De tekens worden niet gedraaid. 

Dim Doc As Object
Dim Blad As Object
Dim Cel As Object
 
Doc = ThisComponent
Blad = Doc.Sheets(0)
Cel = Blad.getCellByPosition(1,1)
 
Cel.Value = 1000
 
Cel.HoriJustify = com.sun.star.table.CellHoriJustify.LEFT
Cel.VertJustify = com.sun.star.table.CellVertJustify.TOP
Cel.Orientation = com.sun.star.table.CellOrientation.STACKED

Opmaken van getallen, datum en tekst

Apache OpenOffice verschaft een heel bereik aan vooraf gedefinieerde opmaken voor datum en tijd. Elk van deze opmaken heeft een intern getal dat wordt gebruikt om de opmaak toe te wijzen aan cellen met behulp van de eigenschap NumberFormat. Apache OpenOffice verschaft de methoden queryKey en addNew zodat u bestaande opmaak voor getallen kunt benaderen en ook uw eigen opmaak voor getallen kunt maken. De methoden worden benaderd via de volgende aanroep voor het object: 

NumberFormats = Doc.NumberFormats

Een opmaak wordt gespecificeerd met behulp van een tekenreeks voor opmaak die is gestructureerd op eenzelfde wijze als de functie voor opmaak van Apache OpenOffice BASIC. Er is echter één groot verschil: waar de opmaak via opdrachten Engelse afkortingen verwacht en decimale punten of tekens als scheidingsteken voor duizendtallen, moeten land-specifieke afkortingen worden gebruikt voor de structuur van een opmaak via opdrachten voor het object NumberFormats.

Het volgende voorbeeld maakt de B2 cel op zodat getallen worden weergegeven met drie decimale plaatsen en komma's gebruikt als scheidingsteken voor duizendtallen. 

Dim Doc As Object
Dim Blad As Object
Dim Cel As Object
Dim GetalOpmaak As Object
Dim GetalOpmaakTekens As String
Dim NummerOpmaakId As Long
Dim LocaleInstellingen As New com.sun.star.lang.Locale
 
Doc = ThisComponent
Blad = Doc.Sheets(0)
Cel = Blad.getCellByPosition(1,1)
 
Cel.Value = 23400.3523565
 
LocaleInstellingen.Language = "en"
LocaleInstellingen.Country = "us"
 
GetalOpmaak = Doc.NumberFormats
GetalOpmaakTekens = "#,##0.000"
 
GetalOpmaakId = GetalOpmaak.queryKey(GetalOpmaakTekens, LocaleInstellingen, True)
If GetalOpmaakId = -1 Then
   GetalOpmaakId = GetalOpmaak.addNew(GetalOpmaakTekens, LocaleInstellingen)
End If
 
MsgBox GetalOpmaakId
Cel.NumberFormats = GetalOpmaakId

Het dialoogvenster Cellen opmaken in Apache OpenOffice Calc verschaft een overzicht van de verschillende opties voor opmaak van cellen.

Eigenschappen voor pagina's

Eigenschappen voor pagina's zijn de opties voor opmaak die de inhoud van het document op een pagina plaatsen, net zoals de visuele elementen die pagina na pagina herhaald worden. Hierbij horen

  • Indeling van het papier
  • Paginamarges
  • Kop- en voetteksten.

De procedure voor het definiëren van opmaak van de pagina verschilt van andere vormen van opmaak. Waar dat bij cel, alinea, en teken-elementen direct kan, kan opmaak voor de pagina ook worden gedefinieerd en indirect worden toegepast met behulp van pagina-opmaakprofielen. Kop- en voetteksten worden bijvoorbeeld toegevoegd aan het pagina-opmaakprofiel.

De volgende gedeelten beschrijven de belangrijkste opties voor opmaak van pagina's van werkbladen. Veel van de opmaakprofielen die worden beschreven zijn ook beschikbaar voor tekstdocumenten. De eigenschappen voor pagina's die geldig zijn voor beide typen van documenten worden gedefinieerd in de service com.sun.star.style.PageProperties. De eigenschappen voor pagina's die alleen kunnen worden toegepast op werkbladdocumenten worden gedefinieerd in de service com.sun.star.sheet.TablePageStyle.

Documentation note.png VBA : De eigenschappen voor pagina's (paginamarges, randen enzovoort) voor een document in Microsoft Office worden gedefinieerd door middel van een object PageSetup op het niveau van het object Worksheet (Excel) of het object Document (Word). In Apache OpenOffice worden deze eigenschappen gedefinieerd met behulp van een pagina-opmaakprofiel dat op zijn beurt wordt gekoppeld aan het geassocieerde document.


Achtergrond van pagina

De service com.sun.star.style.PageProperties definieert de volgende eigenschappen van een achtergrond van een pagina:

BackColor (long)
kleur van de achtergrond
BackGraphicURL (String)
URL van de afbeelding voor de achtergrond die u wilt gebruiken
BackGraphicFilter (String)
naam van het filter voor het interpreteren van de afbeelding voor de achtergrond
BackGraphicLocation (Enum)
positie van de afbeelding voor de achtergrond (waarde overeenkomstig de nummering)
BackTransparent (Boolean)
maakt de achtergrond transparant

Opmaak van de pagina

De opmaak van de pagina wordt gedefinieerd met behulp van de volgende eigenschappen van de service com.sun.star.style.PageProperties

IsLandscape (Boolean)
indeling Liggend
Width (long)
breedte van de pagina in 100-en van een millimeter
Height (long)
hoogte van de pagina in 100-en van een millimeter
PrinterPaperTray (String)
naam van de papierlade van de printer die u wilt gebruiken

Het volgende voorbeeld stelt de opmaak van de pagina van het paginaopmaakprofiel “Standaard” in op de indeling DIN A5 liggend (hoogte 14.8 cm, breedte 21 cm): 

Dim Doc As Object
Dim Blad As Object
Dim Opmaakprofielen As Object 
Dim PaginaOpmaakprofielen As Object
Dim DefPagina As Object
 
Doc = ThisComponent
Opmaakprofielen = Doc.StyleFamilies
PaginaOpmaakprofielen = Opmaakprofielen.getByName("PageStyles")
DefPagina = PaginaOpmaakprofielen.getByName("Standaard")
 
DefPagina.IsLandscape = True
DefPagina.Width = 21000
DefPagina.Height = 14800

Paginamarge, rand en schaduw

De service com.sun.star.style.PageProperties verschaft de volgende eigenschappen voor het aanpassen van de paginamarges, evenals voor omrandingen en schaduw:

LeftMargin (long)
breedte van de linker paginamarge in 100-en van een millimeter
RightMargin (long)
breedte van de rechter paginamarge in 100-en van een millimeter
TopMargin (long)
breedte van de bovenste paginamarge in 100-en van een millimeter
BottomMargin (long)
breedte van de onderste paginamarge in 100-en van een millimeter
LeftBorder (struct)
specificaties voor linker rand van de pagina (structuur com.sun.star.table.BorderLine)
RightBorder (struct)
specificaties voor rechter rand van de pagina (structuur com.sun.star.table.BorderLine )
TopBorder (struct)
specificaties voor bovenste rand van de pagina (structuur com.sun.star.table.BorderLine )
BottomBorder (struct)
specificaties voor onderste rand van de pagina (structuur com.sun.star.table.BorderLine )
LeftBorderDistance (long)
afstand tussen de linker rand van de pagina en de inhoud van de pagina in 100-en van een millimeter
RightBorderDistance (long)
afstand tussen de rechter rand van de pagina en de inhoud van de pagina in 100-en van een millimeter
TopBorderDistance (long)
afstand tussen de bovenste rand van de pagina en de inhoud van de pagina in 100-en van een millimeter
BottomBorderDistance (long)
afstand tussen de onderste rand van de pagina en de inhoud van de pagina in 100-en van een millimeter
ShadowFormat (struct)
specificaties voor schaduw van het gebied van de inhoud van de pagina (structuur com.sun.star.table.ShadowFormat)

Het volgende voorbeeld stelt de linker en rechter rand van het paginaopmaakprofiel “Standaard” in op 1 centimeter. 

Dim Doc As Object
Dim Blad As Object
Dim OpmaakProfielen As Object 
Dim PaginaOpmaakprofielen As Object
Dim DefPagina As Object
 
Doc = ThisComponent
OpmaakProfielen = Doc.StyleFamilies
PaginaOpmaakprofielen = OpmaakProfielen.getByName("PageStyles")
DefPagina = PaginaOpmaakprofielen.getByName("Standaard")
 
DefPagina.LeftMargin = 1000
DefPagina.RightMargin = 1000

Kop- en voetteksten

De kop- en voetteksten van een document vormen een deel van de pagina-eigenschappen en worden gedefinieerd met behulp van de service com.sun.star.style.PageProperties. De eigenschappen voor het opmaken van de kopteksten zijn:

HeaderIsOn (Boolean)
koptekst is actief
HeaderLeftMargin (long)
afstand tussen de koptekst en de linker paginamarge in 100-en van een millimeter
HeaderRightMargin (long)
afstand tussen de koptekst en de rechter paginamarge in 100-en van een millimeter
HeaderBodyDistance (long)
afstand tussen de koptekst en het gebied voor de inhoud in 100-en van een millimeter
HeaderHeight (long)
hoogte van de koptekst in 100-en van een millimeter
HeaderIsDynamicHeight (Boolean)
hoogte van de koptekst wordt automatisch aangepast aan de inhoud
HeaderLeftBorder (struct)
details van de linker rand van het kader rondom de koptekst (structuur com.sun.star.table.BorderLine )
HeaderRightBorder (struct)
details van de rechter rand van het kader rondom de koptekst (structuur com.sun.star.table.BorderLine )
HeaderTopBorder (struct)
details van de bovenste rand van het kader rondom de koptekst (structuur com.sun.star.table.BorderLine )
HeaderBottomBorder (struct)
details van de onderste rand van het kader rondom de koptekst (structuur com.sun.star.table.BorderLine )
HeaderLeftBorderDistance (long)
afstand tussen de linker rand en de inhoud van de koptekst in 100-en van een millimeter
HeaderRightBorderDistance (long)
afstand tussen de rechter rand en de inhoud van de koptekst in 100-en van een millimeter
HeaderTopBorderDistance (long)
afstand tussen de bovenste rand en de inhoud van de koptekst in 100-en van een millimeter
HeaderBottomBorderDistance (long)
afstand tussen de onderste rand en de inhoud van de koptekst in 100-en van een millimeter
HeaderIsShared (Boolean)
kopteksten op even en oneven pagina's hebben dezelfde inhoud (bekijk ook HeaderText , HeaderTextLeft en HeaderTextRight )
HeaderBackColor (long)
kleur van de achtergrond van de koptekst
HeaderBackGraphicURL (String)
URL van de afbeelding voor de achtergrond die u wilt gebruiken
HeaderBackGraphicFilter (String)
naam van het filter voor het interpreteren van de afbeelding voor de achtergrond voor de koptekst
HeaderBackGraphicLocation (Enum)
positie van de afbeelding voor de koptekst (waarde die overeenkomt met de opsomming com.sun.star.style.GraphicLocation)
HeaderBackTransparent (Boolean)
geeft de achtergrond van de koptekst transparant weer
HeaderShadowFormat (struct)
details voor de schaduw van de koptekst (structuur com.sun.star.table.ShadowFormat )

De eigenschappen voor het opmaken van voetteksten zijn:

FooterIsOn (Boolean)
voettekst is actief
FooterLeftMargin (long)
afstand tussen de voettekst en de linker paginamarge in 100-en van een millimeter
FooterRightMargin (long)
afstand tussen de voettekst en de rechter paginamarge in 100-en van een millimeter
FooterBodyDistance (long)
afstand tussen de voettekst en het gebied voor de inhoud in 100-en van een millimeter
FooterHeight (long)
hoogte van de voettekst in 100-en van een millimeter
FooterIsDynamicHeight (Boolean)
hoogte van de voettekst wordt automatisch aangepast aan de inhoud
FooterLeftBorder (struct)
details van de linker rand van het kader rondom de voettekst (structuur com.sun.star.table.BorderLine )
FooterRightBorder (struct)
details van de rechter rand van het kader rondom de voettekst (structuur com.sun.star.table.BorderLine)
FooterTopBorder (struct)
details van de bovenste rand van het kader rondom de voettekst (structuur com.sun.star.table.BorderLine)
FooterBottomBorder (struct)
details van de onderste rand van het kader rondom de voettekst (structuur com.sun.star.table.BorderLine)
FooterLeftBorderDistance (long)
afstand tussen de linker rand en de inhoud van de voettekst in 100-en van een millimeter
FooterRightBorderDistance (long)
afstand tussen de rechter rand en de inhoud van de voettekst in 100-en van een millimeter
FooterTopBorderDistance (long)
afstand tussen de bovenste rand en de inhoud van de voettekst in 100-en van een millimeter
FooterBottomBorderDistance (long)
afstand tussen de onderste rand en de inhoud van de voettekst in 100-en van een millimeter
FooterIsShared (Boolean)
de voetteksten op de even en oneven pagina's hebben dezelfde inhoud (bekijk ook FooterText, FooterTextLeft en FooterTextRight )
FooterBackColor (long)
kleur van de achtergrond van de voettekst
FooterBackGraphicURL (String)
URL van de afbeelding voor de achtergrond die u wilt gebruiken
FooterBackGraphicFilter (String)
naam van het filter voor het interpreteren van de afbeelding voor de achtergrond voor de voettekst
FooterBackGraphicLocation (Enum)
positie van de afbeelding voor de voettekst (waarde die overeenkomt met de opsomming com.sun.star.style.GraphicLocation)
FooterBackTransparent (Boolean)
geeft de achtergrond van de voettekst transparant weer
FooterShadowFormat (struct)
details van de schaduw van de voettekst (structuur com.sun.star.table.ShadowFormat)

Wijzigen van de tekst van kop- en voetteksten

De inhoud van kop- en voetteksten in een werkblad wordt toegankelijk via de volgende eigenschappen:

LeftPageHeaderContent (Object)
inhoud van kopteksten op even pagina's (service com.sun.star.sheet.HeaderFooterContent)
RightPageHeaderContent (Object)
inhoud van kopteksten op oneven pagina's (service com.sun.star.sheet.HeaderFooterContent)
LeftPageFooterContent (Object)
inhoud van kvoetteksten op even pagina's (service com.sun.star.sheet.HeaderFooterContent)
RightPageFooterContent (Object)
inhoud van voetteksten op oneven pagina's(service com.sun.star.sheet.HeaderFooterContent)

Als u geen onderscheid hoeft te maken tussen kop- of voetteksten voor even en oneven pagina's (de eigenschap FooterIsShared is False), stel de eigenschappen voor kop- en voetteksten dan in op oneven pagina's.

Alle genoemde objecten geven een object terug dat de service com.sun.star.sheet.HeaderFooterContent ondersteunt. Door middel van de (niet-oorspronkelijke) eigenschappen LeftText, CenterText en RightText verschaft deze service drie tekstelementen voor de kop- en voetteksten van Apache OpenOffice Calc.

Het volgende voorbeeld schrijft de waarde "Alleen een test." in het linkertekstveld van de koptekst van het opmaakprofiel "Standaard". 

Dim Doc As Object
Dim Blad As Object
Dim Opmaakprofielen As Object 
Dim PaginaOpmaakprofielen As Object
Dim DefPagina As Object
Dim KopTekst As Object
Dim KopInhoud As Object
 
Doc = ThisComponent
Opmaakprofielen = Doc.StyleFamilies
PaginaOpmaakprofielen = Opmaakprofielen.getByName("PageStyles")
DefPagina = Opmaakprofielen.getByName("Standaard")
 
DefPagina.HeaderIsOn = True
KopInhoud = DefPagina.RightPageHeaderContent
KopTekst = KopInhoud.LeftText
KopTekst.String = "Alleen een test."
DefPagina.RightPageHeaderContent = KopInhoud

Let op de laatste regel in het voorbeeld: Als de tekst eenmaal is veranderd, moet het object TextContent opnieuw worden toegewezen aan de koptekst zodat de wijziging effectief wordt.

Een ander mechanisme voor het wijzigen van de tekst van kop- of voetteksten is beschikbaar voor tekstdocumenten ((Apache OpenOffice Writer) omdat die bestaan uit één enkel blok van tekst. De volgende eigenschappen worden gedefinieerd in de service com.sun.star.style.PageProperties:

HeaderText (Object)
tekstobject met de inhoud van de koptekst (service com.sun.star.text.XText)
HeaderTextLeft (Object)
tekstobject met de inhoud van de koptekst voor linker pagina's (service com.sun.star.text.XText)
HeaderTextRight (Object)
tekstobject met de inhoud van de koptekst voor rechter pagina's (service com.sun.star.text.XText)
FooterText (Object)
tekstobject met de inhoud van de voettekst (service com.sun.star.text.XText)
FooterTextLeft (Object)
tekstobject met de inhoud van de voettekst voor linker pagina's (service com.sun.star.text.XText)
FooterTextRight (Object)
tekstobject met de inhoud van de voettekst voor rechter pagina's (service com.sun.star.text.XText)

Het volgende voorbeeld maakt een koptekst in het pagina-opmaakprofiel “Standaard” voor tekstdocumenten en voegt de tekst “Alleen een test” aan de koptekst toe. 

Dim Doc As Object
Dim Blad As Object
Dim Opmaakprofielen As Object 
Dim PaginaOpmaakprofielen As Object
Dim DefPagina As Object
Dim KopTekst As Object
 
Doc = ThisComponent
Opmaakprofielen = Doc.StyleFamilies
PaginaOpmaakprofielen = Opmaakprofielen.getByName("PageStyles")
DefPagina = PaginaOpmaakprofielen.getByName("Standaard")
 
DefPagina.HeaderIsOn = True
KopTekst = DefPagina.HeaderText 
 
KopTekst.String = "Alleen een test."

In dit geval wordt directe toegang verschaft via de eigenschap HeaderText van het pagina-opmaakprofiel in plaats van via het object HeaderFooterContent.

Centreren (alleen voor werkbladdocumenten)

De service com.sun.star.sheet.TablePageStyle wordt alleen gebruikt in paginaopmaak voor Apache OpenOffice Calc en stelt u in staat celbereiken die u wilt afdrukken te centreren op de pagina. Deze service verschaft de volgende eigenschappen:

CenterHorizontally (Boolean)
tabelinhoud wordt horizontaal gecentreerd
CenterVertically (Boolean)
tabelinhoud wordt verticaal gecentreerd

Definitie van af te drukken elementen (alleen voor werkbladdocumenten)

Als u werkbladen opmaakt kunt u definiëren of elementen van de pagina zichtbaar moeten zijn. Voor dit doel verschaft de service com.sun.star.sheet.TablePageStyle de volgende eigenschappen:

PrintAnnotations (Boolean)
drukt notities voor cellen af
PrintGrid (Boolean)
drukt de randen van de cellen af
PrintHeaders (Boolean)
drukt de rij- en kolomkoppen af
PrintCharts (Boolean)
drukt diagrammen af die zijn opgenomen op een blad
PrintObjects (Boolean)
drukt ingebedde objecten af
PrintDrawing (Boolean)
drukt tekenobjecten af
PrintDownFirst (Boolean)
als de inhoud van een blad zich over meerdere pagina's uitstrekt, worden zij eerst afgedrukt in verticaal aflopende volgorde en dan vanaf de rechterkant.
PrintFormulas (Boolean)
drukt de formules af in plaats van de berekende waarden
PrintZeroValues (Boolean)
drukt nulwaarden af


Content on this page is licensed under the Public Documentation License (PDL).
Retrieved from "https://wiki.openoffice.org/w/index.php?title=NL/Documentation/BASIC_Guide/Formatting_Spreadsheet_Documents&oldid=245698"
Personal tools