Mga SFDocuments . Tsart serbisyo

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.

Mga pangalan ng tsart

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 Pangalan 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.

Panawagan sa serbisyo

Bago gamitin ang Tsart serbisyo ang ScriptForge kailangang i-load o i-import ang library:

• Ang mga pangunahing macro ay kailangang mag-load ScriptForge aklatan gamit ang sumusunod na pahayag:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• Ang mga script ng Python ay nangangailangan ng pag-import mula sa scriptforge module:
mula sa scriptforge import CreateScriptService

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")
  

Mga Katangian

Paggawa ng tsart

Isaalang-alang ang sumusunod na data sa hanay na "A1:B6" ng isang sheet na pinangalanang "Ulat".

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.

Pamamaraan

ExportToFile

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)
    

Resize

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)
    

Lahat ScriptForge Ang mga pangunahing gawain o identifier na may prefix na may underscore na character na "_" ay nakalaan para sa panloob na paggamit. Ang mga ito ay hindi nilalayong gamitin sa Basic macros o Python script.