SFDocuments.Chart-tjeneste

Tjenesten Chart gir et sett med egenskaper og metoder for Ä hÄndtere diagrammer i Calc-dokumenter. Med denne tjenesten er det mulig Ä:

Diagramnavn

Diagrammer kan ha to forskjellige navn:

note

Tjenesten Diagram bruker primÊrt det brukerdefinerte navnet for Ä fÄ tilgang til et Diagramobjekt. Hvis det ikke eksisterer, brukes det interne navnet.


TjenestepÄkallelse

FÞr du bruker Chart-tjenesten, mÄ ScriptForge-biblioteket lastes eller importeres:

note

‱ Grunnleggende makroer krever Ă„ laste ScriptForge-biblioteket ved hjelp av fĂžlgende setning:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

‱ Python-skript krever import fra scriptforge-modulen:
fra scriptforge import CreateScriptService


Diagram-tjenesten er instansiert fra en Calc-tjenesteforekomst, enten ved Ă„ bruke metodene Diagrammer eller CreateChart.

I Basic

Eksemplet nedenfor oppretter en Diagram tjenesteforekomst fra et eksisterende diagram i det gjeldende Calc-dokumentet:


    GlobalScope.BasicLibraries.LoadLibrary("ScriptForge")
    Dim oDoc as Object, oChart as Object
    Set oDoc = CreateScriptService("Calc")
    Set oChart = oDoc.Charts("Sheet1", "Object 1")
  

FÞlgende eksempel instansierer Diagram-tjenesten ved Ä lage et nytt diagramobjekt basert pÄ dataene i omrÄdet "Sheet1.A1:C10".


    Dim oDoc as Object, oChart as Object
    Set oDoc = CreateScriptService("Calc")
    Set oChart = oDoc.CreateChart("My Chart", "Sheet1", "Sheet1.A1:C10")
  
tip

Les metodebeskrivelsen CreateChart for Ă„ lĂŠre mer om argumentene.


I Python

Eksemplene ovenfor kan skrives i Python som fĂžlger:


    from scriptforge import CreateScriptService
    doc = CreateScriptService("Calc")
    chart = doc.Charts("Sheet1", "Object 1")
  

    doc = CreateScriptService("Calc")
    chart = doc.CreateChart("My Chart", "Sheet1", "Sheet1.A1:C10")
  

Egenskaper

Navn

Skrivebeskyttet

Type

Beskrivelse

ChartType

Nei

String

Spesifiserer diagramtypen som en streng som kan anta en av fÞlgende verdier: "Kake", "Stolpe", "Smultring", "Kolonne", "OmrÄde", "Linje", "XY", "Boble", "Netto ".

Deep

Nei

Boolean

NÄr Sann indikerer at diagrammet er tredimensjonalt og hver serie er ordnet i z-retningen.

NÄr Usann-serier er ordnet med bare to dimensjoner.

Dim3D

Nei

Boolean or String

Angir om diagrammet vises med 3D-elementer. Hvis verdien er en streng, mÄ den enten vÊre «Stolpe», «Sylinder», «Kon» eller «Pyramide».

Hvis den boolske verdien Sann er spesifisert, vises diagrammet ved hjelp av 3D-stolper.

Exploded

Nei

Numeric

Angir hvor mye kakesegmenter som er forskjĂžvet fra diagramsenteret som en prosentandel av radiusen. Gjelder kun for kake- og smultringdiagrammer.

Filled

Nei

Boolean

NÄr Sann, spesifiserer et fylt nettodiagram. Gjelder kun nettdiagrammer.

Legend

Nei

Boolean

Angir om diagrammet har en forklaring eller ikke.

Percent

Nei

Boolean

NÄr True, er diagramserier stablet og hver kategori summerer opp til 100 %. Gjelder for omrÄde-, sÞyle-, boble-, kolonne- og nettdiagrammer.

Stacked

Nei

Boolean

NÄr sann, er diagramserier stablet. Gjelder for omrÄde-, sÞyle-, boble-, kolonne- og nettdiagrammer.

Title

Nei

String

Angir hovedtittelen til diagrammet.

XTitle

Nei

String

Angir tittelen pÄ X-aksen.

YTitle

Nei

String

Angir tittelen pÄ Y-aksen.

XChartObj

Ja

UNO Objekt

Returnerer objektet som representerer diagrammet, som er en forekomst av ScChartObj klasse.

XDiagram

Ja

UNO Objekt

Returnerer com.sun.star.chart.XDiagram objekt som representerer diagrammet til diagrammet.

XShape

Ja

UNO Objekt

Returnerer com.sun.star.drawing.XShape objekt som representerer formen pÄ diagrammet.

XTableChart

Ja

UNO Objekt

Returnerer com.sun.star.table.XTableChart-objektet som representerer dataene som vises i diagrammet.


Opprette et diagram

Vurder fÞlgende data i omrÄdet "A1:B6" i et ark kalt "Rapport".

A

B

1

Sample A

Sample B

2

36

40

3

39

43

4

45

40

5

52

48


Eksemplene nedenfor i Basic og Python viser hvordan du lager et linjediagram fra disse dataene med forklaringer.

I Basic

    oDoc = CreateScriptService("Calc")
    oChart = oDoc.CreateChart("Samples", "Report", "Report.A1:B6")
    oChart.ChartType = "Line"
    oChart.Legend = True
    oChart.Resize(1000, 1000, 25000, 15000)
  
I Python

    doc = CreateScriptService("Calc")
    chart = doc.CreateChart("Samples", "Report", "Report.A1:B6")
    chart.ChartType = "Line"
    chart.Legend = True
    chart.Resize(1000, 1000, 25000, 15000)
  
tip

Diagrammet trenger ikke Ă„ opprettes i samme ark der dataene er plassert. Det kan opprettes i et hvilket som helst eksisterende ark i gjeldende fil ved Ă„ spesifisere arknavnet i det andre argumentet til CreateChart-metoden.


Metoder

Liste over metoder i diagramtjenesten

ExportToFile

Resize


ExportToFile

Lagrer diagrammet som en bildefil pÄ et spesifisert sted. Returnerer Sann hvis bildefilen kunne opprettes.

Syntaks:

chart.ExportToFile(filename: str, imagetype: str = "png", overwrite: bool = False): bool

Parametre:

filnavn: Identifiserer stien og filnavnet der bildet skal lagres. Den mÄ fÞlge notasjonen som er definert i SF_FileSystem.FileNaming.

imagetype: Navnet pÄ bildetypen som skal opprettes. FÞlgende verdier godtas: "gif", "jpeg", "png" (standard), "svg" og "tiff".

overskriv: Angir om mÄlfilen kan overskrives (Standard = Usann).

Eksempel:

I Basic

      oChart.ExportToFile("C:\Temp\myChart.svg", ImageType := "svg", Overwrite := True)
    
I Python

      chart.ExportToFile(r"C:\Temp\myChart.svg", imagetype="svg", overwrite=True)
    

Resize

Endrer posisjonen til diagrammet i gjeldende ark og endrer bredden og hĂžyden. Returnerer Sann hvis endring av stĂžrrelse var vellykket.

Syntaks:

chart.Resize([xpos: int], [ypos: int], [width: int], [height: int]): bool

Parametre:

xpos, ypos: Spesifiser de nye X- og Y-posisjonene til diagrammet. Hvis noen av disse verdiene utelates eller hvis negative verdier er oppgitt, forblir de tilsvarende posisjonene uendret.

bredde: Spesifiser den nye bredden pÄ diagrammet. Hvis dette argumentet utelates eller hvis en negativ verdi angis, forblir diagrambredden uendret.

hÞyde: Angi den nye hÞyden pÄ diagrammet. Hvis dette argumentet utelates eller hvis en negativ verdi er oppgitt, forblir diagramhÞyden uendret.

note

Alle argumenter er gitt som heltallsverdier som tilsvarer 1/100 av en millimeter.


Eksempel:

I Basic

      ' Endrer bare X- og Y-posisjon
      oChart.Rezise(1000, 3000)
      ' Endrer kun diagrambredden og -hĂžyden
      oChart.Resize(, , 25000, 12500)
      ' SĂžkeordargumenter er stĂžttet
      oChart.Resize(Width := 25000, Height := 12500)
    
I Python

      chart.Rezise(1000, 3000)
      chart.Resize(-1, -1, 20000, 20000)
      chart.Resize(width=25000, height=12500)
    
warning

Alle ScriptForge Grunnleggende rutiner eller identifikatorer som er prefikset med et understrekingstegn "_" er reservert for intern bruk. De er ikke ment Ă„ brukes i grunnleggende makroer eller Python-skript.