Difference between revisions of "NL/Documentation/BASIC Guide/Structure of Charts"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (→‎3D-diagrammen)
 
(16 intermediate revisions by the same user not shown)
Line 12: Line 12:
 
== Titel, subtitel en legenda ==
 
== Titel, subtitel en legenda ==
  
−
Een titel, sub-titel en legenda vormen een deel van de basiselementen van elk diagram. Diagrammen verschaffen hun eigen objecten voor elk van deze elementen. Het object <tt>Chart</tt> verschaft de volgende eigenschappen het beheren van deze elementen:
+
Een titel, sub-titel en legenda vormen een deel van de basiselementen van elk diagram. Diagrammen verschaffen hun eigen objecten voor elk van deze elementen. Het object <tt>Chart</tt> verschaft de volgende eigenschappen voor het beheren van deze elementen:
  
 
;<tt>HasMainTitle (Boolean)</tt>:activeert de titel
 
;<tt>HasMainTitle (Boolean)</tt>:activeert de titel
Line 36: Line 36:
 
Het volgende voorbeeld maakt een  diagram en wijst daar de titel "Test", de subtitel "Test 2" en een legenda aan toe. De legenda heeft een grijze achtergrondkleur, staat aan de onderzijde van het diagram en heeft een tekengrootte van 7 punten.
 
Het volgende voorbeeld maakt een  diagram en wijst daar de titel "Test", de subtitel "Test 2" en een legenda aan toe. De legenda heeft een grijze achtergrondkleur, staat aan de onderzijde van het diagram en heeft een tekengrootte van 7 punten.
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
Dim Doc As Object
 
Dim Doc As Object
 
Dim Diagrammen As Object
 
Dim Diagrammen As Object
Line 67: Line 67:
 
Diagram.Legend.FillColor = RGB(210, 210, 210)
 
Diagram.Legend.FillColor = RGB(210, 210, 210)
 
Diagram.Legend.CharHeight = 7
 
Diagram.Legend.CharHeight = 7
−
</source>
+
</syntaxhighlight>
  
 
== Achtergrond ==
 
== Achtergrond ==
  
−
Every chart has a background area. The <tt>Chart</tt> object provides the property <tt>Area</tt> to format the background:
+
Elk diagram heeft een gedeelte voor de achtergrond. Het object <tt>Chart</tt> verschaft de eigenschap <tt>Area</tt> om de achtergrond op te maken:
  
−
;<tt>Area (Object)</tt>:background area of the chart (supports <idl>com.sun.star.chart.ChartArea</idl> service)
+
;<tt>Area (Object)</tt>:gebied voor de achtergrond van het diagram (ondersteunt de service <idl>com.sun.star.chart.ChartArea</idl>)
  
−
The background of a chart covers its complete area, including the area under the title, subtitle and legend. The associated <idl>com.sun.star.chart.ChartArea</idl> service supports line and fill properties.
+
De achtergrond van een diagram beslaat zijn complete gebied, inclusief het gebied onder de titel, sub-titel en diagram-legenda. De geassocieerde service <idl>com.sun.star.chart.ChartArea</idl> ondersteunt eigenschappen voor lijn en vulling.
  
 
== Diagram ==
 
== Diagram ==
  
−
The <tt>Chart</tt> object provides the property <tt>Diagram</tt> which forms the coordinate system with axes and grids, where the data finally is displayed:
+
Het object <tt>Chart</tt> verschaft de eigenschap <tt>Diagram</tt> die het coördinatensysteem vormt met assen en raster, waar de gegevens uiteindelijk wordne weergegeven:
  
−
;<tt>Diagram (Object)</tt>:object forming the coordinate system where the data is plotted. It supports <idl>com.sun.star.chart.Diagram</idl> service and:
+
;<tt>Diagram (Object)</tt>:object dat het coördinatensysteem vormt waar de gegevens worden geplot. Het ondersteunt de service <idl>com.sun.star.chart.Diagram</idl> en:
 
:* <idl>com.sun.star.chart.StackableDiagram</idl>
 
:* <idl>com.sun.star.chart.StackableDiagram</idl>
 
:* <idl>com.sun.star.chart.ChartAxisXSupplier</idl>
 
:* <idl>com.sun.star.chart.ChartAxisXSupplier</idl>
Line 89: Line 89:
 
:* <idl>com.sun.star.chart.ChartTwoAxisYSupplier</idl>
 
:* <idl>com.sun.star.chart.ChartTwoAxisYSupplier</idl>
  
−
Different services are supported depending on the chart type (see
+
verschillende services worden ondersteund, afhanbkelijk van het type diagram (zie
−
[[Documentation/BASIC_Guide/Chart_Types|Chart Types]]).
+
[[NL/Documentation/BASIC_Guide/Chart_Types|Typen diagram]]).
  
−
== Wall and Floor ==
+
== Wanden en bodem ==
  
−
The chart wall is the background of the coordinate system where the data is plotted.
+
De wand van het diagram is de achtergrond van het coördinatensysteem waar de gegevens worden geplot.
−
Two chart walls usually exist for 3D charts: one behind the plotted data and one as the left-hand or right-hand demarcation. This depends on the rotation of the chart. 3D charts usually also have a floor.
+
Voor 3D-diagrammen bestaan gewoonlijk twee wanden: één achter de geplotte gegevens en één als demarcatie aan de linker- of rechterkant. Dit is afhankelijk van de rotatie van het diagram. 3D-diagrammen hebben gewoonlijk ook een bodem.
  
−
The <tt>Diagram</tt> object provides the properties Wall and Floor:
+
Het object <tt>Diagram</tt> verschaft de eigenschappen Wall en Floor:
  
−
;<tt>Wall (Object)</tt>:background wall of the coordinate system (supports <idl>com.sun.star.chart.ChartArea</idl> service)
+
;<tt>Wall (Object)</tt>:wand voor de achtergrond van het coördinatensysteem (ondersteunt service <idl>com.sun.star.chart.ChartArea</idl>)
−
;<tt>Floor (Object)</tt>:floor panel of coordinate system (only for 3D charts, supports <idl>com.sun.star.chart.ChartArea</idl> service)
+
;<tt>Floor (Object)</tt>:bodempaneel van het coördinatensysteem (alleen voor 3D-diagrammen, ondersteunt service <idl>com.sun.star.chart.ChartArea</idl>)
  
−
The specified objects support the <tt>com.sun.star.chart.ChartArea</tt> service, which provides the usual fill and line properties (<idl>com.sun.star.drawing.FillProperties</idl> and <idl>com.sun.star.drawing.LineProperties</idl> services, refer to [[Documentation/BASIC_Guide/Drawings_Presentations|Drawings and Presentations]]).
+
De gespecificeerde objecten ondersteunen de service <tt>com.sun.star.chart.ChartArea</tt>, die op zijn beurt de gebruikelijke eigenschappen voor vulling en lijn verschaft (services <idl>com.sun.star.drawing.FillProperties</idl> en <idl>com.sun.star.drawing.LineProperties</idl>, bekijk [[NL/Documentation/BASIC_Guide/Drawings_Presentations|Tekeningen en presentaties]]).
  
−
The following example shows how graphics (named Sky) already contained in {{OOo}} can be used as a background for a chart. The wall is set to be blue.
+
Het volgende voorbeeld toont hoe een afbeelding (genaamd Sky) die reeds is opgenomen in {{AOo}} kan worden gebruikt als achtergrond voor een diagram. De wand wordt ingesteld op blauw.
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
Dim Doc As Object
 
Dim Doc As Object
−
Dim Charts As Object
+
Dim Diagrammen As Object
−
Dim Chart as Object
+
Dim Diagram as Object
−
Dim Rect As New com.sun.star.awt.Rectangle
+
Dim Recht As New com.sun.star.awt.Rectangle
−
Dim RangeAddress(0) As New com.sun.star.table.CellRangeAddress
+
Dim Celbereik(0) As New com.sun.star.table.CellRangeAddress
  
−
Rect.X = 8000
+
Recht.X = 8000
−
Rect.Y = 1000
+
Recht.Y = 1000
−
Rect.Width = 10000
+
Recht.Width = 10000
−
Rect.Height = 7000
+
Recht.Height = 7000
−
RangeAddress(0).Sheet = 0
+
Celbereik(0).Sheet = 0
−
RangeAddress(0).StartColumn = 0  
+
Celbereik(0).StartColumn = 0  
−
RangeAddress(0).StartRow = 0
+
Celbereik(0).StartRow = 0
−
RangeAddress(0).EndColumn = 2
+
Celbereik(0).EndColumn = 2
−
RangeAddress(0).EndRow = 12
+
Celbereik(0).EndRow = 12
  
 
Doc = ThisComponent
 
Doc = ThisComponent
  
−
Charts = Doc.Sheets(0).Charts
+
Diagrammen = Doc.Sheets(0).Charts
−
Charts.addNewByName("MyChart", Rect, RangeAddress(), True, True)
+
Diagrammen.addNewByName("MijnDiagram", Recht, CelBereik(), True, True)
−
Chart = Charts.getByName("MyChart").EmbeddedObject
+
Diagram = Diagrammen.getByName("MijnDiagram").EmbeddedObject
−
Chart.Area.FillStyle = com.sun.star.drawing.FillStyle.BITMAP
+
Diagram.Area.FillStyle = com.sun.star.drawing.FillStyle.BITMAP
−
Chart.Area.FillBitmapName = "Sky"
+
Diagram.Area.FillBitmapName = "Sky"
−
Chart.Area.FillBitmapMode = com.sun.star.drawing.BitmapMode.REPEAT
+
Diagram.Area.FillBitmapMode = com.sun.star.drawing.BitmapMode.REPEAT
  
−
Chart.Diagram.Wall.FillStyle = com.sun.star.drawing.FillStyle.SOLID
+
Diagram.Diagram.Wall.FillStyle = com.sun.star.drawing.FillStyle.SOLID
−
Chart.Diagram.Wall.FillColor = RGB(00,132,209)
+
Diagram.Diagram.Wall.FillColor = RGB(00,132,209)
−
</source>
+
</syntaxhighlight>
  
−
== Axes ==
+
== Assen ==
  
−
{{OOo}} recognizes five different axes that can be used in a chart. In the simplest scenario, these are the X and Y-axes. When working with 3D charts, a Z-axis is also sometimes provided. For charts in which the values of the various rows of data deviate significantly from one another, {{OOo}} provides a second X and Y-axis for second scaling operations.
+
{{AOo}} herkent vijf verschillende assen die kunnen worden gebruikt in een diagram. In het eenvoudigste scenario zijn dit de X- en Y-assen. Bij het werken met 3D-diagrammen wordt soms ook een Z-as verschaft. Voor diagrammen waarin de waarden van de verschillende rijen met gegevens significant van elkaar afwijken, verschaft {{AOo}} een tweede X- en Y-as voor tweede bewerkingen om te schalen.
  
−
The <tt>Diagram</tt> object provides the following properties to access the axes:
+
Het object <tt>Diagram</tt> verschaft de volgende eigenschappen om toegang te krijgen tot de assen:
  
−
;<tt>HasXAxis (Boolean)</tt>:activates the X-axis
+
;<tt>HasXAxis (Boolean)</tt>:activeert de X-as
−
;<tt>XAxis (Object)</tt>:object with detailed information about the X-axis (supports <idl>com.sun.star.chart.ChartAxis</idl> service)
+
;<tt>XAxis (Object)</tt>:object met gedetailleerde informatie over de X-as (ondersteunt service <idl>com.sun.star.chart.ChartAxis</idl>)
−
;<tt>HasXAxisDescription (Boolean)</tt>:activates the labels for the interval marks for the X-axis
+
;<tt>HasXAxisDescription (Boolean)</tt>:activeert de labels voor de markeringen voor de interval voor de X-as
  
−
;<tt>HasYAxis (Boolean)</tt>:activates the Y-axis
+
;<tt>HasYAxis (Boolean)</tt>:activeert de Y-as
−
;<tt>YAxis (Object)</tt>:object with detailed information about the Y-axis (supports <idl>com.sun.star.chart.ChartAxis</idl> service)
+
;<tt>YAxis (Object)</tt>:object met gedetailleerde informatie over de Y-as (ondersteunt service <idl>com.sun.star.chart.ChartAxis</idl>)
−
;<tt>HasYAxisDescription (Boolean)</tt>:activates the labels for the interval marks for the Y-axis
+
;<tt>HasYAxisDescription (Boolean)</tt>:activeert de labels voor de markeringen voor de interval voor de Y-as
  
−
;<tt>HasZAxis (Boolean)</tt>:activates the Z-axis
+
;<tt>HasZAxis (Boolean)</tt>:activeert de Z-as
−
;<tt>ZAxis (Object)</tt>:object with detailed information about the Z-axis (supports <idl>com.sun.star.chart.ChartAxis</idl> service)
+
;<tt>ZAxis (Object)</tt>:object met gedetailleerde informatie over de Y-as (ondersteunt service <idl>com.sun.star.chart.ChartAxis</idl>)
−
;<tt>HasZAxisDescription (Boolean)</tt>:activates the labels for the interval marks for the Z-axis
+
;<tt>HasZAxisDescription (Boolean)</tt>:activeert de labels voor de markeringen voor de interval voor de Z-as
  
−
;<tt>HasSecondaryXAxis (Boolean)</tt>:activates the secondary X-axis
+
;<tt>HasSecondaryXAxis (Boolean)</tt>:activeert de secundaire X-as
−
;<tt>SecondaryXAxis (Object)</tt>:object with detailed information about the secondary X-axis (supports <idl>com.sun.star.chart.ChartAxis</idl> service)
+
;<tt>SecondaryXAxis (Object)</tt>:object met gedetailleerde informatie over de secundaire X-as (ondersteunt service <idl>com.sun.star.chart.ChartAxis</idl>)
−
;<tt>HasSecondaryXAxisDescription (Boolean)</tt>:activates the labels for the interval marks for the secondary X-axis
+
;<tt>HasSecondaryXAxisDescription (Boolean)</tt>:activeert de labels voor de markeringen voor de interval voor de secundaire X-as
  
−
;<tt>HasSecondaryYAxis (Boolean)</tt>:activates the secondary Y-axis
+
;<tt>HasSecondaryYAxis (Boolean)</tt>:activeert de secundaire Y-as
−
;<tt>SecondaryYAxis (Object)</tt>:object with detailed information about the secondary Y-axis (supports <idl>com.sun.star.chart.ChartAxis</idl> service)
+
;<tt>SecondaryYAxis (Object)</tt>:object met gedetailleerde informatie over de secundaire Y-as (ondersteunt service <idl>com.sun.star.chart.ChartAxis</idl> service)
−
;<tt>HasSecondaryYAxisDescription (Boolean)</tt>:activates the labels for the interval marks for the secondary Y-axis
+
;<tt>HasSecondaryYAxisDescription (Boolean)</tt>:activeert de labels voor de markeringen voor de interval voor de secundaire Y-as
  
−
== Properties of Axes ==
+
== Eigenschappen van assen ==
  
−
The axis objects of a {{OOo}} chart support the <idl>com.sun.star.chart.ChartAxis</idl> service. In addition to the properties for characters <idl>(com.sun.star.style.CharacterProperties</idl> service, refer to [[Documentation/BASIC_Guide/Text_Documents|Text Documents]]) and lines <idl>(com.sun.star.drawing.LineStyle</idl> service, refer to [[Documentation/BASIC_Guide/Drawings_Presentations|Drawings and Presentations]]), it provides the following properties:
+
De objecten voor assen van een diagram van {{AOo}} ondersteunen de service <idl>com.sun.star.chart.ChartAxis</idl>. In aanvulling op de service voor eigenschappen van tekens <idl>(com.sun.star.style.CharacterProperties</idl>, bekijk [[NL/Documentation/BASIC_Guide/Text Documents|Tekstdocumenten]]) en service voor lijnen <idl>(com.sun.star.drawing.LineStyle</idl>, bekijk [[NL/Documentation/BASIC_Guide/Drawings_Presentations|Tekeningen en presentaties]]), verschaft het de volgende eigenschappen:
  
−
===Scaling properties:===
+
===Eigenschappen voor schalen:===
−
;<tt>Max (Double)</tt>:maximum value for axis
+
;<tt>Max (Double)</tt>:maximum waarde voor as
−
;<tt>Min (Double)</tt>:minimum value for axis
+
;<tt>Min (Double)</tt>:minimum waarde voor as
−
;<tt>Origin (Double)</tt>:point of intersect for crossing axes
+
;<tt>Origin (Double)</tt>:startpunt voor kruisende assen
−
;<tt>StepMain (Double)</tt>:distance between the major interval marks
+
;<tt>StepMain (Double)</tt>:afstand tussen twee markeringen voor de hoofdinterval van de as
−
;<tt>StepHelp (Double)</tt>:distance between the minor interval marks (deprecated since OpenOffice.org 3.0; Use property StepHelpCount instead)
+
;<tt>StepHelp (Double)</tt>:afstand tussen twee markeringen voor de interval van de as (vervallen sinds OpenOffice.org 3.0; Gebruik in plaats daarvan de eigenschap StepHelpCount)
−
;<tt>StepHelpCount (Long)</tt>:Contains the number of minor intervals within a major interval. E.g. a StepHelpCount of 5 divides the major interval into 5 pieces and thus produces 4 minor tick marks. (available since OpenOffice.org 3.0)
+
;<tt>StepHelpCount (Long)</tt>:Bevat het aantal kleinere intervallen binnen een hoofdinterval. Bijv: een StepHelpCount van 5 deelt de hoofdinterval in 5 delen en  produceert dus 4 kleinere markeringen. (beschikbaar sinds OpenOffice.org 3.0)
−
;<tt>AutoMax (Boolean)</tt>:the maximum value for the axis is calculated automatically when set to true
+
;<tt>AutoMax (Boolean)</tt>:de maximale waarde voor de as wordt automatisch berekend indien ingesteld op true
−
;<tt>AutoMin (Boolean)</tt>:the minimum value for the axis is calculated automatically when set to true
+
;<tt>AutoMin (Boolean)</tt>:de minimale waarde voor de as wordt automatisch berekend indien ingesteld op true
−
;<tt>AutoOrigin (Boolean)</tt>:the origin is determined automatically when set to true
+
;<tt>AutoOrigin (Boolean)</tt>:de startpunt wordt automatisch bepaald indien ingesteld op true
−
;<tt>AutoStepMain (Boolean)</tt>:StepMain is determined automatically when set to true
+
;<tt>AutoStepMain (Boolean)</tt>:StepMain wordt automatisch bepaald indien ingesteld op true
−
;<tt>AutoStepHelp (Boolean)</tt>:StepHelpCount is determined automatically when set to true
+
;<tt>AutoStepHelp (Boolean)</tt>:StepHelpCount wordt automatisch bepaald indien ingesteld op true
−
;<tt>Logarithmic (Boolean)</tt>:scales the axes in logarithmic manner (rather than linear)
+
;<tt>Logarithmic (Boolean)</tt>:schaalt de assen in op een logaritmische manier (in plaats van lineair)
−
;<tt>ReverseDirection (Boolean)</tt>:determines if the axis orientation is mathematical or reversed. (available since OpenOffice.org 2.4)
+
;<tt>ReverseDirection (Boolean)</tt>:bepaalt of de oriëntatie van de as wiskundig is of omgekeerd. (beschikbaar sinds OpenOffice.org 2.4)
  
−
===Label properties:===
+
===Eigenschappen voor labels:===
−
;<tt>DisplayLabels (Boolean)</tt>:activates the text label at the interval marks
+
;<tt>DisplayLabels (Boolean)</tt>:activeert het tekstlabel op de markeringen voor de interval
−
;<tt>TextRotation (Long)</tt>:angle of rotation of text label in 100ths of a degree
+
;<tt>TextRotation (Long)</tt>:draaihoek van tekstlabels in 100-en van een graad
−
;<tt>ArrangeOrder (enum)</tt>:the label may be staggered, thus they are positioned alternately over two lines (values according to <idl>com.sun.star.chart.ChartAxisArrangeOrderType</idl>)
+
;<tt>ArrangeOrder (enum)</tt>:de labels kunnen op elkaar gestapeld zijn, dus zij worden afwisselend op twee regels geplaatst (waarden overeenkomstig met <idl>com.sun.star.chart.ChartAxisArrangeOrderType</idl>)
−
;<tt>TextBreak (Boolean)</tt>:permits line breaks within the axes labels
+
;<tt>TextBreak (Boolean)</tt>:staat regeleinden toe binnen de labels van de assen
−
;<tt>TextCanOverlap (Boolean)</tt>:permits an overlap of the axes labels
+
;<tt>TextCanOverlap (Boolean)</tt>:staat een overlapping toe van de labels van de assen
−
;<tt>NumberFormat (Long)</tt>:number format to be used with the axes labels
+
;<tt>NumberFormat (Long)</tt>:getalopmaak die moet worden gebruikt voor de labels van de assen
−
;<tt>LinkNumberFormatToSource (Boolean)</tt>:determines whether to use the number format given by the container document, or from the property <tt>NumberFormat</tt>. (since OpenOffice.org 2.3)
+
;<tt>LinkNumberFormatToSource (Boolean)</tt>:bepaalt of de getalopmaak wordt bepaald door het containerdocument, of vanuit de eigenschap <tt>NumberFormat</tt>. (sinds OpenOffice.org 2.3)
  
−
===Interval mark properties:===
+
===Eigenschappen voor markeringen van intervallen:===
−
;<tt>Marks (Const)</tt>:determines the position of the major interval marks (values in accordance with <idl>com.sun.star.chart.ChartAxisMarks</idl>)
+
;<tt>Marks (Const)</tt>:bepaalt de positie van de markering van de hoofdinterval (waarden overeenkomend met <idl>com.sun.star.chart.ChartAxisMarks</idl>)
−
;<tt>HelpMarks (Const)</tt>:determines the position of the minor interval marks (values in accordance with <idl>com.sun.star.chart.ChartAxisMarks</idl>)
+
;<tt>HelpMarks (Const)</tt>:bepaalt de positie van de kleinere markeringen van de interval (waarden overeenkomend met <idl>com.sun.star.chart.ChartAxisMarks</idl>)
  
−
===Only for bar charts:===
+
===Alleen voor staaf-diagrammen:===
−
;<tt>Overlap (Long)</tt>:percentage which specifies the extent to which the bars of different sets of data may overlap (at 100%, the bars are shown as completely overlapping, at -100%, there is a distance of the width of one bar between them)
+
;<tt>Overlap (Long)</tt>:percentage dat de mate specificeert waarmee de staven van de verschillende sets van gegevens elkaar mogen overlappen (met 100% worden de staven weergegeven als volledig overlappend, met -100% is er een afstand van de breedte van één staaf tussen)
−
;<tt>GapWidth (long)</tt>:percentage which specifies the distance there may be between the different groups of bars of a chart (at 100%, there is a distance corresponding to the width of one bar)
+
;<tt>GapWidth (long)</tt>:percentage dat de afstand specificeert tussen de verschillende groepen staven van een diagram (met 100% is er een afstand die overeenkomt met de breedte van één staaf)
  
−
== Grids ==
+
== Rasters ==
  
−
For the primary axes grids and sub grids can be displayed, matching to the major and minor intervals.
+
Voor de primaire assen kunnen rasters en sub-rasters worden weergegeven, overeenkomend met de hoofd- en kleinere intervallen.
−
The <tt>Diagram</tt> object provides the following properties to access the grids:
+
Het object <tt>Diagram</tt> verschaft de volgende eigenschappen voor toegang tot de rasters:
  
−
;<tt>HasXAxisGrid (Boolean)</tt>:activates major grid for X-axis
+
;<tt>HasXAxisGrid (Boolean)</tt>:activeert het hoofdraster voor de X-as
−
;<tt>XMainGrid (Object)</tt>:object with detailed information about the major grid for X-axis (supports <idl>com.sun.star.chart.ChartGrid</idl> service)
+
;<tt>XMainGrid (Object)</tt>:object met gedetailleerde informatie over het hoofdraster voor de X-as (ondersteunt service <idl>com.sun.star.chart.ChartGrid</idl>)
−
;<tt>HasXAxisHelpGrid (Boolean)</tt>:activates minor grid for X-axis
+
;<tt>HasXAxisHelpGrid (Boolean)</tt>:activeert sub-raster voor de X-as
−
;<tt>XHelpGrid (Object)</tt>:object with detailed information about the minor grid for X-axis (supports <idl>com.sun.star.chart.ChartGrid</idl> service)
+
;<tt>XHelpGrid (Object)</tt>:object met gedetailleerde informatie over het sub-raster voor de X-as (ondersteunt service  <idl>com.sun.star.chart.ChartGrid</idl>)
  
−
the same for y and z:
+
hetzelfde voor Y en Z:
  
−
;<tt>HasYAxisGrid (Boolean)</tt>:activates major grid for Y-axis
+
;<tt>HasYAxisGrid (Boolean)</tt>:activeert het hoofdraster voor de Y-as
−
;<tt>YMainGrid (Object)</tt>:object with detailed information about the major grid for Y-axis (supports <idl>com.sun.star.chart.ChartGrid</idl> service)
+
;<tt>YMainGrid (Object)</tt>:object met gedetailleerde informatie over het hoofdraster voor de Y-as (ondersteunt service <idl>com.sun.star.chart.ChartGrid</idl>)
−
;<tt>HasYAxisHelpGrid (Boolean)</tt>:activates minor grid for Y-axis
+
;<tt>HasYAxisHelpGrid (Boolean)</tt>:activeert sub-raster voor de Y-as
−
;<tt>YHelpGrid (Object)</tt>:object with detailed information about the minor grid for Y-axis (supports <idl>com.sun.star.chart.ChartGrid</idl> service)
+
;<tt>YHelpGrid (Object)</tt>:object met gedetailleerde informatie over het sub-raster voor de Y-as (ondersteunt service <idl>com.sun.star.chart.ChartGrid</idl>)
  
−
;<tt>HasZAxisGrid (Boolean)</tt>:activates major grid for Z-axis
+
;<tt>HasZAxisGrid (Boolean)</tt>:activeert het hoofdraster voor de Z-as
−
;<tt>ZMainGrid (Object)</tt>:object with detailed information about the major grid for Z-axis (supports <idl>com.sun.star.chart.ChartGrid</idl> service)
+
;<tt>ZMainGrid (Object)</tt>:object met gedetailleerde informatie over het hoofdraster voor de Z-as (ondersteunt service <idl>com.sun.star.chart.ChartGrid</idl>)
−
;<tt>HasZAxisHelpGrid (Boolean)</tt>:activates minor grid for Z-axis
+
;<tt>HasZAxisHelpGrid (Boolean)</tt>:activeert sub-raster voor de Z-as
−
;<tt>ZHelpGrid (Object)</tt>:object with detailed information about the minor grid for Z-axis (supports <idl>com.sun.star.chart.ChartGrid</idl> service)
+
;<tt>ZHelpGrid (Object)</tt>:object met gedetailleerde informatie over het sub-raster voor de Z-as (ondersteunt service <idl>com.sun.star.chart.ChartGrid</idl>)
  
−
The grid object is based on the <idl>com.sun.star.chart.ChartGrid</idl> service, which in turn supports the line properties of the <idl>com.sun.star.drawing.LineStyle</idl> support service (refer to [[Documentation/BASIC_Guide/Drawings_Presentations|Drawings and Presentations]]).
+
Het object voor het raster is gebaseerd op de service <idl>com.sun.star.chart.ChartGrid</idl>, die op zijn beurt de lijn-eigenschappen ondersteunt van de ondersteunende service <idl>com.sun.star.drawing.LineStyle</idl> (bekijk [[NL/Documentation/BASIC_Guide/Drawings_Presentations|Tekeningen en presentaties]]).
  
−
== Axes Title ==
+
== Titels voor assen ==
  
−
For all axes an additional title can be displayed.
+
Voor alle assen kan een aanvullende titel worden weergegeven.
−
The <tt>Diagram</tt> object provides the following properties to access the axes title:
+
Het object <tt>Diagram</tt> verschaft de volgende eigenschappen voor toegang tot de titel van de assen:
  
−
;<tt>HasXAxisTitle (Boolean)</tt>:activates title of X-axis
+
;<tt>HasXAxisTitle (Boolean)</tt>:activeert de titel van de X-as
−
;<tt>XAxisTitle (Object)</tt>:object with detailed information about title of the X-axis (supports <idl>com.sun.star.chart.ChartTitle</idl> service)
+
;<tt>XAxisTitle (Object)</tt>:object met gedetailleerde informatie over de titel van de X-as (ondersteunt service <idl>com.sun.star.chart.ChartTitle</idl>)
  
−
same y and z:
+
hetzelfde voor Y en Z:
  
−
;<tt>HasYAxisTitle (Boolean)</tt>:activates title of Y-axis
+
;<tt>HasYAxisTitle (Boolean)</tt>:activeert de titel van de Y-as
−
;<tt>YAxisTitle (Object)</tt>:object with detailed information about title of the Y-axis (supports <idl>com.sun.star.chart.ChartTitle</idl> service)
+
;<tt>YAxisTitle (Object)</tt>:object met gedetailleerde informatie over de titel van de Y-as (ondersteunt service <idl>com.sun.star.chart.ChartTitle</idl>)
  
−
;<tt>HasZAxisTitle (Boolean)</tt>:activates title of Z-axis
+
;<tt>HasZAxisTitle (Boolean)</tt>:activeert de titel van de Z-as
−
;<tt>ZAxisTitle (Object)</tt>:object with detailed information about title of the Z-axis (supports <idl>com.sun.star.chart.ChartTitle</idl> service)
+
;<tt>ZAxisTitle (Object)</tt>:object met gedetailleerde informatie over de titel van de Z-as (ondersteunt service <idl>com.sun.star.chart.ChartTitle</idl>)
  
−
and for the secondary axes (available since OpenOffice.org 3.0):
+
en voor de secondaire assen (beschikbaar sinds OpenOffice.org 3.0):
  
−
;<tt>HasSecondaryXAxisTitle (Boolean)</tt>:activates title of the secondary X-axis.  
+
;<tt>HasSecondaryXAxisTitle (Boolean)</tt>:activeert de titel van de secundaire X-as.  
−
;<tt>SecondXAxisTitle (Object)</tt>:object with detailed information about title of the secondary X-axis (supports <idl>com.sun.star.chart.ChartTitle</idl> service)
+
;<tt>SecondXAxisTitle (Object)</tt>:object met gedetailleerde informatie over de titel van de secundaire X-as (ondersteunt service <idl>com.sun.star.chart.ChartTitle</idl>)
  
−
;<tt>HasSecondaryYAxisTitle (Boolean)</tt>:activates title of the secondary Y-axis.  
+
;<tt>HasSecondaryYAxisTitle (Boolean)</tt>:activeert de titel van de secundaire Y-as.  
−
;<tt>SecondYAxisTitle (Object)</tt>:object with detailed information about title of the secondary Y-axis (supports <idl>com.sun.star.chart.ChartTitle</idl> service)
+
;<tt>SecondYAxisTitle (Object)</tt>:object met gedetailleerde informatie over de titel van de secundaire X-as (ondersteunt service <idl>com.sun.star.chart.ChartTitle</idl>)
  
−
The objects for formatting the axes title are based on the <idl>com.sun.star.chart.ChartTitle</idl> service, which is also used for chart titles.
+
De objecten voor het opmaken van de titels van de assen zijn gebaseerd op de service <idl>com.sun.star.chart.ChartTitle</idl>, die ook wordt gebruikt voor de titels van het diagram.
  
−
=== Example ===
+
=== Voorbeeld ===
  
−
The following example creates a line chart. The color for the rear wall of the chart is set to white. Both the X and Y-axes have a gray grid for visual orientation. The minimum value of the Y-axis is fixed to 0 and the maximum value is fixed to 100 so that the resolution of the chart is retained even if the values are changed. The X-axis points in reverse direction from right to left. And a title for the X-axis was added.
+
Het volgende voorbeeld maakt een lijn-diagram. De kleur van de achterwand van het diagram is ingesteld op wit. Zowel de X als de Y-as hebben een grijs hulp-raster voor visuele oriëntatie. De minimum waarde van de Y-as is vast ingesteld op 0 en de maximum waarde is vast ingesteld op 100 zodat de uitvoering van het diagram wordt behouden, zelfs als de waarden worden veranderd. De X-as loopt in omgekeerde richting van rechts naar links. Een titel voor de X-as is toegevoegd.
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
Dim Doc As Object
 
Dim Doc As Object
−
Dim Charts As Object
+
Dim Diagrammen As Object
−
Dim Chart as Object
+
Dim Diagram as Object
−
Dim Rect As New com.sun.star.awt.Rectangle
+
Dim Recht As New com.sun.star.awt.Rectangle
−
Dim RangeAddress(0) As New com.sun.star.table.CellRangeAddress
+
Dim CelBereik(0) As New com.sun.star.table.CellRangeAddress
  
 
Doc = ThisComponent
 
Doc = ThisComponent
−
Charts = Doc.Sheets(0).Charts
+
Diagrammen = Doc.Sheets(0).Charts
  
−
Rect.X = 8000
+
Recht.X = 8000
−
Rect.Y = 1000
+
Recht.Y = 1000
−
Rect.Width = 10000
+
Recht.Width = 10000
−
Rect.Height = 7000
+
Recht.Height = 7000
−
RangeAddress(0).Sheet = 0
+
CelBereik(0).Sheet = 0
−
RangeAddress(0).StartColumn = 0  
+
CelBereik(0).StartColumn = 0  
−
RangeAddress(0).StartRow = 0
+
CelBereik(0).StartRow = 0
−
RangeAddress(0).EndColumn = 2
+
CelBereik(0).EndColumn = 2
−
RangeAddress(0).EndRow = 12
+
CelBereik(0).EndRow = 12
  
−
Charts.addNewByName("MyChart", Rect, RangeAddress(), True, True)
+
Diagrammen.addNewByName("MijnDiagram", Recht, CelBereik(), True, True)
−
Chart = Charts.getByName("MyChart").embeddedObject
+
Diagram = Diagrammen.getByName("MijnDiagram").embeddedObject
−
Chart.Diagram = Chart.createInstance("com.sun.star.chart.LineDiagram")
+
Diagram.Diagram = Diagram.createInstance("com.sun.star.chart.LineDiagram")
−
Chart.Diagram.Wall.FillColor = RGB(255, 255, 255)
+
Diagram.Diagram.Wall.FillColor = RGB(255, 255, 255)
−
Chart.Diagram.HasXAxisGrid = True
+
Diagram.Diagram.HasXAxisGrid = True
−
Chart.Diagram.XMainGrid.LineColor = RGB(192, 192, 192)
+
Diagram.Diagram.XMainGrid.LineColor = RGB(192, 192, 192)
−
Chart.Diagram.HasYAxisGrid = True
+
Diagram.Diagram.HasYAxisGrid = True
−
Chart.Diagram.YMainGrid.LineColor = RGB(192, 192, 192)
+
Diagram.Diagram.YMainGrid.LineColor = RGB(192, 192, 192)
−
Chart.Diagram.YAxis.Min = 0  
+
Diagram.Diagram.YAxis.Min = 0  
−
Chart.Diagram.YAxis.Max = 100
+
Diagram.Diagram.YAxis.Max = 100
  
−
Chart.Diagram.XAxis.ReverseDirection = true 'needs OpenOffice.org 2.4 or newer
+
Diagram.Diagram.XAxis.ReverseDirection = true 'heeft OpenOffice.org 2.4 of nieuwer nodig
−
Chart.Diagram.HasXAxisTitle = true
+
Diagram.Diagram.HasXAxisTitle = true
−
Chart.Diagram.XAxisTitle.String = "Reversed X Axis Example"
+
Diagram.Diagram.XAxisTitle.String = "Voorbeeld omgekeerde X-as"
−
</source>
+
</syntaxhighlight>
  
−
== 3D Charts ==
+
== 3D-diagrammen ==
  
−
Most charts in {{OOo}} can also be displayed with 3D graphics. The following properties are provided for 3D charts at the <tt>Diagram</tt> object:
+
De meeste diagrammen in {{AOo}} kunnen ook worden weergegeven met 3D-afbeelding. De volgende eigenschappen worden verschaft voor 3D-diagrammen voor het object <tt>Diagram</tt>:
  
−
;<tt>Dim3D (Boolean)</tt>:activates 3D display
+
De meest diagrammen kunnen ook worden weergegeven met 3D-afbeeldingen.  
−
;<tt>Deep (Boolean)</tt>:the series will be arranged behind each other in z-direction
+
−
;<tt>RightAngledAxes (Boolean)</tt>:activates a 3D display mode where X- and Y-axes form a right angle within the projection. (available since OpenOffice.org 2.3)
+
−
;<tt>D3DScenePerspective (Enum)</tt>:defines whether the 3D objects are to be drawn in perspective or parallel projection.(values according to <idl>com.sun.star.drawing.ProjectionMode</idl>)
+
−
;<tt>Perspective (Long)</tt>:Perspective of 3D charts ( [0,100] ) (available since OpenOffice.org 2.4.1)
+
−
;<tt>RotationHorizontal (Long)</tt>:Horizontal rotation of 3D charts in degrees ( [-180,180] ) (available since OpenOffice.org 2.4.1)
+
−
;<tt>RotationVertical (Long)</tt>:Vertical rotation of 3D charts in degrees ( [-180,180] ) (available since OpenOffice.org 2.4.1)
+
  
−
The following example creates a 3D area chart.
+
;<tt>Dim3D (Boolean)</tt>:activeert weergave in 3D
 +
;<tt>Deep (Boolean)</tt>:de reeks zal achter elkaar worden geschikt in de  richting van Z
 +
;<tt>RightAngledAxes (Boolean)</tt>:activeert een modus 3D-weergave waar X- en Y-assen een rechte hoek vormen binnen de projectie. (beschikbaar sinds OpenOffice.org 2.3)
 +
;<tt>D3DScenePerspective (Enum)</tt>:definieert of de 3D-objecten moeten worden getekend in projectie met perspectief of parallel.(waarden overeenkomend met <idl>com.sun.star.drawing.ProjectionMode</idl>)
 +
;<tt>Perspective (Long)</tt>:Perspectief van 3D-diagrammen ( [0,100] ) (beschikbaar sinds OpenOffice.org 2.4.1)
 +
;<tt>RotationHorizontal (Long)</tt>:Horizontale rotatie van 3D-diagrammen in graden ( [-180,180] ) (beschikbaar sinds OpenOffice.org 2.4.1)
 +
;<tt>RotationVertical (Long)</tt>:Verticale rotatie van 3D-diagrammen in graden ( [-180,180] ) (beschikbaar sinds OpenOffice.org 2.4.1)
  
−
<source lang="oobas">
+
Het volgende voorbeeld maakt een 3D-vlakdiagram.
 +
 
 +
<syntaxhighlight lang="oobas">
 
Dim Doc As Object
 
Dim Doc As Object
−
Dim Charts As Object
+
Dim Diagrammen As Object
−
Dim Chart as Object
+
Dim Diagram as Object
−
Dim Rect As New com.sun.star.awt.Rectangle
+
Dim Recht As New com.sun.star.awt.Rectangle
−
Dim RangeAddress(0) As New com.sun.star.table.CellRangeAddress
+
Dim CelBereik(0) As New com.sun.star.table.CellRangeAddress
  
 
Doc = ThisComponent
 
Doc = ThisComponent
−
Charts = Doc.Sheets(0).Charts
+
Diagrammen = Doc.Sheets(0).Charts
  
−
Rect.X = 8000
+
Recht.X = 8000
−
Rect.Y = 1000
+
Recht.Y = 1000
−
Rect.Width = 10000
+
Recht.Width = 10000
−
Rect.Height = 7000
+
Recht.Height = 7000
−
RangeAddress(0).Sheet = 0
+
CelBereik(0).Sheet = 0
−
RangeAddress(0).StartColumn = 0  
+
CelBereik(0).StartColumn = 0  
−
RangeAddress(0).StartRow = 0
+
CelBereik(0).StartRow = 0
−
RangeAddress(0).EndColumn = 2
+
CelBereik(0).EndColumn = 2
−
RangeAddress(0).EndRow = 12
+
CelBereik(0).EndRow = 12
  
−
Charts.addNewByName("MyChart", Rect, RangeAddress(), True, True)
+
Diagrammen.addNewByName("MijnDiagram", Recht, CelBereik(), True, True)
−
Chart = Charts.getByName("MyChart").embeddedObject
+
Diagram = Diagrammen.getByName("MijnDiagram").embeddedObject
−
Chart.Diagram = Chart.createInstance("com.sun.star.chart.AreaDiagram")
+
Diagram.Diagram = Diagram.createInstance("com.sun.star.chart.AreaDiagram")
−
Chart.Diagram.Dim3D = true
+
Diagram.Diagram.Dim3D = true
−
Chart.Diagram.Deep = true
+
Diagram.Diagram.Deep = true
−
Chart.Diagram.RightAngledAxes = true 'needs OpenOffice.org 2.3 or newer
+
Diagram.Diagram.RightAngledAxes = true 'heeft OpenOffice.org 2.3 of nieuwer nodig
−
Chart.Diagram.D3DScenePerspective = com.sun.star.drawing.ProjectionMode.PERSPECTIVE
+
Diagram.Diagram.D3DScenePerspective = com.sun.star.drawing.ProjectionMode.PERSPECTIVE
−
Chart.Diagram.Perspective = 100 'needs OpenOffice.org 2.4.1 or newer
+
Diagram.Diagram.Perspective = 100 'heeft OpenOffice.org 2.4.1 of nieuwer nodig
−
Chart.Diagram.RotationHorizontal = 60 'needs OpenOffice.org 2.4.1 or newer
+
Diagram.Diagram.RotationHorizontal = 60 'heeft OpenOffice.org 2.4.1 of nieuwer nodig
−
Chart.Diagram.RotationVertical = 30 'needs OpenOffice.org 2.4.1 or newer
+
Diagram.Diagram.RotationVertical = 30 'heeft OpenOffice.org 2.4.1 of nieuwer nodig
−
</source>
+
</syntaxhighlight>
  
−
== Stacked Charts ==
+
== Gestapelde diagrammen ==
  
−
Stacked charts are charts that are arranged with several individual values on top of one another to produce a total value. This view shows not only the individual values, but also an overview of all the values.
+
Gestapelde diagrammen zijn diagrammen die worden gepresenteerd met verscheidene individuele waarden op elkaar om een totale waarde te produceren. Deze weergave toont niet alleen de individuele waarden, maar ook een overzicht van alle waarden.
  
−
In {{OOo}}, various types of charts can be displayed in a stacked form. All of these charts support the <idl>com.sun.star.chart.StackableDiagram</idl> service, which in turn provides the following properties:
+
In {{AOo}} kunnen verschillende typen diagram worden weergegeven in een gestapelde vorm. Al deze diagrammen ondersteunen de service <idl>com.sun.star.chart.StackableDiagram</idl>, welke op zijn beurt de volgende eigenschappen verschaft:
  
−
;<tt>Stacked (Boolean)</tt>:activates the stacked viewing mode
+
;<tt>Stacked (Boolean)</tt>:activeert de modus voor gestapeld weergeven
−
;<tt>Percent (Boolean)</tt>:rather than absolute values, displays their percentage distribution
+
;<tt>Percent (Boolean)</tt>:in plaats van absolute waarden, geef het percentage van hun verdeling weer
  
 
{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Structure of Charts}}
 
{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Structure of Charts}}
 
{{PDL1}}
 
{{PDL1}}

Latest revision as of 16:53, 26 August 2022

Book.png


De structuur van een diagram, en daaropvolgend de lijst van daardoor ondersteunde services en interfaces, is afhankelijk van het type. De methoden en eigenschappen van de Z-as, zijn bijvoorbeeld alleen beschikbaar in 3D-diagrammen, maar niet in 2D-diagrammen. In taart-diagrammen zijn er geen interfaces voor het werken met assen.

Titel, subtitel en legenda

Een titel, sub-titel en legenda vormen een deel van de basiselementen van elk diagram. Diagrammen verschaffen hun eigen objecten voor elk van deze elementen. Het object Chart verschaft de volgende eigenschappen voor het beheren van deze elementen:

HasMainTitle (Boolean)
activeert de titel
Title (Object)
object met gedetailleerde informatie over de titel van het diagram (ondersteunt de service com.sun.star.chart.ChartTitle)
HasSubTitle(Boolean)
activeert de subtitel
Subtitle (Object)
object met gedetailleerde informatie over de subtitel van het diagram (ondersteunt de service com.sun.star.chart.ChartTitle)
HasLegend (Boolean)
activeert de legenda
Legend (Object)
object met gedetailleerde informatie over de legenda van het diagram (ondersteunt de service com.sun.star.chart.ChartLegend)

Beide services com.sun.star.chart.ChartTitle en com.sun.star.chart.ChartLegend ondersteunen de service com.sun.star.drawing.Shape. Dit maakt het mogelijk om de positie en grootte van de elementen te bepalen met behulp van de eigenschappen Position en Size. Omdat de grootte van de legenda en de titels automatisch wordt berekend gebaseerd op de huidige inhoud en bijvoorbeeld de hoogte van de tekens, verschaft de eigenschap size alleen toegang om te lezen.

Eigenschappen voor vulling en lijnen (services com.sun.star.drawing.FillProperties en com.sun.star.drawing.LineProperties) net als eigenschappen voor tekens (service com.sun.star.style.CharacterProperties) worden verschaft voor het verder opmaken van de elementen.

com.sun.star.chart.ChartTitle bevat niet alleen de opgesomde eigenschappen voor opmaak, maar ook twee andere eigenschappen:

String (String)
tekst welke moet worden getoond als de titel of subtitel
TextRotation (Long)
draaihoek van de tekst in 100-en van graden

De legenda (com.sun.star.chart.ChartLegend) bevat de volgende aanvullende eigenschap:

Alignment (Enum)
positie waar de legenda moet verschijnen (waarde van het type com.sun.star.chart.ChartLegendPosition)

Het volgende voorbeeld maakt een diagram en wijst daar de titel "Test", de subtitel "Test 2" en een legenda aan toe. De legenda heeft een grijze achtergrondkleur, staat aan de onderzijde van het diagram en heeft een tekengrootte van 7 punten. 

Dim Doc As Object
Dim Diagrammen As Object
Dim Diagram as Object
Dim Recht As New com.sun.star.awt.Rectangle
Dim CelBereik(0) As New com.sun.star.table.CellRangeAddress
 
Recht.X = 8000
Recht.Y = 1000
Recht.Width = 10000
Recht.Height = 7000
CelBereik(0).Sheet = 0
CelBereik(0).StartColumn = 0 
CelBereik(0).StartRow = 0
CelBereik(0).EndColumn = 2
CelBereik(0).EndRow = 12
 
Doc = ThisComponent
 
Diagrammen = Doc.Sheets(0).Charts
Diagrammen.addNewByName("MijnDiagram", Recht, CelBereik(), True, True)
Diagram = Diagrammen.getByName("MijnDiagram").EmbeddedObject
Diagram.HasMainTitle = True
Diagram.Title.String = "Test"
Diagram.HasSubTitle = True
Diagram.Subtitle.String = "Test 2"
Diagram.HasLegend = True 
Diagram.Legend.Alignment = com.sun.star.chart.ChartLegendPosition.BOTTOM
Diagram.Legend.FillStyle = com.sun.star.drawing.FillStyle.SOLID
Diagram.Legend.FillColor = RGB(210, 210, 210)
Diagram.Legend.CharHeight = 7

Achtergrond

Elk diagram heeft een gedeelte voor de achtergrond. Het object Chart verschaft de eigenschap Area om de achtergrond op te maken:

Area (Object)
gebied voor de achtergrond van het diagram (ondersteunt de service com.sun.star.chart.ChartArea)

De achtergrond van een diagram beslaat zijn complete gebied, inclusief het gebied onder de titel, sub-titel en diagram-legenda. De geassocieerde service com.sun.star.chart.ChartArea ondersteunt eigenschappen voor lijn en vulling.

Diagram

Het object Chart verschaft de eigenschap Diagram die het coördinatensysteem vormt met assen en raster, waar de gegevens uiteindelijk wordne weergegeven:

Diagram (Object)
object dat het coördinatensysteem vormt waar de gegevens worden geplot. Het ondersteunt de service com.sun.star.chart.Diagram en:

verschillende services worden ondersteund, afhanbkelijk van het type diagram (zie Typen diagram).

Wanden en bodem

De wand van het diagram is de achtergrond van het coördinatensysteem waar de gegevens worden geplot. Voor 3D-diagrammen bestaan gewoonlijk twee wanden: één achter de geplotte gegevens en één als demarcatie aan de linker- of rechterkant. Dit is afhankelijk van de rotatie van het diagram. 3D-diagrammen hebben gewoonlijk ook een bodem.

Het object Diagram verschaft de eigenschappen Wall en Floor:

Wall (Object)
wand voor de achtergrond van het coördinatensysteem (ondersteunt service com.sun.star.chart.ChartArea)
Floor (Object)
bodempaneel van het coördinatensysteem (alleen voor 3D-diagrammen, ondersteunt service com.sun.star.chart.ChartArea)

De gespecificeerde objecten ondersteunen de service com.sun.star.chart.ChartArea, die op zijn beurt de gebruikelijke eigenschappen voor vulling en lijn verschaft (services com.sun.star.drawing.FillProperties en com.sun.star.drawing.LineProperties, bekijk Tekeningen en presentaties).

Het volgende voorbeeld toont hoe een afbeelding (genaamd Sky) die reeds is opgenomen in Apache OpenOffice kan worden gebruikt als achtergrond voor een diagram. De wand wordt ingesteld op blauw. 

Dim Doc As Object
Dim Diagrammen As Object
Dim Diagram as Object
Dim Recht As New com.sun.star.awt.Rectangle
Dim Celbereik(0) As New com.sun.star.table.CellRangeAddress
 
Recht.X = 8000
Recht.Y = 1000
Recht.Width = 10000
Recht.Height = 7000
Celbereik(0).Sheet = 0
Celbereik(0).StartColumn = 0 
Celbereik(0).StartRow = 0
Celbereik(0).EndColumn = 2
Celbereik(0).EndRow = 12
 
Doc = ThisComponent
 
Diagrammen = Doc.Sheets(0).Charts
Diagrammen.addNewByName("MijnDiagram", Recht, CelBereik(), True, True)
Diagram = Diagrammen.getByName("MijnDiagram").EmbeddedObject
Diagram.Area.FillStyle = com.sun.star.drawing.FillStyle.BITMAP
Diagram.Area.FillBitmapName = "Sky"
Diagram.Area.FillBitmapMode = com.sun.star.drawing.BitmapMode.REPEAT
 
Diagram.Diagram.Wall.FillStyle = com.sun.star.drawing.FillStyle.SOLID
Diagram.Diagram.Wall.FillColor = RGB(00,132,209)

Assen

Apache OpenOffice herkent vijf verschillende assen die kunnen worden gebruikt in een diagram. In het eenvoudigste scenario zijn dit de X- en Y-assen. Bij het werken met 3D-diagrammen wordt soms ook een Z-as verschaft. Voor diagrammen waarin de waarden van de verschillende rijen met gegevens significant van elkaar afwijken, verschaft Apache OpenOffice een tweede X- en Y-as voor tweede bewerkingen om te schalen.

Het object Diagram verschaft de volgende eigenschappen om toegang te krijgen tot de assen:

HasXAxis (Boolean)
activeert de X-as
XAxis (Object)
object met gedetailleerde informatie over de X-as (ondersteunt service com.sun.star.chart.ChartAxis)
HasXAxisDescription (Boolean)
activeert de labels voor de markeringen voor de interval voor de X-as
HasYAxis (Boolean)
activeert de Y-as
YAxis (Object)
object met gedetailleerde informatie over de Y-as (ondersteunt service com.sun.star.chart.ChartAxis)
HasYAxisDescription (Boolean)
activeert de labels voor de markeringen voor de interval voor de Y-as
HasZAxis (Boolean)
activeert de Z-as
ZAxis (Object)
object met gedetailleerde informatie over de Y-as (ondersteunt service com.sun.star.chart.ChartAxis)
HasZAxisDescription (Boolean)
activeert de labels voor de markeringen voor de interval voor de Z-as
HasSecondaryXAxis (Boolean)
activeert de secundaire X-as
SecondaryXAxis (Object)
object met gedetailleerde informatie over de secundaire X-as (ondersteunt service com.sun.star.chart.ChartAxis)
HasSecondaryXAxisDescription (Boolean)
activeert de labels voor de markeringen voor de interval voor de secundaire X-as
HasSecondaryYAxis (Boolean)
activeert de secundaire Y-as
SecondaryYAxis (Object)
object met gedetailleerde informatie over de secundaire Y-as (ondersteunt service com.sun.star.chart.ChartAxis service)
HasSecondaryYAxisDescription (Boolean)
activeert de labels voor de markeringen voor de interval voor de secundaire Y-as

Eigenschappen van assen

De objecten voor assen van een diagram van Apache OpenOffice ondersteunen de service com.sun.star.chart.ChartAxis. In aanvulling op de service voor eigenschappen van tekens (com.sun.star.style.CharacterProperties, bekijk Tekstdocumenten) en service voor lijnen (com.sun.star.drawing.LineStyle, bekijk Tekeningen en presentaties), verschaft het de volgende eigenschappen:

Eigenschappen voor schalen:

Max (Double)
maximum waarde voor as
Min (Double)
minimum waarde voor as
Origin (Double)
startpunt voor kruisende assen
StepMain (Double)
afstand tussen twee markeringen voor de hoofdinterval van de as
StepHelp (Double)
afstand tussen twee markeringen voor de interval van de as (vervallen sinds OpenOffice.org 3.0; Gebruik in plaats daarvan de eigenschap StepHelpCount)
StepHelpCount (Long)
Bevat het aantal kleinere intervallen binnen een hoofdinterval. Bijv: een StepHelpCount van 5 deelt de hoofdinterval in 5 delen en produceert dus 4 kleinere markeringen. (beschikbaar sinds OpenOffice.org 3.0)
AutoMax (Boolean)
de maximale waarde voor de as wordt automatisch berekend indien ingesteld op true
AutoMin (Boolean)
de minimale waarde voor de as wordt automatisch berekend indien ingesteld op true
AutoOrigin (Boolean)
de startpunt wordt automatisch bepaald indien ingesteld op true
AutoStepMain (Boolean)
StepMain wordt automatisch bepaald indien ingesteld op true
AutoStepHelp (Boolean)
StepHelpCount wordt automatisch bepaald indien ingesteld op true
Logarithmic (Boolean)
schaalt de assen in op een logaritmische manier (in plaats van lineair)
ReverseDirection (Boolean)
bepaalt of de oriëntatie van de as wiskundig is of omgekeerd. (beschikbaar sinds OpenOffice.org 2.4)

Eigenschappen voor labels:

DisplayLabels (Boolean)
activeert het tekstlabel op de markeringen voor de interval
TextRotation (Long)
draaihoek van tekstlabels in 100-en van een graad
ArrangeOrder (enum)
de labels kunnen op elkaar gestapeld zijn, dus zij worden afwisselend op twee regels geplaatst (waarden overeenkomstig met com.sun.star.chart.ChartAxisArrangeOrderType)
TextBreak (Boolean)
staat regeleinden toe binnen de labels van de assen
TextCanOverlap (Boolean)
staat een overlapping toe van de labels van de assen
NumberFormat (Long)
getalopmaak die moet worden gebruikt voor de labels van de assen
LinkNumberFormatToSource (Boolean)
bepaalt of de getalopmaak wordt bepaald door het containerdocument, of vanuit de eigenschap NumberFormat. (sinds OpenOffice.org 2.3)

Eigenschappen voor markeringen van intervallen:

Marks (Const)
bepaalt de positie van de markering van de hoofdinterval (waarden overeenkomend met com.sun.star.chart.ChartAxisMarks)
HelpMarks (Const)
bepaalt de positie van de kleinere markeringen van de interval (waarden overeenkomend met com.sun.star.chart.ChartAxisMarks)

Alleen voor staaf-diagrammen:

Overlap (Long)
percentage dat de mate specificeert waarmee de staven van de verschillende sets van gegevens elkaar mogen overlappen (met 100% worden de staven weergegeven als volledig overlappend, met -100% is er een afstand van de breedte van één staaf tussen)
GapWidth (long)
percentage dat de afstand specificeert tussen de verschillende groepen staven van een diagram (met 100% is er een afstand die overeenkomt met de breedte van één staaf)

Rasters

Voor de primaire assen kunnen rasters en sub-rasters worden weergegeven, overeenkomend met de hoofd- en kleinere intervallen. Het object Diagram verschaft de volgende eigenschappen voor toegang tot de rasters:

HasXAxisGrid (Boolean)
activeert het hoofdraster voor de X-as
XMainGrid (Object)
object met gedetailleerde informatie over het hoofdraster voor de X-as (ondersteunt service com.sun.star.chart.ChartGrid)
HasXAxisHelpGrid (Boolean)
activeert sub-raster voor de X-as
XHelpGrid (Object)
object met gedetailleerde informatie over het sub-raster voor de X-as (ondersteunt service com.sun.star.chart.ChartGrid)

hetzelfde voor Y en Z:

HasYAxisGrid (Boolean)
activeert het hoofdraster voor de Y-as
YMainGrid (Object)
object met gedetailleerde informatie over het hoofdraster voor de Y-as (ondersteunt service com.sun.star.chart.ChartGrid)
HasYAxisHelpGrid (Boolean)
activeert sub-raster voor de Y-as
YHelpGrid (Object)
object met gedetailleerde informatie over het sub-raster voor de Y-as (ondersteunt service com.sun.star.chart.ChartGrid)
HasZAxisGrid (Boolean)
activeert het hoofdraster voor de Z-as
ZMainGrid (Object)
object met gedetailleerde informatie over het hoofdraster voor de Z-as (ondersteunt service com.sun.star.chart.ChartGrid)
HasZAxisHelpGrid (Boolean)
activeert sub-raster voor de Z-as
ZHelpGrid (Object)
object met gedetailleerde informatie over het sub-raster voor de Z-as (ondersteunt service com.sun.star.chart.ChartGrid)

Het object voor het raster is gebaseerd op de service com.sun.star.chart.ChartGrid, die op zijn beurt de lijn-eigenschappen ondersteunt van de ondersteunende service com.sun.star.drawing.LineStyle (bekijk Tekeningen en presentaties).

Titels voor assen

Voor alle assen kan een aanvullende titel worden weergegeven. Het object Diagram verschaft de volgende eigenschappen voor toegang tot de titel van de assen:

HasXAxisTitle (Boolean)
activeert de titel van de X-as
XAxisTitle (Object)
object met gedetailleerde informatie over de titel van de X-as (ondersteunt service com.sun.star.chart.ChartTitle)

hetzelfde voor Y en Z:

HasYAxisTitle (Boolean)
activeert de titel van de Y-as
YAxisTitle (Object)
object met gedetailleerde informatie over de titel van de Y-as (ondersteunt service com.sun.star.chart.ChartTitle)
HasZAxisTitle (Boolean)
activeert de titel van de Z-as
ZAxisTitle (Object)
object met gedetailleerde informatie over de titel van de Z-as (ondersteunt service com.sun.star.chart.ChartTitle)

en voor de secondaire assen (beschikbaar sinds OpenOffice.org 3.0):

HasSecondaryXAxisTitle (Boolean)
activeert de titel van de secundaire X-as.
SecondXAxisTitle (Object)
object met gedetailleerde informatie over de titel van de secundaire X-as (ondersteunt service com.sun.star.chart.ChartTitle)
HasSecondaryYAxisTitle (Boolean)
activeert de titel van de secundaire Y-as.
SecondYAxisTitle (Object)
object met gedetailleerde informatie over de titel van de secundaire X-as (ondersteunt service com.sun.star.chart.ChartTitle)

De objecten voor het opmaken van de titels van de assen zijn gebaseerd op de service com.sun.star.chart.ChartTitle, die ook wordt gebruikt voor de titels van het diagram.

Voorbeeld

Het volgende voorbeeld maakt een lijn-diagram. De kleur van de achterwand van het diagram is ingesteld op wit. Zowel de X als de Y-as hebben een grijs hulp-raster voor visuele oriëntatie. De minimum waarde van de Y-as is vast ingesteld op 0 en de maximum waarde is vast ingesteld op 100 zodat de uitvoering van het diagram wordt behouden, zelfs als de waarden worden veranderd. De X-as loopt in omgekeerde richting van rechts naar links. Een titel voor de X-as is toegevoegd. 

Dim Doc As Object
Dim Diagrammen As Object
Dim Diagram as Object
Dim Recht As New com.sun.star.awt.Rectangle
Dim CelBereik(0) As New com.sun.star.table.CellRangeAddress
 
Doc = ThisComponent
Diagrammen = Doc.Sheets(0).Charts
 
Recht.X = 8000
Recht.Y = 1000
Recht.Width = 10000
Recht.Height = 7000
CelBereik(0).Sheet = 0
CelBereik(0).StartColumn = 0 
CelBereik(0).StartRow = 0
CelBereik(0).EndColumn = 2
CelBereik(0).EndRow = 12
 
Diagrammen.addNewByName("MijnDiagram", Recht, CelBereik(), True, True)
Diagram = Diagrammen.getByName("MijnDiagram").embeddedObject
Diagram.Diagram = Diagram.createInstance("com.sun.star.chart.LineDiagram")
Diagram.Diagram.Wall.FillColor = RGB(255, 255, 255)
Diagram.Diagram.HasXAxisGrid = True
Diagram.Diagram.XMainGrid.LineColor = RGB(192, 192, 192)
Diagram.Diagram.HasYAxisGrid = True
Diagram.Diagram.YMainGrid.LineColor = RGB(192, 192, 192)
Diagram.Diagram.YAxis.Min = 0 
Diagram.Diagram.YAxis.Max = 100
 
Diagram.Diagram.XAxis.ReverseDirection = true 'heeft OpenOffice.org 2.4 of nieuwer nodig
Diagram.Diagram.HasXAxisTitle = true
Diagram.Diagram.XAxisTitle.String = "Voorbeeld omgekeerde X-as"

3D-diagrammen

De meeste diagrammen in Apache OpenOffice kunnen ook worden weergegeven met 3D-afbeelding. De volgende eigenschappen worden verschaft voor 3D-diagrammen voor het object Diagram:

De meest diagrammen kunnen ook worden weergegeven met 3D-afbeeldingen.

Dim3D (Boolean)
activeert weergave in 3D
Deep (Boolean)
de reeks zal achter elkaar worden geschikt in de richting van Z
RightAngledAxes (Boolean)
activeert een modus 3D-weergave waar X- en Y-assen een rechte hoek vormen binnen de projectie. (beschikbaar sinds OpenOffice.org 2.3)
D3DScenePerspective (Enum)
definieert of de 3D-objecten moeten worden getekend in projectie met perspectief of parallel.(waarden overeenkomend met com.sun.star.drawing.ProjectionMode)
Perspective (Long)
Perspectief van 3D-diagrammen ( [0,100] ) (beschikbaar sinds OpenOffice.org 2.4.1)
RotationHorizontal (Long)
Horizontale rotatie van 3D-diagrammen in graden ( [-180,180] ) (beschikbaar sinds OpenOffice.org 2.4.1)
RotationVertical (Long)
Verticale rotatie van 3D-diagrammen in graden ( [-180,180] ) (beschikbaar sinds OpenOffice.org 2.4.1)

Het volgende voorbeeld maakt een 3D-vlakdiagram. 

Dim Doc As Object
Dim Diagrammen As Object
Dim Diagram as Object
Dim Recht As New com.sun.star.awt.Rectangle
Dim CelBereik(0) As New com.sun.star.table.CellRangeAddress
 
Doc = ThisComponent
Diagrammen = Doc.Sheets(0).Charts
 
Recht.X = 8000
Recht.Y = 1000
Recht.Width = 10000
Recht.Height = 7000
CelBereik(0).Sheet = 0
CelBereik(0).StartColumn = 0 
CelBereik(0).StartRow = 0
CelBereik(0).EndColumn = 2
CelBereik(0).EndRow = 12
 
Diagrammen.addNewByName("MijnDiagram", Recht, CelBereik(), True, True)
Diagram = Diagrammen.getByName("MijnDiagram").embeddedObject
Diagram.Diagram = Diagram.createInstance("com.sun.star.chart.AreaDiagram")
Diagram.Diagram.Dim3D = true
Diagram.Diagram.Deep = true
Diagram.Diagram.RightAngledAxes = true 'heeft OpenOffice.org 2.3 of nieuwer nodig
Diagram.Diagram.D3DScenePerspective = com.sun.star.drawing.ProjectionMode.PERSPECTIVE
Diagram.Diagram.Perspective = 100 'heeft OpenOffice.org 2.4.1 of nieuwer nodig
Diagram.Diagram.RotationHorizontal = 60 'heeft OpenOffice.org 2.4.1 of nieuwer nodig
Diagram.Diagram.RotationVertical = 30 'heeft OpenOffice.org 2.4.1 of nieuwer nodig

Gestapelde diagrammen

Gestapelde diagrammen zijn diagrammen die worden gepresenteerd met verscheidene individuele waarden op elkaar om een totale waarde te produceren. Deze weergave toont niet alleen de individuele waarden, maar ook een overzicht van alle waarden.

In Apache OpenOffice kunnen verschillende typen diagram worden weergegeven in een gestapelde vorm. Al deze diagrammen ondersteunen de service com.sun.star.chart.StackableDiagram, welke op zijn beurt de volgende eigenschappen verschaft:

Stacked (Boolean)
activeert de modus voor gestapeld weergeven
Percent (Boolean)
in plaats van absolute waarden, geef het percentage van hun verdeling weer


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/Structure_of_Charts&oldid=250469"
Personal tools