SFDocuments.Calc zerbitzua

SFDocuments liburutegi partekatuak LibreOffice dokumentuak kudeatu eta maneiatzea errazten duten metodo eta propietateak eskaintzen ditu.

SFDocuments.Calc zerbitzua SFDocuments.Document zerbitzuaren azpiklase bat da. Document zerbitzurako definitutako metodo eta propietate guztiak Calc zerbitzu-instantziaren bidez ere atzitu daitezke.

Calc zerbitzua honetarako da:

• Calc dokumentu bateko orriak kudeatzeko (kopiatu, txertatu, lekuz aldatu, etab.)

• Basic datu-egituren eta Calc barrutien arteko datuak trukatzeko

• Datu kantitate masiboak kopiatzeko eta inportatzeko

Laguntza-orri honek Calc dokumentuei soilik aplikatu dakizkiekeen metodoak eta propietateak deskribatzen ditu.

Zerbitzuari deitzea

Calc zerbitzua erabili baino lehen, ScriptForge liburutegia kargatu edo inportatu behar da:

• Basic makroak erabiltzkeo, ScriptForge liburutegia kargatu behar da honako instrukzioa erabiliz:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• Python scriptak erabiltzeko, berriz, scriptforge modulu baten inportazioa behar dute:
from scriptforge import CreateScriptService

Calc zerbitzua eta UI ScriptForge liburutegiaren zerbitzua estu lotuta daude. Behean ageri dira Calc zerbitzua deitzeko moduak adierazten dituzten zenbait adibide.

Beheko kode-zatiak uneko Calc dokumentu aktiboari dagokion Calc zerbitzu-instantzia bat sortzen du.

    Set oDoc = CreateScriptService("Calc")
  

Calc zerbitzuaren beste instantzia bat sortzeko beste modu bat UI zerbitzua erabiltzea da. Hurrengo adibidean, Calc dokumentu berria sortzen da eta oDoc elementua Calc zerbitzuaren instantzia bat da:

    Dim ui As Object, oDoc As Object
    Set ui = CreateScriptService("UI")
    Set oDoc = ui.CreateDocument("Calc")
  

Edo UI zerbitzuaren OpenDocument metodoa erabilita:

    Set oDoc = ui.OpenDocument("C:\Documents\MyFile.ods")
  

Posible da, baita ere, CreateScriptService metodorako leiho-izen bat zehaztea Calc zerbitzuaren instantzia bat sortzeko:

    Dim oDoc As Object
    Set oDoc = CreateScriptService("SFDocuments.Calc", "MyFile.ods")
  

Goiko adibidean, "MyFile.ods" dokumentu-leiho ireki baten izena da. Argumentu hori ematen ez bada, leiho aktiboa erabiliko da.

Calc zerbitzuari deitzeko beste modu bat ThisComponent-ek erreferentziatutako dokumentua erabiltzea da. Aukera hori oso erabilgarria da makro bat Basic IDEtik exekutatzen ari denean.

    Dim oDoc As Object
    Set oDoc = CreateScriptService("Calc", ThisComponent)
  

Gomendagarria da baliaboideak askatzea erabileraren ondoren:

    Set oDoc = oDoc.Dispose()
  

Hala ere, dokumentua CloseDocument metodoa erabilita itxi bada, ez da beharrezkoa baliabideak askatzea goian deskribatutako komandoaren bidez.

    myDoc = CreateScriptService("Calc")
  

    ui = CreateScriptService("UI")
    myDoc = ui.CreateDocument("Calc")
  

    myDoc = ui.OpenDocument(r"C:\Documents\MyFile.ods")
  

    myDoc = CreateScriptService("SFDocuments.Calc", "MyFile.ods")
    myDoc.Dispose()
  

    bas = CreateScriptService("Basic")
    myDoc = CreateScriptService("Calc", bas.ThisComponent)
  

"SFDocuments." aurreizkia erabiltzea aukerakoa da zerbitzuari deitzen zaionean.

Definizioak

Metodo askok "Orria" edo "Barrutia" behar dute argumentu gisa. Gelaxka bakunak Range elementuaren kasu berezitzat hartzen dira.

Biak ala biak kate gisa edo erreferentzia (=objektu) gisa adierazi daitezke, egoeraren arabera:

• Calc instantzia espezifiko batean, orriak eta barrutiak kate gisa ematen dira, adibidez "Orria1" eta "D2:F6".

• Horrez gain, .Sheet eta .Range propietateek Calc zerbitzuaren beste instantzia batetik deitutako metodo baten argumentu gisa erabili daitekeen erreferentzia bat itzultzen dute.

Beheko adibideak (soilik irakurtzeko moduan eta ezkutuan irekitako) A dokumentuko datuak B dokumentura kopiatzen ditu.

    Dim oDocA As Object, oDocB As Object
    Set oDocA = ui.OpenDocument("C:\Documents\FileA.ods", Hidden := True, ReadOnly := True)
    Set oDocB = ui.OpenDocument("C:\Documents\FileB.ods")
    oDocB.CopyToRange(oDocA.Range("SheetX.D4:F8"), "D2:F6") 'CopyToRange(source, target)
  

    docA = ui.OpenDocument(r"C:\Documents\FileA.ods", hidden = True, readonly = True)
    docB = ui.OpenDocument(r"C:\Documents\FileB.ods")
    docB.CopyToRange(docA.Range("SheetX.D4:F8"), "D2:F6")
  

SheetName

Sartu orri-izena .Sheet propietateak ekoiztutako string edo object gisa.

"~" (tildea) lasterbideak uneko orria ordezkatzen du.

RangeName

Uneko instantziako orri batean kokatutako elkarren ondoko gelaxken multzo bat adierazten duen kate bat edo .Range propietateak ekoiztutako object bat.

"~" (tileta) lasterbideak ordezkatzen du uneko hautapena edo hautatutako lehen barrutia, barruti anitz hautatuta badaude.

"*" lasterbideak erabilitako gelaxka guztiak ordezkatzen ditu.

Orri-izena aukerakoa da barruti bat definitzean. Ez bada izen-orririk ematen, orri aktiboa erabiliko da. Inguruko komatxo bakunak eta $ ikurrak onartzen dira, baina ez ikusiarena egiten zaie.

OrriIzena kate gisa zehaztean, orri-izena inguratzen duten komatxo bakunen erabilera derrigorrezkoa da izenak zuriuneak (" ") edo puntuak (".") baditu.

Beheko adibideetan ikus daiteke zein kasutan erabili behar diren derrigorrez komatxo bakunak:

      ' Komatxo bakunen erabilera aukerakoa da
      oDoc.clearAll("SheetA.A1:B10")
      oDoc.clearAll("'SheetA'.A1:B10")
      ' Komatxo bakunen erabilera derrigorrezkoa da
      oDoc.clearAll("'Sheet.A'.A1:B10")
    

CurrentSelection propietatean salbu, Calc zerbitzuak gelaxken barruti bakunak soilik hartzen ditu kontuan.

Propietateak

Edozein dokumentutarako orokorrak diren propietateak inplizituki Calc dokumentuetan ere aplikatu daitezke. Informazio gehiagorako, ikus Document zerbitzuaren laguntza-orria.

Calc dokumentuetan espezifikoki erabilgarri dauden propietateak honakoak dira:

Begiratu LibreOffice APIaren dokumentazioaren webgunea XCellRange, XSheetCellCursor eta XSpreadsheet UNO objektuei buruz gehiago ikasteko.

Metodoak

A1Style

Barruti-helbide bat itzultzen du orri-koordenatuetan oinarritutako kate gisa, alegia, errenkaden eta zutabeen zenbaki gisa.

Koordenatu-bikote bat soilik ematen bada, gelaxka bakar baten helbidea itzuliko da. Argumentu gehigarriak erabilita, barruti laukizuzen baten beheko eskuineko gelaxka zehaztu daiteke.

svc.A1Style(row1: int, column1: int, row2: int = 0; column2: int = 0; sheetname: str = "~"): str

row1, column1: Zehaztu kontuan hartuko den barrutiaren goiko ezkerreko gelaxkaren errenkadaren eta zutabearen zenbakiak. Errenkaden eta zutabeen zenbakiak 1ean hasten dira.

row2, column2: Zehaztu kontuan hartuko den barrutiaren beheko eskuineko gelaxkaren errenkadaren eta zutabearen zenbakiak. Argumentu horiek ez badira ematen, edo balioak row1 eta column1 baino txikiagoak badira, row1 eta column1 aldagaiek ordezkatzen duten gelaxka bakarreko barrutiaren helbidea itzuliko da.

sheetname: Itzulitako barruti-helbideari erantsiko zaion orriaren izena. Orriak lehendik existitu behar du. Balio lehenetsia "~" da, uneko orri aktiboa alegia.

Basic eta Python lengoaietako beheko adibideetan, kontuan izan "Sheet1" uneko orri aktiboa dela.

    Set oDoc = CreateScriptService("Calc")
    addr1 = oDoc.A1Style(1, 1) ' '$Sheet1'.$A$1
    addr2 = oDoc.A1Style(2, 2, 3, 6) ' '$Sheet1'.$B$2:$F$3
    addr3 = oDoc.A1Style(2, 2, 0, 6) ' '$Sheet1'.$B$2
    addr4 = oDoc.A1Style(3, 4, 3, 8, "Sheet2") ' '$Sheet2'.$D$3:$H$3
    addr5 = oDoc.A1Style(5, 1, SheetName := "Sheet3") ' '$Sheet3'.$A$5
  

    doc = CreateScriptService("Calc")
    addr1 = doc.A1Style(1, 1) # '$Sheet1'.$A$1
    addr2 = doc.A1Style(2, 2, 3, 6) # '$Sheet1'.$B$2:$F$3
    addr3 = doc.A1Style(2, 2, 0, 6) # '$Sheet1'.$B$2
    addr4 = doc.A1Style(3, 4, 3, 8, "Sheet2") # '$Sheet2'.$D$3:$H$3
    addr5 = doc.A1Style(5, 1, sheetname="Sheet3") # '$Sheet3'.$A$5
  

A1Style metodoa argumentu bat behar duten Calc zerbitzuko propietate eta metodoetako edozeinekin konbinatu daiteke, adibidez GetValue, GetFormula edo ClearAll metodoekin.

Activate

sheetname argumentua ematen bada, emandako orria aktibatuko da eta uneko orri hautatu bihurtuko da. Argumentu hori ez badago, dokumentu-leihoa aktibatuko da.

svc.Activate(sheetname: str = ""): bool

sheetname: Dokumentuan aktibatuko den orriaren izena. Balio lehenetsia kate hutsa da, horrek esan nahi du dokumentu-leihoa orri aktiboa aldatu gabe aktibatuko dela.

Beheko adibideak "Sheet4" izeneko orria aktibatzen du uneko dokumentu aktiboan.

    Dim ui as Variant, oDoc as Object
    Set ui = CreateScriptService("UI")
    Set oDoc = ui.GetDocument(ui.ActiveWindow)
    oDoc.Activate("Sheet4")
  

    ui = CreateScriptService("UI")
    myDoc = ui.GetDocument(ui.ActiveWindow)
    myDoc.Activate("Sheet4")
  

Orri bat aktibatzea zentzuzkoa izateko, Calc dokumentu batean egin behar da. Calc dokumentu bat eskura duzula ziurtatzeko, erabili dokumentu-objektuaren isCalc propietatea. Horrek True (egia) itzuliko du Calc dokumentu bat bada eta False (faltsua) ez bada.

Charts

Emandako orri bateko edo Chart zerbitzu-instantzia bateko diagrama-objektu guztien izenak dituen zerrenda bat itzultzen du.

• sheetname soilik zehazten bada, diagrama guztien izenak dituen zeron oinarritutako kate-matrize bat itzuliko da.

• chartname bat ematen bada, nahi den diagramari dagokion objektu bakar bat itzuliko da. Zehaztutako diagramak existitu behar du.

svc.Charts(sheetname: str, chartname: str = ""): obj

sheetname: Diagrama-zerrendaren jatorria den orria edo zehaztutako diagrama dagoen orria.

chartname: Itzuliko den diagrama-objekturako erabiltzaileak definitu duen izena. Diagramak ez badu erabiltzaileak definitutako izenik, barneko objektu-izena erabili daiteke. Argumentu hau ez badago, zehaztutako orriko diagrama-izenen zerrenda itzuliko da.

Erabili Nabigatzailea alboko barrako OLE objektuak kategoria diagramei esleitu zaizkien izenak egiaztatzeko.

Beheko adibidean, "Sheet1" orrian dauden diagrama-objektuen kopurua erakusten du.

    Dim arrNames as Object
    arrNames = oDoc.Charts("Sheet1")
    MsgBox "There are " & UBound(arrNames) + 1 & " charts in Sheet1"
  

Hurrengo adibidean, "Sheet1" orriko "MyChart" diagrama atzitzen da eta bere mota inprimatzen da.

    Dim oChart as Object
    oChart = oDoc.Charts("Sheet1", "MyChart")
    MsgBox oChart.ChartType
  

    bas = CreateScriptService("Basic")
    chart_names = doc.Charts("Sheet1")
    bas.MsgBox(f"There are {len(chart_names)} charts in Sheet1")
  

    chart = doc.Charts("Sheet1", "MyChart")
    bas.MsgBox(chart.ChartType)
  

ClearAll

Emandako barrutiaren eduki eta formatu guztiak garbitzen ditu.

Iragazki-formula bat zehaztu daiteke zein gelaxkak garbituko diren zehazteko.

svc.ClearAll(range: str, opt filterformula: str, opt filterscope: str)

range: Garbituko den barrutia, kate gisa.

filterformula: Emandako barrutiari aplikatuko zaion Calc formula, garbiketa zein gelaxketan gertatuko diren zehazteko. Zehaztutako formulak True edo False itzuli behar du. Argumentu hau zehazten ez bada, barrutiko gelaxka guztiak garbituko dira.

filterscope: filterformula emandako barrutira nola hedatzen den zehazten du. Argumentu hau derrigorrezkoa da filterformula zehazten bada. Honako balioak onartzen dira:

• "CELL": filterformula argumentuan zehaztutako formula behin hedatzen da range barrutiko gelaxka bakoitzeko.

• "ROW": filterformula argumentuan zehaztutako formula behin hedatzen da range barrutiko errenkada bakoitzeko.

• "COLUMN": filterformula argumentuan zehaztutako formula behin hedatzen da range barrutiko zutabe bakoitzeko.

    ' OrriaX.A1:J10 barrutiko gelaxka guztiak garbitzen ditu
    oDoc.ClearAll("OrriaX.A1:J10")
    ' OrriaX.A1:J10 barrutian, 100 baino balio handiagoa duten gelaxka guztiak garbitzen ditu
    oDoc.ClearAll("OrriaX.A1:J10", "=OrriaX.A1>100", "CELL")
    ' OrriaX.A1:J10 barrutian, batuketan 500 baino balio handiagoa ematen duten errenkadak garbitzen ditu
    oDoc.ClearAll("OrriaX.A1:J10", "=SUM(OrriaX.A1:J1)>100", "ROW")
    ' OrriaX.A1:J10 barrutian, batuketan 500 baino balio handiagoa ematen duten zutabeak garbitzen ditu
    oDoc.ClearAll("OrriaX.A1:J10", "=SUM(OrriaX.A1:A10)>100", "COLUMN")
  

    myDoc.ClearAll("OrriaX.A1:F10")
    myDoc.ClearAll("OrriaX.A1:J10", "=OrriaX.A1>100", "CELL")
    myDoc.ClearAll("OrriaX.A1:J10", "=SUM(OrriaX.A1:J1)>100", "ROW")
    myDoc.ClearAll("OrriaX.A1:J10", "=SUM(OrriaX.A1:A10)>100", "COLUMN")
  

ClearFormats

Emandako barrutiaren formatuak eta estiloak garbitzen ditu.

Iragazki-formula bat zehaztu daiteke zein gelaxkak garbituko diren adierazteko.

svc.ClearFormats(range: str, opt filterformula: str, opt filterscope: str)

range: Formatuak eta estiloak garbituko zaizkion barrutia, kate gisa.

      oDoc.ClearFormats("SheetX.*")
  

    myDoc.ClearFormats("SheetX.*")
  

Refer to the ClearAll method documentation for examples on how to use the arguments filterformula and filterscope.

ClearValues

Emandako barrutiaren balioak eta formulak garbitzen ditu.

Iragazki-formula bat zehaztu daiteke zein gelaxkak garbituko diren adierazteko.

svc.ClearValues(range: str, opt filterformula: str, opt filterscope: str)

range: Balioak eta formulak garbituko zaizkion barrutia, kate gisa.

      oDoc.ClearValues("SheetX.A1:F10")
  

    myDoc.ClearValues("SheetX.A1:F10")
  

Refer to the ClearAll method documentation for examples on how to use the arguments filterformula and filterscope.

CompactLeft

Calc formula gisa adierazitako iragazki batekin bat egiten duen barruti jakin bateko zutabeak ezabatzen ditu. Iragazkia zutabe bakoitzari aplikatzen zaio, hura ezabatuko den ala ez erabakitzeko.

Ezabatutako zutabea zehaztutako barrutiaren altueragatik mugatua egon daiteke edo orri osoaren altuerakoa izan daiteke. Azken kasu horretan, zutabe osoak ezabatuko dira.

Metodo honek barruti trinkotuko barruti-helbidea duen kate bat itzultzen du. Zutabe guztiak ezabatzen badira, hutsik dagoen kate bat itzuliko da.

Gelaxken barruti bat hautatzen bada, metodo honi deitzen bazaio hautapenean ez du eraginik izango.

svc.CompactLeft(range: str, wholecolumn: bool = False, opt filterformula: str): str

range: Zutabeak zein barrutitan ezabatuko diren, kate gisa.

wholecolumn: Aukera honetan True (egia) ezartzen bada, zutabe osoa ezabatuko da orritik. Balio lehenetsia False (faltsua) da, alegia, ezabatutako zutabeak zehaztutako range barrutiaren muga izango du.

filterformula: Zutabe bakoitzari aplikatuko zaion iragazkia hura ezabatu behar den ala ez zehazteko. Iragazkia lehen zutabeari aplikatu behar zaion Calc formula gisa adierazten da. Formulak True (egia) itzultzen badu zutabe batentzat, zutabe hori ezabatu egingo da. Iragazki lehenetsiak hutsik dauden zutabe guztiak ezabatzen ditu.

Adibidez, demagun A1:J200 dagoela hautatuta (altuera = 200). Formula lehenetsia honakoa da: =(COUNTBLANK(A1:A200)=200). Horrek esan nahi du lehen zutabean (A zutabea) 200 gelaxka hutsik badaude, zutabea ezabatu egingo dela. Kontuan izan formula lehen zutabearekiko soilik adierazten dela. Barnean, CompactLeft metodoak formula gainerako zutabeei aplikatuko die.

filterformula argumentuan erabilitako Calc funtzioak ingelesezko izenaren bidez adierazi behar dira. Begiratu Calc funtzioen zerrenda gunea Calc funtzioak ingelesez nola diren jakiteko.

    ' Ezabatu Orria1 orrian dagoen G1:L10 barrutiko zutabe hutsak
    barrutiberria = oDoc.CompactLeft("Orria1.G1:L10")
    ' Beheko adibidea antzekoa da, baina zutabe osoa ezabatzen da orritik
    barrutiberria = oDoc.CompactLeft("Orria1.G1:L10", WholeColumn := True)
    ' Lehen errenkada "X" batez markatuta duten zutabe guztiak ezabatzen ditu
    barrutiberria = oDoc.CompactLeft("Orria1.G1:L10", FilterFormula := "=(G1=""X"")")
    ' Zutabeko balio guztien batuketa bakoitia bada, zutabea ezabatzen du
    barrutiberria = oDoc.CompactLeft("Orria1.G1:L10", FilterFormula := "=(MOD(SUM(G1:G10);2)=1)")
  

    barrutiberria = myDoc.CompactLeft("Orria1.G1:L10")
    barrutiberria = myDoc.CompactLeft("Orria1.G1:L10", wholecolumn = True)
    barrutiberria = myDoc.CompactLeft("Orria1.G1:L10", filterformula = '=(G1="X")')
    barrutiberria = myDoc.CompactLeft("Orria1.G1:L10", filterformula = '=(MOD(SUM(G1:G10);2)=1)')
  

CompactUp

Calc formula gisa adierazi den iragazki batekin bat egiten duten barruti jakin bateko errenkadak ezabatzen ditu. Iragazkia errenkada bakoitzari aplikatuko zaio, ezabatuko den ala ez erabakitzeko.

Ezabatutako errenkadak zehaztutako barrutiaren zabalerara mugatu daitezke, edo orri osoaren zabalerara hedatu daitezke. Azken kasu horretan, errenkada osoak ezabatuko dira.

Metodo honek barruti trinkoko barruti-helbideak dituen kate bat itzuliko du. Errenkadak ezabatzen badira, hutsik dagoen kate bat itzuliko da.

Gelaxken barruti bat hautatu bada, metodo honi deitzeak ez du eraginik izango hautapenean.

svc.CompactUp(range: str, wholerow: bool = False, opt filterformula: str): str

range: Errenkadak ezabatuko zaizkion barrutia, kate gisa.

wholerow: Aukera honetan True ezarrita badago, errenkada osoa ezabatuko da orritik. Balio lehenetsia False da, alegia, ezabatutako errenkadak zehaztutako range barrutiaren muga izango du.

filterformula: Errenkada bakoitzari aplikatuko zaion iragazkia, hura ezabatu behar den ala ez zehazteko. Iragazkia Calc formula gisa adierazten da eta lehen errenkadan aplikatu behar da. Formulak True itzultzen badu errenkada baterako, errenkada hori ezabatu egingo da. Iragazki lehenetsiak hutsik dauden errenkada guztiak ezabatzen ditu.

Adibidez, demagun A1:J200 hautatu dela (zabalera = 10). Formula lehenetsia =(COUNTBLANK(A1:J1)=10) izango da. Horrek esan nahi du lehen errenkadan (1. errenkada) 10 gelaxkak hutsik badaude, errenkada ezabatu egingo dela. Kontuan izan formula lehen errenkadarekiko soilik adierazten dela. Barnean, CompactUp metodoak formula hori gainerako errenkadetara hedatuko du.

filterformula argumentuan zehaztutako formulan erabiltzen diren Calc funtzioak ingelesezko izenaren bidez adierazi behar dira. Begiratu Calc funtzioen zerrenda gunea Calc funtzioak ingelesez nola diren jakiteko.

    ' Ezabatu Orria1 orriko G1:L10 barrutian hutsik dauden errenkadak
    barrutiberria = oDoc.CompactUp("Orria1.G1:L10")
    ' Beheko adibidea antzekoa da, baina errenkada osoa ezabatuko da orritik
    barrutiberria = oDoc.CompactUp("Orria1.G1:L10", WholeRow := True)
    ' Lehen zutabea "X" bidez markatuta duten errenkada guztiak ezabatzen ditu
    barrutiberria = oDoc.CompactUp("Orria1.G1:L10", FilterFormula := "=(G1=""X"")")
    ' Errenkada ezabatzen du errenkadako balio guztien batuketa bakoitia bada
    barrutiberria = oDoc.CompactUp("Orria1.G1:L10", FilterFormula := "=(MOD(SUM(G1:L1);2)=1)")
  

    barrutiberria = myDoc.CompactUp("Orria1.G1:L10")
    barrutiberria = myDoc.CompactUp("Orria1.G1:L10", wholerow = True)
    barrutiberria = myDoc.CompactUp("Orria1.G1:L10", filterformula = '=(G1="X")')
    barrutiberria = myDoc.CompactUp("Orria1.G1:L10", filterformula = '=(MOD(SUM(G1:L1);2)=1)')
  

CopySheet

Zehaztutako orria lehendik dagoen orri baten aurrean edo orri-zerrendaren amaieran kopiatzen du. Kopiatuko den orriak barruan edozein Calc dokumentu ireki eduki behar du. True (egia) itzultzen du ongi egiten bada.

svc.CopySheet(sheetname: any, newname: str, [beforesheet: any]): bool

sheetname: Kate gisa kopiatuko den edo objektu gisa haren erreferentzia egingo den orriaren izena.

newname: Txertatuko den orriaren izena. Izenak dokumentuan erabili gabea izan behar du.

beforesheet: Orri baten izena (katea) edo indizea (zenbakizkoa, 1 zenbakitik hasita). Kopiatutako orria orri honen aurretik txertatuko da. Argumentu hau aukerakoa da eta portaera lehenetsia kopiatutako orria azken posizioan gehitzea da.

Hurrengo adibidez "SheetX" orriaren kopia bat egiten du eta uneko dokumentuaren azken orri gisa kokatzen du. Kopiatutako orriaren izena "SheetY" da.

    Dim oDoc as Object
    'Leiho aktiboaren dokumentu-objektua eskuratzen du
    Set oDoc = CreateScriptService("Calc")
    oDoc.CopySheet("SheetX", "SheetY")
  

Beheko adibideak "SheetX" kopiatzen du "FileA.ods" fitxategitik eta "FileB.ods" fitxategiaren azken posizioan kopiatzen du "SheetY" izenarekin:

      Dim oDocA As Object : Set oDocA = ui.OpenDocument("C:\Documents\FileA.ods", Hidden := True, ReadOnly := True)
      Dim oDocB As Object : Set oDocB = ui.OpenDocument("C:\Documents\FileB.ods")
      oDocB.CopySheet(oDocA.Sheet("SheetX"), "SheetY")
  

    myDoc.CopySheet("SheetX", "SheetY")
  

    docA = ui.OpenDocument(r"C:\Documents\FileA.ods", hidden = True, readonly = True)
    docB = ui.OpenDocument(r"C:\Documents\FileB.ods")
    docB.CopySheet(docA.Sheet("SheetX"), "SheetY")
  

Dokumentu irekien arteko orriak kopiatzeko, erabili CopySheet. Orriak Itxita dauden dokumentuen arten kopiatzeko, erabili CopySheetFromFile.

CopySheetFromFile

Itxitako Calc dokumentu bateko orri jakin bat kopiatzen du eta Document objektu batek erreferentzia egiten dion fitxategiak duen orri baten aurretik edo orri-zerrendaren amaieran itsasten du.

Fitxategia existitzen ez bada, errore bat gertatuko da. Fitxategia ez bada baliozko Calc fitxategia, orri zuria txertatuko da. Iturburuko orria existitzen ez bada sarrerako fitxategian, errore-mezu bat txertatuko da itsatsi berri den orriaren goiko aldean.

svc.CopySheetFromFile(filename: str, sheetname: str, newname: str, [beforesheet: any]): bool

filename: Irekiko den fitxategia identifikatzen du. SF_FileSystem.FileNaming notazioa jarraitu behar du. Fitxategiak ez du pasahitzarekin babestuta egon behar.

OrriIzena: Kate gisa kopiatuko den orriaren izena.

newname: Dokumentuan txertatuko den kopiatutako orriaren izena. Izenak ez du dokumentuan erabilia izan behar.

beforesheet: Kopiatutako orria zein orriren aurretik txertatuko den. Bigarren orri horren izena (katea) edo indizea (zenbakia, 1 zenbakitik hasita) izan daiteke. Argumentu hau aukerakoa da eta portaera lehenetsia da kopiatutako orria azken posizioan kopiatzea.

Hurrengo adibideak "myFile.ods" fitxategiko "SheetX" orria kopiatzen du eta "oDoc" aldagaiak "SheetY" gisa erreferentziatuta duen dokumentuan itsasten du, lehen posizioan.

    oDoc.CopySheetFromFile("C:\Documents\myFile.ods", "SheetX", "SheetY", 1)
  

    myDoc.CopySheetFromFile(r"C:\Documents\myFile.ods", "SheetX", "SheetY", 1)
  

CopyToCell

Zehaztutako iturburuko barruti bat (balioak, formulak eta formatuak) helburuko barruti edo gelaxka batean kopiatzen du. Metodoak kopiatu/itsatsi portaera errepikatzen du barrutik batetik gelaxka bakarrera.

Aldatutako gelaxka-barrutia ordezkatzen duen kate bat itzultzen du. Aldatutako arearen tamaina iturburuko arearen tamainak zehazten du.

Iturburu-barrutia beste dokumentu ireki batekoa izan daiteke.

svc.CopyToCell(sourcerange: any, destinationcell: str): str

sourcerange: Iturburu-barrutia kate gisa, dokumentu berekoa denean, edo erreferentzia gisa, beste Calc dokumentu batekoa denean.

destinationcell: Kopiatutako gelaxka-barrutia itsatsiko den helburuko gelaxka, kate gisa. Barruti bat ematen bada, goiko ezkerreko gelaxka soilik hartuko da kontuan.

Hurrengo adibidean, iturburua eta helburua fitxategi berean daude:

      oDoc.CopyToCell("SheetX.A1:F10", "SheetY.C5")
  

Beheko adibideak erakusten du nola kopiatu barruti bat beste Calc dokumentu ireki batean:

    Dim ui as Variant : ui = CreateScriptService("UI")
    Dim oDocSource As Object, oDocDestination As Object
    'Ireki iturburu-dokumentua atzeko planoan (ezkutuan)
    Set oDocSource = ui.OpenDocument("C:\SourceFile.ods", Hidden := True, ReadOnly := True)
    Set oDocDestination = CreateScriptService("Calc")
    oDocDestination.CopyToCell(oDocSource.Range("Sheet1.C2:C4"), "SheetT.A5")
    'Ez ahaztu iturburu-dokumentua ixtea, ezkutuan ireki baita
    oDocSource.CloseDocument()
  

    docSource = ui.OpenDocument(r"C:\Documents\SourceFile.ods", hidden = True, readonly = True)
    docDestination = CreateScriptService("Calc")
    docDestination.CopyToCell(docSource.Range("Sheet1.C2:C4"), "SheetT.A5")
    docSource.CloseDocument()
  

Barruti batetik gelaxka bakar batera kopiatuko/itsatsiko dela simulatzeko, erabili CopyToCell. Barruti batetik barruti handiago batera kopiatuko/itsatsiko dela (gelaxka berak hainbatetan bikoiztuta) simulatzeko, erabili CopyToRange.

CopyToRange

Beherantz eta/edo eskuinerantz kopiatzen du iturburu-barruti zehatz bat (balioak, formulak eta formatuak) helburuko barruti batean. Metodo horrek iturburu-barruti batetik helburuko barruti handiago batean kopiatzeko/itsasteko eragiketaren portaera imitatzen du.

• Helburuko arearen altuera (edo zabelar) > 1 errenkada (edo zutabe) bada, orduan iturburuaren altuerak (edo zabalerak) helburuaren <= altuera (edo zabalera) izan behar du. Bestela, ez da ezer gertatuko.

• Helburuaren altuera (edo zabalera) = 1 bada, helburua beherantz (edo eskuinerantz) hedatuko da iturburuko barrutiaren altuerara (edo zabalerara) iritsi arte.

Metodoak gelaxka-barruti aldatua ordezkatzen duen kate bat itzultzen du.

Iturburuko barrutia irekitako beste dokumentu batetik etorri daiteke.

svc.CopyToRange(sourcerange: any, destinationrange: str): str

sourcerange: Iturburu-barrutia kate gisa, dokumentu berekoa bada, edo erreferentzia gisa, irekita dagoen beste Calc dokumentu bateko bada.

destinationrange: Kopiatutako gelaxka-barrutien helburua, kate gisa.

Kopiatu dokumentu berearen barruan:

    oDoc.CopyToRange("SheetX.A1:F10", "SheetY.C5:J5")
    ' Barruti-kate bat itzultzen du: "$OrriaY.$C$5:$J$14"
  

Kopiatu fitxategi batetik beste batera:

    Dim oDocA As Object : Set oDocA = ui.OpenDocument("C:\Documents\FileA.ods", Hidden := True, ReadOnly := True)
    Dim oDocB As Object : Set oDocB = ui.OpenDocument("C:\Documents\FileB.ods")
    oDocB.CopyToRange(oDocA.Range("SheetX.A1:F10"), "SheetY.C5:J5")
  

    doc.CopyToRange("SheetX.A1:F10", "SheetY.C5:J5")
  

    docA = ui.OpenDocument(r"C:\Documents\FileA.ods", hidden = True, readonly = True)
    docB = ui.OpenDocument(r"C:\Documents\FileB.ods")
    docB.CopyToRange(docA.Range("SheetX.A1:F10"), "SheetY.C5:J5")
  

CreateChart

Zehaztutako barrutiko datuak erakusten dituen diagrama-objektu berri bat sortzen du. Itzulitako diagrama-objektua manipulatzeko, erabili Chart zerbitzua.

svc.CreateChart(chartname: str, sheetname: str, range: str, columnheader: bool = False, rowheader: bool = False): obj

chartname: Sortutako diagrama izendatzeko erabiltzaileak definitu duen izena. Izenak bakarra izan behar du orriaren barruan.

sheetname: Diagrama kokatuko den orriaren izena.

range: Diagramaren datu-iturburu gisa erabiliko den barrutia. Barrutia Calc dokumentuko edozein orritan egon daiteke.

columnheader: True (egia) bada, barrutiaren goiko errenkada erabiliko da legendaren kategoria-ardatzaren etiketak sortzeko (Balio lehenetsia = False).

rowheader: True (egia) bada, barrutiaren ezkerreko zutabea erabiliko da legendaren kategoria-ardatzaren etiketak sortzeko (Balio lehenetsia = False).

Beheko adibideak, Basic zein Python lengoaietan erabili daitekeenak, diagrama bat sortzen du "Sheet1" orriko "A1:B5" barrutian dauden datuak erabilita eta "Sheet2" orrian kokatzen du.

    Set oChart = oDoc.CreateChart("MyChart", "Sheet2", "Sheet1.A1:B5", RowHeader := True)
    oChart.ChartType = "Donut"
  

    chart = doc.CreateChart("MyChart", "Sheet2", "Sheet1.A1:B5", rowheader=True)
    chart.ChartType = "Donut"
  

Begiratu ScriptForge liburutegiari buruzko Chart zerbitzua diagrama-objektuak manipulatzeko modu gehiago ikasteko. Posible da diagramaren propietateak aldatzea, adibidez diagramaren mota, diagramaren zein ardatzen izenburuak edo diagramaren kokagunea.

CreatePivotTable

Metodoari pasatutako argumentuen bidez definitu diren propietateak dituen taula dinamiko bat sortzen du.

Taula dinamikoari izen bat eman behar zaio. Izen bereko beste taula dinamiko bat badago helburuko orrian, abisurik gabe ordeztuko da.

Metodo honek taula dinamiko berria kokatuko den barrutia duen kate bat itzultzen du.

svc.CreatePivotTable(pivottablename: str, sourcerange: str, targetcell: str, datafields: str[0..*], rowfields: str[0..*], columnfields: str[0..*], filterbutton: bool = true, rowtotals: bool = true, columntotals: bool = true): str

pivottablename: Taula dinamiko berriarentzat erabiltzaileak definitu duen izena.

sourcerange: Datu gordinak dituen barrutia. Lehen errenkadak taula dinamikoak erabiliko dituen eremu-izenak dituela ulertzen da.

targetcell: Taula dinamiko berria kokatzeko erabiliko den goiko ezkerreko gelaxka. Barruti bat zehazten bada, barrutiaren goiko ezkerreko gelaxka soilik hartuko da kontuan.

datafields: Kate bakarra izan daiteke edo kateen matrize bat izan daiteke. Aplikatuko diren eremu-izenak eta funtzioak definitzen dituzte kate horiek. Matrize bat zehazten bada, honako sintaxia izan behar du: Array("EremuIzena[;Funtzioa]", ...).

Onartutako funtzioak: Sum, Count, Average, Max, Min, Product, CountNums, StDev, StDevP, Var, VarP eta Median. Funtzioen izenak ingelesez eman behar dira. Balio guztiak zenbakizkoak badira, Sum izango da funtzio lehenetsia; bestela, Count izango da.

rowfields: Taula dinamikoaren errenkada gisa erabiliko diren eremu-izenak dituen kate bakar bat edo matrize bat.

columnfields: Taula dinamikoaren zutabe gisa erabiliko diren eremu-izenak dituen kate bakar bat edo matrize bat.

filterbutton: Taula dinamikoaren gainean iragazki-botoi bat bistaratuko den ala ez zehazten du (Balio lehenetsia = True).

rowtotals: Taula dinamikoari errenkada-totalak erakusteko zutabe bereizi bat gehituko zaion zehazten du (Balio lehenetsia = True).

columntotals Taula dinamikoari zutabeen totalak erakusteko errenkada bereizi bat gehituko zaion zehazten du (Balio lehenetsia = True)

    Dim vData As Variant, oDoc As Object, ui As Object, sTable As String, sPivot As String
    Set ui = CreateScriptService("UI")
    Set oDoc = ui.CreateDocument("Calc")
    vData = Array(Array("Elementua", "Herrialdea", "Taldea", "2002", "2003", "2004"), _
        Array("Liburuak", "Euskal Herria", "Asier", 14788, 30222, 23490), _
        Array("Gozokiak", "Katalunia", "Marc", 26388, 15641, 32849), _
        Array("Oinetakoak", "Galizia", "Xuxo", 16569, 32675, 25396), _
        Array("Liburuak", "Euskal Herria", "Irati", 21961, 21242, 29009), _
        Array("Gozokiak", "Galizia", "Francisca", 26142, 22407, 32841))
    sTable = oDoc.SetArray("A1", vData)
    sPivot = oDoc.CreatePivotTable("PT1", sTable, "H1", _
        Array("2002", "2003;count", "2004;average"), _ ' Hiru datu-eremu
        "Elementua", _ ' Errenkada-eremu bakarra
        Array("Herrialdea", "Taldea"), False) ' Bi zutabe-eremu
  

    ui = CreateScriptService("UI")
    doc = ui.CreateDocument("Calc")
    vData = [["Elementua", "Herrialdea", "Taldea", "2002", "2003", "2004"],
             ["Liburuak", "Euskal Herria", "Esther", 14788, 30222, 23490],
             ["Gozokiak", "Euskal Herria", "Esther", 26388, 15641, 32849],
             ["Oinetakoak", "Euskal Herria", "Esther", 16569, 32675, 25396)],
             ["Liburuak", "Euskal Herria", "Irati", 21961, 21242, 29009],
             ["Gozokiak", "Euskal Herria", "Irati", 26142, 22407, 32841]]
    sTable = doc.SetArray("A1", vData)
    sPivot = doc.CreatePivotTable("PT1", sTable, "H1",
                                  ["2002", "2003;count", "2004;average"],
                                  "Elementua",
                                  ["Herrialdea", "Taldea"], False)
  

LibreOffice Calc aplikazioko taula dinamikoak hobeto ezagutzeko, irakurri taula dinamikoen laguntza-orria.

DAvg, DCount, DMax, DMin and DSum

Apply the functions Average, Count, Max, Min and Sum, respectively, to all the cells containing numeric values on a given range, excluding values from filtered and hidden rows and hidden columns, the same as for the status bar functions.

svc.DAvg(range: str): float

svc.DCount(range: str): float

svc.DMax(range: str): float

svc.DMin(range: str): float

svc.DSum(range: str): float

range: Funtzioa aplikatuko zaion barrutia, kate gisa.

Beheko adibidean Sum funtzioa aplikatzen zaio unean hautatutako orriko "A1:A1000" barrutiari:

      result = oDoc.DSum("~.A1:A1000")
  

    result = myDoc.DSum("~.A1:A1000")
  

Emandako barrutian, testua duten gelaxkei ez ikusiarena egingo diete funtzio horiek. Adibidez, DCount metodoak ez ditu zenbatuko testua duten gelaxkak, zenbakiak dituztenak soilik.

ExportRangeToFile

Zehaztutako barrutia irudi gisa edo PDF fitxategi gisa esportatzen du.

Metodo honek True (egia) itzultzen du helburuko fitxategia ongi gorde bada.

Zehaztutako barrutiaren ezkutuko errenkadak edo zutabeak ez dira helburuko fitxategira esportatuko.

svc.ExportRangeToFile(range: str, filename: str, imagetype: str = "pdf", overwrite: bool = False): bool

range: Esportatuko den orri baten izena edo gelaxka-barruti bat, kate gisa.

filename: Gordeko den fitxategiaren izena. SF_FileSystem.FileNaming notazioa jarraitu behar du.

imagetype: Helburuko fitxategi mota identifikatzen du. Balio posibleak: "jpeg", "pdf" (lehenetsia) eta "png".

overwrite: True ezartzen bada, helburuko fitxategia gainidatzi daiteke (Balio lehenetsia = False).

    ' Orri osoa PDF fitxategi gisa esportatzen du
    oDoc.ExportRangeToFile("SheetX", "C:\Temp\image.pdf")
    ' Barrutia PNG fitxategi gisa esportatzen du eta helburuko fitxategia gainidazten du, hura badago
    oDoc.ExportRangeToFile("SheetX.A1:D10", "C:\Temp\image.png", "png", Overwrite := True)
  

    doc.ExportRangeToFile("SheetX", r"C:\Temp\image.pdf")
    doc.ExportRangeToFile("SheetX.A1:D10", r"C:\Temp\image.png", "png", overwrite = True)
  

Forms

Emandako parametroen arabera, metodoak honakoa itzuliko du:

• Zeron oinarritutako matrize bat (edo tupla bat Python-en), emandako orri bateko inprimaki guztiak dituena (Form argumenturik ez badago)

• Argumentu gisa zehaztu den inprimakia ordezkatzen duen SFDocuments.Form zerbitzuaren instantzia bat.

svc.Forms(sheetname: str): str[0..*]

svc.Forms(sheetname: str, form: str = ''): svc

svc.Forms(sheetname: str, form: int): svc

sheetname: Orri baten izena, kate gisa, zeinetatik inprimakia atzituko den.

form: Zehaztutako orrian biltegiratutako inprimaki baten izena edo hari dagokion indizea. Argumentu hau falta bada, metodoak orrian eskuragarri dauden inprimaki guztien izenak dituen zerrenda bat itzuliko du.

Hurrengo adibideetan, lehen lerroak "Orria1" orrian biltegiratutako inprimaki guztien izenak jasotzen ditu eta bigarren lerroak "Orria1" orrian dagoen "Inp_A" izeneko inprimakiaren Form objektua atzitzen du.

    Set FormNames = oDoc.Forms("Sheet1")
    Set FormA = oDoc.Forms("Sheet1", "Form_A")
  

    form_names = doc.Forms("Sheet1")
    form_A = doc.Forms("Sheet1", "Form_A")
  

GetColumnName

1 eta 1024 zenbakien artean dagoen zutabe-zenbaki bat zenbakiari dagokion letra ('A', 'B', ..., 'AMJ' zutabea) bihurtzen du. Emandako zutabe-zenbakia onartutako barrutitik at badago, zero luzerako kate bat itzuliko da.

svc.GetColumnName(columnnumber: int): str

columnnumber: The column number as an integer value in the interval 1 ... 16384.

Hirugarren zutabearen izena duen mezu-koadro bat bistaratzen du. Modu lehenetsian "C" da izena.

    MsgBox oDoc.GetColumnName(3)
  

    bas = CreateScriptService("Basic")
    bas.MsgBox(myDoc.GetColumnName(3))
  

The maximum number of columns allowed on a Calc sheet is 16384.

GetFormula

Eskuratu emandako gelaxka-barrutian gordetako formula(k) kate bakar gisa edo 1D edo 2D kate-matrize gisa.

Itzulitako formuletan erabiltzen diren Calc funtzioak ingelesezko izenaren bidez adierazi behar dira. Begiratu Calc funtzioen zerrenda gunea Calc funtzioak ingelesez nola diren jakiteko.

svc.GetFormula(range: str): any

range: Formulak zein barrutitik eskuratuko diren, kate gisa.

Hurrengo adibideak 3 x 2 matrize bat itzultzen du, "A1:B3" barrutiko formulak hartuta (3 errenkada x 2 zutabe):

    arrFormula = oDoc.GetFormula("~.A1:B3")
  

    arrFormula = myDoc.GetFormula("~.A1:B3")
  

GetValue

Eskuratu emandako gelaxka-barrutian gordetako balio(k) kate bakar gisa edo 1D edo 2D kate-matrize gisa. Balio guztiak zenbaki bikoitiak edo kateak dira.

svc.GetValue(range: str): any

range: Balioak zein barrutitik eskuratuko diren, kate gisa.

      arrValues = oDoc.GetValue("~.B1:C100")
  

    arrValues = myDoc.GetValue("~.B1:C100")
  

Gelaxka batek data bat badu, data horri dagokion zenbakia itzuliko da. Zenbakizko balioak data bihurtzeko Basic scriptetan, erabili CDate funtzio integratua. Python scriptetan, erabili Basic zerbitzuaren CDate funtzioa.

ImportFromCSVFile

CSV formatuko testu-fitxategi bateko edukiak inportatzen ditu eta emandako helburuko gelaxkan kokatzen ditu.

Helburuko areako eduki eta formatu guztiak garbitzen dira CSV fitxategiaren edukiak txertatu baino lehen. Aldatutako arearen tamaina sarrerako fitxategiko edukien araberakoa da.

Metodoak gelaxka-barruti aldatua ordezkatzen duen kate bat itzultzen du.

svc.ImportFromCSVFile(filename: str, destinationcell: str, [filteroptions: str]): str

filename: Irekiko den fitxategia identifikatzen du. SF_FileSystem.FileNaming notazioa jarraitu behar du.

destinationcell: Inportatutako datuak txertatuko diren helburuko gelaxka, kate gisa. Barruti bat ematen bada, goiko ezkerreko gelaxka soilik hartuko da kontuan.

filteroptions: Sarrerako CSV fitxategiaren argumentuak. Iragazki lehenetsiak honako baldintzak ematen ditu ontzat:

• Sarrerako fitxategiaren kodeketa UTF8 da.

• Eremu-bereizlea koma bat, puntu eta koma bat edo tabulazio bat da.

• Kate-mugatzailea komatxo bikoitza (") da.

• Lerro guztiak barne daude.

• Komatxo arteko kateei testuaren formatua emango zaie.

• Zenbaki bereziak detektatuko dira.

• Zutabe guztiak testukoak direla suposatuko da, baliozko zenbaki gisa ezagutzen direnean salbu.

• Hizkuntza AEBetako ingelesa da. Horrek inplikatzen du dezimalen bereizlea "." dela eta milakoen bereizlea "," dela.

    oDoc.ImportFromCSVFile("C:\Temp\myCSVFile.csv", "SheetY.C5")
  

    myDoc.ImportFromCSVFile(r"C:\Temp\myCSVFile.csv", "SheetY.C5")
  

CSV iragazkien aukerei buruz gehiago jakiteko, begiratu CSV iragazkien aukeren laguntza-orria.

ImportFromDatabase

Datu-base bateko taula, kontsulta edo emaitza multzo baten edukiak inportatzen ditu, alegia SELECT SQL komandoaren emaitza, eta helburuko gelaxka batean txertatzen du.

Helburuko areako eduki eta formatu guztiak garbituko dira inportatutako edukiak txertatu baino lehen. Aldatutako arearen tamaina taulako edo kontsultako edukien araberakoa izango da.

Metodo honek True itzultzen du inportazioa ongi gauzatu denean.

svc.ImportFromDatabase(filename: str = "", registrationname: str = "", destinationcell: str = "", sqlcommand: str = "", directsql: bool): bool

filename: Irekiko den fitxategia identifikatzen du. SF_FileSystem.FileNaming notazioa jarraitu behar du.

registrationname: Datu-baseen erregistroan datu-basea aurkitzeko erabiliko den izena. Argumentu honi ez ikusiarena egingo zaio filename ematen bada.

destinationcell: Inportatutako datuen helburua, kate gisa. Barruti bat ematen bada, goiko ezkerreko gelaxka soilik hartuko da kontuan.

sqlcommand: Taula baten edo kontsulta baten izena (inguruan komatxoak edo kortxeteak jarri gabe) edo SELECT SQL instrukzio bat non taularen edo eremuen izenak kortxeteekin edo komatxoekin inguratuta egon daitezkeen instrukzioaren irakurgarritasuna hobetzeko.

directsql: True (egia) denean, SQL komandoa aurretiko analisirik gabe bidaltzen zaio datu-basearen motorrari. Balio lehenetsia False (faltsua) da. Taulen kasuan, ez ikusiarena egiten zaio argumentuari. Kontsultetan, aplikatutako aukera kontsulta definitu zenean ezarritakoa da.

    oDoc.ImportFromDatabase("C:\Temp\myDbFile.odb", , "SheetY.C5", "SELECT * FROM [Employees] ORDER BY [LastName]")
  

    myDoc.ImportFromDatabase(r"C:\Temp\myDbFile.odb", , "SheetY.C5", "SELECT * FROM [Employees] ORDER BY [LastName]")
  

    oDoc.ImportStylesFromFile("C:\User\Documents\myFile.ods", "ParagraphStyles", True)
  

    doc.ImportStylesFromFile('C:\User\Documents\myFile.ods', ("ParagraphStyles",), False)
  

InsertSheet

Orri huts berria txertatzen du lehendik dagoen orri baten aurrean edo orrien zerrendaren amaieran.

svc.InsertSheet(sheetname: str, [beforesheet: any]): bool

sheetname: Orri berriaren izena.

beforesheet: Orri berria argumentu honetan ezarritako orriaren aurrean txertatuko da. Orriaren izena (katea) edo indizea (zenbakia, 1etik hasita) eman behar da. Argumentu hau aukerakoa da, portaera lehenetsian orria azken posizioan txertatuko da.

Hurrengo adibideak "SheetX" izeneko orri hutsa txertatzen du eta "SheetY" orriaren aurrean kokatzen du:

    oDoc.InsertSheet("SheetX", "SheetY")
  

    myDoc.InsertSheet("SheetX", "SheetY")
  

Intersect

Returns the string representing the intersection between the two input ranges, or a zero-length string when the intersection is empty.

svc.Intersect(range1:str, range2: str): str

range1: The address string of range 1.

range2: The address string of range 2.

The following example intersects two ranges, and returns the common range between both of them:

    Dim commonrange As String
    commonrange = oDoc.Intersect("A1:D8", "C3:F4")
    Print commonrange ' displays "$Sheet1.$C$3:$D$4"
  

    common_range = myDoc.Intersect("A1:D8", "C3:F4")
    print(common_range)  # outputs '$Sheet1.$C$3:$D$4' to the Python shell
  

MoveRange

Iturburko barruti bat helburuko gelaxka-barruti batera eramaten du. Metodoak gelaxka-barruti aldatua ordezkatzen duen kate bat itzultzen du. Aldatutako arearen dimentsioak iturburuko arearen tamainaren arabera zehazten dira.

svc.MoveRange(source: str, destination: str): str

source: Gelaxken iturburu-barrutia, kate gis