Tulong sa LibreOffice 25.8
Ang Tsart nagbibigay ang serbisyo ng isang hanay ng mga katangian at pamamaraan upang mahawakan ang mga chart sa mga dokumento ng Calc. Sa serbisyong ito, posible na:
I-access ang mga bagay sa chart sa mga dokumento ng Calc at manipulahin ang mga katangian ng mga ito.
Gumawa at magpasok ng mga bagong chart sa isang dokumento ng Calc.
I-export ang mga chart bilang mga file ng imahe.
Maaaring may dalawang magkaibang pangalan ang mga chart:
An panloob na pangalan ibinigay ng LibreOffice sa sandaling malikha ang bagay sa tsart (karaniwan ay "Bagay 1", "Bagay 2" at iba pa).
A pangalan na tinukoy ng gumagamit , na maaaring tukuyin sa pamamagitan ng pag-right click sa chart at pagpili sa menu ng konteksto.
Ang Tsart Pangunahing ginagamit ng serbisyo ang pangalan na tinukoy ng gumagamit upang ma-access ang isang bagay na tsart. Kung hindi ito umiiral, kaysa sa panloob na pangalan ang ginagamit.
Bago gamitin ang Tsart serbisyo ang ScriptForge kailangang i-load o i-import ang library:
Ang Tsart ang serbisyo ay ginawa mula sa a Calc halimbawa ng serbisyo gamit ang Mga tsart o Lumikha ngChart pamamaraan.
Ang halimbawa sa ibaba ay lumilikha ng a Tsart instance ng serbisyo mula sa isang kasalukuyang tsart sa kasalukuyang dokumento ng Calc:
    GlobalScope.BasicLibraries.LoadLibrary("ScriptForge")
    Dim oDoc as Object, oChart as Object
    Set oDoc = CreateScriptService("Calc")
    Set oChart = oDoc.Charts("Sheet1", "Object 1")
  Ang sumusunod na halimbawa ay nagpapakita ng Tsart serbisyo sa pamamagitan ng paglikha ng bagong bagay sa tsart batay sa data na nilalaman sa hanay na "Sheet1.A1:C10".
    Dim oDoc as Object, oChart as Object
    Set oDoc = CreateScriptService("Calc")
    Set oChart = oDoc.CreateChart("My Chart", "Sheet1", "Sheet1.A1:C10")
  Basahin ang Lumikha ngChart paglalarawan ng pamamaraan upang matuto nang higit pa tungkol sa mga argumento nito.
Ang mga halimbawa sa itaas ay maaaring isulat sa Python tulad ng sumusunod:
    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")
  | Pangalan | Readonly | Type | Mga nilalaman | 
|---|---|---|---|
| ChartType | Hindi | String | Tinutukoy ang uri ng chart bilang isang string na maaaring maglagay ng isa sa mga sumusunod na value: "Pie", "Bar", "Donut", "Column", "Area", "Line", "XY", "Bubble", "Net ". | 
| Deep | Hindi | Boolean | kailan totoo ay nagpapahiwatig na ang tsart ay tatlong-dimensional at ang bawat serye ay nakaayos sa z-direksyon. kailan Mali ang mga serye ay isinaayos na isinasaalang-alang lamang ang dalawang dimensyon. | 
| Dim3D | Hindi | Boolean or String | Tinutukoy kung ang chart ay ipinapakita na may mga 3D na elemento. Kung ang value ay isang string, dapat itong alinman sa "Bar", "Cylinder", "Cone" o "Pyramid". Kung ang boolean totoo ang halaga ay tinukoy, pagkatapos ay ipinapakita ang tsart gamit ang mga 3D bar. | 
| Exploded | Hindi | Numeric | Tinutukoy kung gaano karaming mga segment ng pie ang na-offset mula sa chart center bilang isang porsyento ng radius. Naaangkop sa pie at donut chart lamang. | 
| Filled | Hindi | Boolean | kailan totoo , ay tumutukoy sa isang punong net chart. Naaangkop sa net chart lamang. | 
| Legend | Hindi | Boolean | Tinutukoy kung may alamat o wala ang tsart. | 
| Percent | Hindi | Boolean | kailan totoo , ang mga serye ng tsart ay nakasalansan at ang bawat kategorya ay nagsusuma ng hanggang 100%. Naaangkop sa Area, Bar, Bubble, Column at Net chart. | 
| Stacked | Hindi | Boolean | kailan totoo , ang mga serye ng tsart ay nakasalansan. Naaangkop sa Area, Bar, Bubble, Column at Net chart. | 
| Title | Hindi | String | Tinutukoy ang pangunahing pamagat ng tsart. | 
| XTitle | Hindi | String | Tinutukoy ang pamagat ng X axis. | 
| YTitle | Hindi | String | Tinutukoy ang pamagat ng Y axis. | 
| XChartObj | Mayroon | UNO Object | Ibinabalik ang bagay na kumakatawan sa tsart, na isang halimbawa ng SchChartObj klase. | 
| XDiagram | Mayroon | UNO Object | Ibinabalik ang com.sun.star.chart.XDiagram bagay na kumakatawan sa diagram ng tsart. | 
| XShape | Mayroon | UNO Object | Ibinabalik ang com.sun.star.drawing.XShape bagay na kumakatawan sa hugis ng tsart. | 
| XTableChart | Mayroon | UNO Object | Ibinabalik ang com.sun.star.table.XTableChart bagay na kumakatawan sa data na ipinapakita sa tsart. | 
Isaalang-alang ang sumusunod na data sa hanay na "A1:B6" ng isang sheet na pinangalanang "Ulat".
| A | B | |
|---|---|---|
| 1 | Sample A | Sample B | 
| 2 | 36 | 40 | 
| 3 | 39 | 43 | 
| 4 | 45 | 40 | 
| 5 | 52 | 48 | 
Ang mga halimbawa sa ibaba sa Basic at Python ay nagpapakita kung paano gumawa ng line chart mula sa data na ito na may mga alamat.
    oDoc = CreateScriptService("Calc")
    oChart = oDoc.CreateChart("Samples", "Report", "Report.A1:B6")
    oChart.ChartType = "Line"
    oChart.Legend = True
    oChart.Resize(1000, 1000, 25000, 15000)
  
    doc = CreateScriptService("Calc")
    chart = doc.CreateChart("Samples", "Report", "Report.A1:B6")
    chart.ChartType = "Line"
    chart.Legend = True
    chart.Resize(1000, 1000, 25000, 15000)
  Ang tsart ay hindi kailangang gawin sa parehong sheet kung saan matatagpuan ang data. Maaari itong malikha sa anumang umiiral na sheet sa kasalukuyang file sa pamamagitan ng pagtukoy ng pangalan ng sheet sa pangalawang argumento ng Lumikha ngChart paraan.
| Listahan ng Mga Paraan sa Serbisyo ng Tsart | |
|---|---|
Sine-save ang tsart bilang isang file ng imahe sa isang tinukoy na lokasyon. Nagbabalik totoo kung matagumpay na magawa ang file ng imahe.
chart.ExportToFile(filename: str, imagetype: str = "png", overwrite: bool = False): bool
filename : Tinutukoy ang landas at pangalan ng file kung saan ise-save ang larawan. Dapat itong sundin ang notasyong tinukoy sa SF_FileSystem.FileNaming .
imagetype : Ang pangalan ng uri ng imahe na gagawin. Ang mga sumusunod na halaga ay tinatanggap: "gif", "jpeg", "png" (default), "svg" at "tiff".
overwrite : Tinutukoy kung ang patutunguhang file ay maaaring ma-overwrite (Default = Mali ).
      oChart.ExportToFile("C:\Temp\myChart.svg", ImageType := "svg", Overwrite := True)
    
      chart.ExportToFile(r"C:\Temp\myChart.svg", imagetype="svg", overwrite=True)
    Binabago ang posisyon ng chart sa kasalukuyang sheet at binabago ang lapad at taas nito. Nagbabalik totoo kung matagumpay ang pagbabago ng laki.
chart.Resize([xpos: int], [ypos: int], [width: int], [height: int]): bool
xpos, ypos: Tukuyin ang bagong X at Y na posisyon ng tsart. Kung ang alinman sa mga halagang ito ay tinanggal o kung ang mga negatibong halaga ay ibinigay, ang mga kaukulang posisyon ay hindi nababago.
lapad: Tukuyin ang bagong lapad ng tsart. Kung ang argumento na ito ay tinanggal o kung ang isang negatibong halaga ay ibinigay, ang lapad ng tsart ay hindi nababago.
taas: Tukuyin ang bagong taas ng chart. Kung ang argumentong ito ay tinanggal o kung ang isang negatibong halaga ay ibinigay, ang taas ng tsart ay hindi nababago.
Ang lahat ng mga argumento ay ibinigay bilang mga halaga ng integer na tumutugma sa 1/100 ng isang milimetro.
      ' Binabago lamang ang posisyon ng X at Y
      oChart.Rezise(1000, 3000)
      ' Binabago lamang ang lapad at taas ng tsart
      oChart.Resize(, , 25000, 12500)
      ' Sinusuportahan ang mga argumento ng keyword
      oChart.Resize(Width := 25000, Height := 12500)
    
      chart.Rezise(1000, 3000)
      chart.Resize(-1, -1, 20000, 20000)
      chart.Resize(width=25000, height=12500)