Tjenesten SFDocuments.Calc

The SFDocuments shared library provides a number of methods and properties to facilitate the management and handling of LibreOfficeDev documents.

The SFDocuments.Calc service is a subclass of the SFDocuments.Document service. All methods and properties defined for the Document service can also be accessed using a Calc service instance.

The Calc service is focused on:

note

This help page describes methods and properties that are applicable only to Calc documents.


Oppkall av tenester

Before using the Calc service the ScriptForge library needs to be loaded or imported:

note

• Basic macros require to load ScriptForge library using the following statement:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• Python scripts require an import from scriptforge module:
from scriptforge import CreateScriptService


Tenesta Calc er i nær slekt med tenesta UI i biblioteket ScriptForge. Du finn nokre få eksempel nedanfor på korleis tenesta Calc kan kallast opp.

I Basic

Kodesnutten nedanfor lagar eit eksemplar av tenesta Calc, som svarar til det gjeldande Calc-dokumentet.


    Set oDoc = CreateScriptService("Calc")
  

Ein annan måte å laga eit eksemplar av tenesta Calc på, er å bruka tenesta UI. I det neste eksempelet vert det laga eit nytt Calc-dokument der oDoc er eit eksemplar av tenesta Calc:


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

Eller med metoden OpenDocument frå tenesta UI:


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

Det er også mogleg å starta tenesta Calc med metoden CreateScriptService:


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

I eksempelet ovanfor er «MiFil.ods» namnet på eit opna dokumentvindauge. Viss dette argumentet ikkje er gjeve, vert det aktive vindauget vurdert brukt.

Det vert tilrådd å frigje ressursar etter bruk:


    Set oDoc = oDoc.Dispose()
  

Viss dokumentet vart lukka ved hjelp av metoden CloseDocument, er det ikkje nødvendig å frigjera ressursar med kommandoen nemnd ovanfor.

I Python

    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()
  
tip

Bruk av prefikset «SFDocuments.» ved oppkall av tenesta er frivillig.


Definisjonar

Mange metodar krev eit "Ark" eller eit "Område" som argument. Enkeltceller vert rekna som eit spesialtilfelle av eit Område.

Begge kan uttrykkjast anten som ein streng eller som ein referanse (= objekt), avhengig av situasjonen:

Eksempel:

Eksempelet nedanfor kopierer data frå dokument A (opna skriveverna og gøymd) til dokument B.

I Basic

    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)
  
I Python

    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

Anten arknamnet som ein string eller eit object laga av eigenskapen .Sheet.

Snarvegen «~» (tilde) representerer det gjeldande arket.

RangeName

Anten ein streng som gjev eit sett med samanhengande celler som er plasserte i eit ark i gjeldande førekomst, eller eit objekt laga av .Range.

Snarvegen «~» (tilde) representerer den gjeldande markeringa eller det første området, viss det er markert fleire område.

Snarvegen «*» (stjerne) representerer alle brukte celler.

Arknamnet er valfritt i eit område (standard = det aktive arket). Omkringliggjande enkelt sitatteikn og $-teikn er tillatne, men vert ignorerte.

tip

Med unnatak av eigenskapen CurrentSelection vurderer tenesta Calc berre enkeltområde med celler.


Eksempel på gyldige område

1) '$ArkX'.D2
2) $D$2

Ei enkelt celle

1) '$ArkX'.D2:F6
2) D2:D10

Enkelt område med fleire celler

'$ArkX'.*

Alle brukte celler i det gjevne arket

1) '$ArkX'.A:A kolonne A)
2) 3:5 (radene 3 til 5)

Alle celler i samanhengande kolonnar eller rader opp til den sist brukte cella

mittOmråde

Eit område med namnet «mittOmråde» på reknearknivå

1) ~eitOmråde
2) ArkX.eitOmråde

Eit områdenamn på arknivå

mittDok.Område("ArkX.D2:F6")

Eit område innanfor arket SheetX i fila knytt til myDoc Calc-førekomsten

~.~ eller ~

Den gjeldande markeringa på det aktive arket


Eigenskapar

Alle eigenskapane som er generiske for alle dokument, gjeld implisitt også for Calc-dokument. Viss du vil ha meir informasjon, kan du lesa Document service Help page.

Eigenskapane som er spesielt tilgjengelege for Calc-dokument er:

Namn

Skriveverna

Argument

Returtype

Beskriving

CurrentSelection

Nei

Ingen

Streng eller ei matrise av strengar

Det merkte enkeltområdet som ein streng eller lista over merkte område som ei matrise

FirstCell

Ja

Arknamn eller områdenamn som streng

String

Returnerer den første brukte cella i eit gjeve område eller ark.

FirstColumn

Ja

Arknamn eller områdenamn som streng

Long

Returnerer kolonnenummeret lengst til venstre i eit gjeve område eller ark.

FirstRow

Ja

Arknamn eller områdenamn som streng

Long

Returnerer det øvste radnummeret i eit gjeve område eller ark.

Height

Ja

Områdenamn som streng

Long

Talet på rader (>= 1) i det gjevne området.

LastCell

Ja

Arknamn eller områdenamn som streng

String

Returnerer den siste brukte cella i eit gjeve område eller ark.

LastColumn

Ja

Arknamn eller områdenamn som streng

Long

Den siste brukte kolonnen i eit gjeve område eller ark.

LastRow

Ja

Arknamn eller områdenamn som streng

Long

Den siste brukte rada i eit gjeve område eller ark.

Range

Ja

Områdenamn som streng

Object

Ein områdereferanse som kan brukast som argument av metodar som CopyToRange

Region

Ja

Områdenamn som streng

String

Returnerer adressa til det minste området som inneheld det gjevne området, slik at området er omgjeve av tomme celler eller arkkantar. Dette svarar til å bruka snarvegen til det gjevne området.

Sheet

Ja

Arknamn som streng

Object

Ein arkreferanse som kan brukast som argument av metodar som CopySheet.

SheetName

Yes

RangeName As String

String

Returns the sheet name of a given range address.

Sheets

Ja

Ingen

Matrise av strengar

Lista med namn på alle arka som finst.

Width

Ja

Områdenamn som streng

Long

Talet på kolonnar (>= 1) i det gjevne området.

XCellRange

Ja

Områdenamn som streng

Object

Eit com.sun.star.Table.XCellRange UNO-objekt.

XSheetCellCursor

Ja

Områdenamn som streng

Object

Eit com.sun.star.sheet.XSheetCellCursor UNO-objekt. Etter å ha flytt markøren, kan den resulterande områdeadressa nåast gjennom markørobjektet sin UNO-eigenskap AbsoluteName, som returnerer ein strengverdi som kan brukast som argument for eigenskapar og metodar for Calc-tenesta.

XSpreadsheet

Ja

Arknamn som streng

Object

Eit com.sun.star.sheet.XSpreadsheet UNO-objekt.


tip

Besøk nettstaden til LibreOfficeDev API-dokumentasjonen for å læra meir om XCellRange, XSheetCellCursor og XSpreadsheet UNO-objekter.


Metodar

Liste over metodar i tenesta Calc

A1Style
Activate
Charts
ClearAll
ClearFormats
ClearValues
CompactLeft
CompactUp
CopySheet
CopySheetFromFile
CopyToCell
CopyToRange
CreateChart
CreatePivotTable
DAvg

DCount
DMax
DMin
DSum
Forms
GetColumnName
GetFormula
GetValue
ImportFromCSVFile
ImportFromDatabase
InsertSheet
MoveRange
MoveSheet
Offset

OpenRangeSelector
PrintOut
Printf
RemoveSheet
RenameSheet
SetArray
SetValue
SetCellStyle
SetFormula
ShiftDown
ShiftLeft
ShiftRight
ShiftUp
SortRange


A1Style

Returnerer ei områdeadresse som ein streng basert på ark-koordinata, dvs. rad- og kolonnenummer.

Viss berre eitt koordinatpar er gjeve,vert det returnert ei adresse til ei enkelt celle. Tilleggsargument kan spesifisera cella nedst til høgre i eit rektangulært område.

Syntaks:

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

Parametrar:

rad1, kolonne1: Spesifiser rad- og kolonnenumeret til cella øverst til venstre i området som skal vurderast. Rad- og kolonnenummer byrjar på 1.

rad2, kolonne2: Spesifiser rad- og kolonnenumret til cella nedst til høgre i området som skal vurderast. Viss desse argumenta ikkje er gjevne, eller viss det er gjevne verdiar som er mindre enn rad1 og kolonne1, vert adressa til enkeltcelleområdet representert av rad1 og kolonne1 returnert.

arknamn: Namnet på arket som skal leggjast til den returnerte områdeadressa. Arket må finnast. Standardverdien er «~», som svarar til det gjeldande arket.

Eksempel:

Eksempla nedanfor i Basic og Python går ut frå at «Ark1» er det gjeldande arket.

I Basic

    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
  
I Python

    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
  
tip

Metoden A1Style kan kombinerast med alle dei mange eigenskapane og metodane i Calc-tenesta som krev eit område som argument, for eksempel GetValue, GetFormula, ClearAll osv.


Activate

If the argument sheetname is provided, the given sheet is activated and it becomes the currently selected sheet. If the argument is absent, then the document window is activated.

Syntaks:

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

Parametrar:

arknamn: Namnet på det arket som skal aktiverast i dokumentet. Standardverdien er ein tom streng, noko som gjer at dokumentvindauget vert aktivert, utan at det gjeldande arket vert endra.

Eksempel:

Eksempelet nedanfor aktiverer arket med namnet «Ark4» i det gjeldande dokumentet.

I Basic

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

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

Aktivering av eit ark gjev meining berre når aktiveringa vert gjort i eit Calc-dokument. For å sikr deg at du har eit Calc-dokument tilgjengeleg, kan du bruka eigenskapen isCalc for dokumentobjektet, som returnerer Sann viss der er eit Calc-dokument og elles Usann.


Charts

Returns either the list with the names of all chart objects in a given sheet or a single Chart service instance.

Syntaks:

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

Parametrar:

sheetname: The name of the sheet from which the list of charts is to be retrieved or where the specified chart is located.

chartname: The user-defined name of the chart object to be returned. If the chart does not have a user-defined name, then the internal object name can be used. If this argument is absent, then the list of chart names in the specified sheet is returned.

tip

Use the Navigator sidebar to check the names assigned to charts under the OLE objects category.


Eksempel:

I Basic

The example below shows the number of chart objects in "Sheet1".


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

The following example accesses the chart named "MyChart" in "Sheet1" and prints its type.


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

    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

Ryddar alt indhaldet og alle format i det gjevne området.

Syntaks:

svc.ClearAll(range: str)

Parametrar:

område: Området som skal ryddast, som ein streng.

Eksempel:

I Basic

      oDoc.ClearAll("SheetX.A1:F10")
  
I Python

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

ClearFormats

Ryddar format og stilar i det gjevne området.

Syntaks:

svc.ClearFormats(range: str)

Parametrar:

område: Det området der format og stilar skal ryddast, som ein streng.

Eksempel:

I Basic

      oDoc.ClearFormats("SheetX.*")
  
I Python

    myDoc.ClearFormats("SheetX.*")
  

ClearValues

Ryddar verdiane og formlane i det gjevne området.

Syntaks:

svc.ClearValues(range: str)

Parametrar:

område: Det området der verdiane og formlane skal ryddast, som ein streng.

Eksempel:

I Basic

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

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

CompactLeft

Deletes the columns of a specified range that match a filter expressed as a Calc formula. The filter is applied to each column to decide whether it will be deleted or not.

The deleted column can be limited to the height of the specified range or span to the height of the entire sheet, thus deleting whole columns.

This method returns a string with the range address of the compacted range. If all columns are deleted, then an empty string is returned.

note

If a range of cells is selected, calling this method will not impact the selection.


Syntaks:

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

Parametrar:

range: The range from which columns will be deleted, as a string.

wholecolumn: If this option is set to True the entire column will be deleted from the sheet. The default value is False, which means that the deleted column will be limited to the height of the specified range.

filterformula: The filter to be applied to each column to determine whether or not it will be deleted. The filter is expressed as a Calc formula that should be applied to the first column. When the formula returns True for a column, that column will be deleted. The default filter deletes all empty columns.

For example, suppose range A1:J200 is selected (height = 200), so the default formula is =(COUNTBLANK(A1:A200)=200). This means that if all 200 cells are empty in the first column (Column A), then the column is deleted. Note that the formula is expressed with respect to the first column only. Internally the CompactLeft method will generalize this formula for all the remaining columns.

Eksempel:

I Basic

    ' Delete all empty columns in the range G1:L10 from Sheet1
    newrange = oDoc.CompactLeft("Sheet1.G1:L10")
    ' The example below is similar, but the entire column is deleted from the sheet
    newrange = oDoc.CompactLeft("Sheet1.G1:L10", WholeColumn := True)
    ' Deletes all columns where the first row is marked with an "X"
    newrange = oDoc.CompactLeft("Sheet1.G1:L10", FilterFormula := "=(G1=""X"")")
    ' Deletes all columns where the sum of values in the column is odd
    newrange = oDoc.CompactLeft("Sheet1.G1:L10", FilterFormula := "=(MOD(SUM(G1:G10);2)=1)")
  
I Python

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

CompactUp

Deletes the rows of a specified range that match a filter expressed as a Calc formula. The filter is applied to each row to decide whether it will be deleted or not.

The deleted rows can be limited to the width of the specified range or span to the width of the entire sheet, thus deleting whole rows.

This method returns a string with the range address of the compacted range. If all rows are deleted, then an empty string is returned.

note

If a range of cells is selected, calling this method will not impact the selection.


Syntaks:

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

Parametrar:

range: The range from which rows will be deleted, as a string.

wholerow: If this option is set to True the entire row will be deleted from the sheet. The default value is False, which means that the deleted row will be limited to the width of the specified range.

filterformula: The filter to be applied to each row to determine whether or not it will be deleted. The filter is expressed as a Calc formula that should be applied to the first row. When the formula returns True for a row, that row will be deleted. The default filter deletes all empty rows.

For example, suppose range A1:J200 is selected (width = 10), so the default formula is =(COUNTBLANK(A1:J1)=10). This means that if all 10 cells are empty in the first row (Row 1), then the row is deleted. Note that the formula is expressed with respect to the first row only. Internally the CompactUp method will generalize this formula for all the remaining rows.

Eksempel:

I Basic

    ' Delete all empty rows in the range G1:L10 from Sheet1
    newrange = oDoc.CompactUp("Sheet1.G1:L10")
    ' The example below is similar, but the entire row is deleted from the sheet
    newrange = oDoc.CompactUp("Sheet1.G1:L10", WholeRow := True)
    ' Deletes all rows where the first column is marked with an "X"
    newrange = oDoc.CompactUp("Sheet1.G1:L10", FilterFormula := "=(G1=""X"")")
    ' Deletes all rows where the sum of values in the row is odd
    newrange = oDoc.CompactUp("Sheet1.G1:L10", FilterFormula := "=(MOD(SUM(G1:L1);2)=1)")
  
I Python

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

CopySheet

Kopierer eit bestemt ark før eit eit ark som finst frå før eller i slutten av lista over ark. Det arket som skal kopierast, kan vera inne i kva ope Calc-dokument som helst. Returnerer Sann viss vellukka.

Syntaks:

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

Parametrar:

Arknamn: Namnet på arket som skal kopierast, som ein streng eller ein referanse til det som eit objekt.

nyttnamn: Namnet på arket sol skal setjast inn. Namnet må ikkje vera i bruk andre stader i dokumentet.

beforesheet: Namnet (streng) eller indeksnummeret (tal, byrjar frå 1) på arket framføre som det kopierte arket skal setjast inn i. Dette argumentet er valfritt. Standar er at det kopierte arket vert sett inn sist i arket.

Eksempel:

I Basic

Dette eksempelet lagar ein kopi av arket «ArkX» og plasserer det som det siste arket i det gjeldande dokumentet. Namnet på det kopierte arket er «ArkY».


    Dim oDoc as Object
    ' Hentar dokumentobjektet frå det aktive vindauget
    Set oDoc = CreateScriptService("Calc")
    oDoc.CopySheet("SheetX", "SheetY")
  

Eksemplet nedanfor kopierer «ArkX» frå «FilA.ods» og limer det inn ved siste plassering av «FilB.ods» med namnet «ArkY»:


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

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

Viss du vil kopiera ark mellom opne dokument, brukar du CopySheet. For å kopiera ark frå dokument som er lukka, brukar du CopySheetFromFile.


CopySheetFromFile

Kopierer eit bestemt ark frå eit lukka Calc-dokument og limer det inn framføre eit ark som finst frå før, eller på slutten av lista over ark i fila referert til av eit Document-objekt.

Viss fila ikkje finst, vert det sett opp ein feil. Viss fila ikkje er ei gyldig Calc-fil, vert det sett inn eit tomt ark.Viss kjeldearket ikkje finst i inndatafila, vert det sett inn ei feilmelding øvst i det nyleg innlimte arket.

Syntaks:

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

Parametrar:

filnamn: Identifiserer fila som skal opnast. Namnet må følgja SF_FileSystem.FileNaming-notasjonen. Fila må ikkje vera verna med passord.

arknamn: Namnet på arket som skal kopierast som ein streng.

nyttnamn: Namnet på arket som skal setjast inn i dokumentet. Namnet må ikkje vera i bruk andre stader i dokumentet.

beforesheet: Namnet (streng) eller indeksnummeret (tal, byrjar frå 1) på arket framføre som det kopierte arket skal setjast inn i. Dette argumentet er valfritt. Standar er at det kopierte arket vert sett inn sist i arket.

Eksempel:

Det neste eksempelet kopierer «ArkX» frå «miFil.ods» og set det inn som «ArkY» først i det dokumentet som er referert til som «oDoc».

I Basic

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

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

CopyToCell

Kopierer eit gjeve kjeldeområde (verdiar, formlar og format) til eit målområde eller ei bestemt celle. Metoden reproduserer verkemåten til ein Kopier/lim inn-operasjon frå eit område til ei enkelt celle.

Den returnerer ein streng som representerer det endra celleområdet. Storleiken på det modifiserte området vert fullt ut bestemt av storleiken på kjeldeområdet.

Kjeldeområdet kan høyra til eit anna opna dokument.

Syntaks:

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

Parametrar:

kjeldeområde: Kjeldeområdet som ein streng når det høyrer til same dokumentet, eller som ein referanse når det høyrer til eit anna ope Calc-dokument.

målcelle: Målcella der det kopierte celleområdet skal limast inn, som ein streng. Viss det er gjeve eit område, vert det berre teke omsyn til den øvre, venstre cella i området.

Eksempel:

I Basic

I neste eksempel er kjelda og målet i same fila:


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

Eksempelet nedanfor viser korleis du kan kopiera eit område frå eit anna, ope Calc-dokument:


    Dim ui as Variant : ui = CreateScriptService("UI")
    Dim oDocSource As Object, oDocDestination As Object
    ' Opna kjeldedokument i bakgrunnen (gøymd)
    Set oDocSource = ui.OpenDocument("C:\SourceFile.ods", Hidden := True, ReadOnly := True)
    Set oDocDestination = CreateScriptService("Calc")
    oDocDestination.CopyToCell(oDocSource.Range("Sheet1.C2:C4"), "SheetT.A5")
    ' Ikkje gløym å lukka kjeldedokumentet fordi det vart opna som gøymd
    oDocSource.CloseDocument()
  
I Python

    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()
  
tip

For å simulera «Kopier/Lim inn» frå eit område til eienkelt celle, brukar du CopyToCell. For å simulera «Kopier/Lim inn» frå eit område til eit større område (med dei same cellene kopierte fleire gongar) brukar du CopyToRange.


CopyToRange

Kopierer eit gjeve kjeldeområde nedover og/eller mot høgre (verdiar, formlar og format) til eit målområde. Metoden imiterer verkemåten til ein «Kopier/Lim inn»-operasjon frå eit kjeldeområde til eit større målområde.

Metoden returnerer ein streng som representerer det endra celleområdet.

Kjeldeområdet kan høyra til eit anna opna dokument.

Syntaks:

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

Parametrar:

kjeldeområde: Kjeldeområdet som ein streng når det høyrer til same dokumentet, eller som ein referanse når det høyrer til eit anna ope Calc-dokument.

målområde: Målet for det kopierte celleområdet som ein streng.

Eksempel:

I Basic

Kopiera innføre det same dokumentet:


    oDoc.CopyToRange("SheetX.A1:F10", "SheetY.C5:J5")
    ' Returnerer ein områdestreng: «$ArkY.$C$5:$J$14»
  

Kopiera frå éi fil til ei anna:


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

    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

Creates a new chart object showing the data in the specified range. The returned chart object can be further manipulated using the Chart service.

Syntaks:

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

Parametrar:

chartname: The user-defined name of the chart to be created. The name must be unique in the same sheet.

sheetname: The name of the sheet where the chart will be placed.

range: The range to be used as the data source for the chart. The range may refer to any sheet of the Calc document.

columnheader: When True, the topmost row of the range is used as labels for the category axis or the legend (Default = False).

rowheader: When True, the leftmost column of the range is used as labels for the category axis or the legend. (Default = False).

Eksempel:

The examples below in Basic and Python create a chart using the data contained in the range "A1:B5" of "Sheet1" and place the chart in "Sheet2".

I Basic

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

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

Refer to the help page about ScriptForge's Chart service to learn more how to further manipulate chart objects. It is possible to change properties as the chart type, chart and axes titles and chart position.


CreatePivotTable

Creates a new pivot table with the properties defined by the arguments passed to the method.

A name must be provided for the pivot table. If a pivot table with the same name already exists in the targeted sheet, it will be replaced without warning.

This method returns a string containing the range where the new pivot table was placed.

Syntaks:

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

Parametrar:

pivottablename: The user-defined name of the new pivot table.

sourcerange: The range containing the raw data, as a string. It is assumed that the first row contains the field names that are used by the pivot table.

targetcell: The top-left cell where the new pivot table will be placed. If a range is specified, only its top-left cell is considered.

datafields: It can be either a single string or an array containing strings that define field names and functions to be applied. When an array is specified, it must follow the syntax Array("FieldName[;Function]", ...).

The allowed functions are: Sum, Count, Average, Max, Min, Product, CountNums, StDev, StDevP, Var, VarP and Median. Function names must be provided in English. When all values are numerical, Sum is the default function, otherwise the default function is Count.

rowfields: A single string or an array with the field names that will be used as the pivot table rows.

columnfields: A single string or an array with the field names that will be used as the pivot table columns.

filterbutton: Determines whether a filter button will be displayed above the pivot table (Default = True).

rowtotals: Specifies if a separate column for row totals will be added to the pivot table (Default = True).

columntotals Specifies if a separate row for column totals will be added to the pivot table (Default = True)

Eksempel:

I Basic

    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("Item", "State", "Team", "2002", "2003", "2004"), _
        Array("Books", "Michigan", "Jean", 14788, 30222, 23490), _
        Array("Candy", "Michigan", "Jean", 26388, 15641, 32849), _
        Array("Pens", "Michigan", "Jean", 16569, 32675, 25396), _
        Array("Books", "Michigan", "Volker", 21961, 21242, 29009), _
        Array("Candy", "Michigan", "Volker", 26142, 22407, 32841))
    sTable = oDoc.SetArray("A1", vData)
    sPivot = oDoc.CreatePivotTable("PT1", sTable, "H1", _
        Array("2002", "2003;count", "2004;average"), _ ' Three data fields
        "Item", _ ' A single row field
        Array("State", "Team"), False) ' Two column fields
  
I Python

    ui = CreateScriptService("UI")
    doc = ui.CreateDocument("Calc")
    vData = [["Item", "State", "Team", "2002", "2003", "2004"],
             ["Books", "Michigan", "Jean", 14788, 30222, 23490],
             ["Candy", "Michigan", "Jean", 26388, 15641, 32849],
             ["Pens", "Michigan", "Jean", 16569, 32675, 25396)],
             ["Books", "Michigan", "Volker", 21961, 21242, 29009],
             ["Candy", "Michigan", "Volker", 26142, 22407, 32841]]
    sTable = doc.SetArray("A1", vData)
    sPivot = doc.CreatePivotTable("PT1", sTable, "H1",
                                  ["2002", "2003;count", "2004;average"],
                                  "Item",
                                  ["State", "Team"], False)
  
tip

To learn more about Pivot Tables in LibreOfficeDev Calc, read the Pivot Table help page.


DAvg, DCount, DMax, DMin and DSum

Bruk funksjonane Gjennomsnitt, Tal på, Maks, Min og Summer respektive på alle cellene som inneheld talverdiar i eit gjeve område.

Syntaks:

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

Parametrar:

område: Området som funksjonen skal brukast på, som ein streng.

Eksempel:

Eksempelet nedanfor brukar funktsjnen Sum på området «A1:A1000» i det gjeldande arket.

I Basic

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

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

I det gjevne området vert celler som inneheld tekst ignorerte av alle funksjonane. For eksempel vil metoden DCount ikkje telja celler med tekst, berre celler med tal.


Forms

Avhengig av kva parameterar som er gjevne, vil denne metoden returnere:

Syntaks:

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

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

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

Parametrar:

arknamn: Namnet på arket (som ein streng) som skjemaet skal hentast frå.

skjema: Namnet eller indeksnummeret på skjemaet som er lagra i det gjevne arket. Viss dette argument manglar, vil metoden returnera ei liste med namna på alle skjemaa som er tilgjengelege i arket.

Eksempel:

I dei neste eksempla får den første linja namna på alle skjemaa som er lagra i «Ark1» og den anden linje hentar objektet Form frå skjemaet med namnet «Skjema_A», som er lagra i «Ark1».

I Basic

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

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

GetColumnName

Konverterer eit kolonnenummerområde mellom 1 og 1024 til dei tilsvarande bokstavane (kolonne 'A', 'B', …, 'AMJ'). Viss det gjevne kolonnenummeret er utanfor det tillate området, vert det returnert ein null-lengde streng.

Syntaks:

svc.GetColumnName(columnnumber: int): str

Parametrar:

kolonnenummer: Kolonnenummeret som eit heiltal i intervallet 1 … 1024.

Eksempel:

I Basic

Viser eit meldingsfelt med namnet på den tredje kolonnen, standard er «C».


    MsgBox oDoc.GetColumnName(3)
  
I Python

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

Det høgste talet på kolonnar tillatne i eit Calc-ark er 1024.


GetFormula

Hentar formelen eller fomlane som er lagra i det gjevne celleområdet som ein enkel streng, ei 1D- eller 2D-matrise.

Syntaks:

svc.GetFormula(range: str): any

Parametrar:

område: Området som formlane vert henta frå, som ein streng.

Eksempel:

I Basic

Det neste eksempelet returnere ei 3 × 2 matrise med formlar i området «A1:B3» (3 rader gonge 2 kolonnar):


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

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

GetValue

Hent verdien/verdiane som er lagra i det gjevne celleområdet, som éin enkelt verdi, ei 1D-matrise eller ei 2D-matrise. Alle verdiar er anten doble eller strengar.

Syntaks:

svc.GetValue(range: str): any

Parametrar:

område: Området som verdiane vert henta frå, som ein streng.

Eksempel:

I Basic

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

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

Viss ei celle inneheld ein dato, vert talet som svarar til denne datoen returnert. For å konvertera tal til datoar i Basic-skript, bruk den innebygde Basic-funksjonen CDate. IPython, bruk funksjonen CDate frå tenesta Basic.


ImportFromCSVFile

Importerer innhaldet av ei CSV-formatert tekstfil og set det inn i ei gjeve målcelle.

Alt innhald og alle format i målområdet vert fjerna før innhaldet i CSV-fila vert sett inn. Storleiken på det endra området vert bestemt fullt og heilt av innhaldet i inndatafila.

Metoden returnerer ein streng som representerer det endra celleområdet.

Syntaks:

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

Parametrar:

filnamn: Identifiserer fila som skal opnast. Namnet må følgja notasjonen SF_FileSystem.FileNaming .

målcelle: Målcella som dei importerte dataa skal setjast inn i, som ein streng. Viss det er gjeve eit område, vert det berre teke omsyn til den øvre, venstre cella.

filterindstillingar: Argumentet for CSV-inndatafilteret. Standardfilteret gjer desse antakingane:

Eksempel:

I Basic

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

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

To learn more about the CSV Filter Options, refer to the CSV Filter Options help page.


ImportFromDatabase

Importerer innhaldet i ein databasetabell, ei spørjing eller eit resultatsett, dvs. resultatet av ein SELECT SQL-kommando ved å setja det inn i ei målcelle.

Alt innhald og alle format i målområdet vert fjerna før det importerte innhaldet vert sett inn. Storleiken på det endra området vert bestemt fullt og heilt av innhaldet i matrisa eller spørjinga.

Metoden returnerer Sann når han lukkast.

Syntaks:

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

Parametrar:

filnamn: Identifiserer fila som skal opnast. Namnet må følgja notasjonen SF_FileSystem.FileNaming .

registreringsnamn: Namnet som vert brukt for å finna databasen i databaseregisteret. Dette argument vert ignorert viss det er gjeve eit filnamn.

målcelle: Målet for dei importerte dataa, som ein streng. Viss det er gjeve eit område, vert det berre teke omsyn til den øverste, venstre cella.

sql-kommando: Ein tabell- eller eit spørjingsnamn (utan hermeteikn eller klammeparentesar) eller eit SELECT SQL-uttrykk der tabell- og feltnamna kan innehalda hermeteikn eller klammeparentesar for å gjera uttrykket enklare å lesa.

direkte_sql: Når denne er Sann, vert SQL-kommandoen sendt til databasemotoren utan førehandsanalyse. Standard er Usann. Argumentet vert ignorert for tabellar. For spørjingar er det brukte alternativet det som vart sett då spørjinga vart definert.

Eksempel:

I Basic

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

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

InsertSheet

Set inn eit nytt tomt ark framføre eit ark som finst frå før eller sist i lista over ark.

Syntaks:

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

Parametrar:

arknamn: Namnet på det nye arket.

beforesheet: Namnet (streng) eller indeksnummeret (tal, byrjar frå 1) på arket framføre som det nye arket skal setjast inn i. Dette argumentet er valfritt. Standar er at det kopierte arket vert sett inn sist i arket.

Eksempel:

Det neste eksempelet set inn eit nytt, tomt ark med namnet «ArkX» framføre «ArkY»:

I Basic

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

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

MoveRange

Flytter eit gjeve kjeldeområde til eit målområde med celler. Metoden returnerer ein streng som representerer celleområdet som er endra. Dimensjonen på det endra området vert bestemt fullt ut av storleiken på kjeldeområdet.

Syntaks:

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

Parametrar:

kjelde: kjeldeområdet av celler, som ein streng.

mål: Målcella som ein streng. Viss det er gjeve eit område, vert cella øvst til venstre i området rekna som målet.

Eksempel:

I Basic

    oDoc.MoveRange("SheetX.A1:F10", "SheetY.C5")
  
I Python

    myDoc.MoveRange("SheetX.A1:F10", "SheetY.C5")
  

MoveSheet

Flyttar eit eksisterande ark og plasserer det framføre eit spesifisert ark eller på slutten av lista over ark.

Syntaks:

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

Parametrar:

arknamn: Namnet på arket som skal flyttast. Arknamnet må finnast elles vert det sett eit unntak.

beforesheet: Namnet (streng) eller indeksnummeret (tal, byrjar frå 1) på arket framføre som det opphavlege arket skal setjast inn i. Dette argumentet er valfritt. Standar er at det kopierte arket vert sett inn sist i arket.

Eksempel:

Eksempelet nedanfor flytter det eksisterande «ArkX» og set det framføre «ArkY»:

I Basic

    oDoc.MoveSheet("SheetX", "SheetY")
  
I Python

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

Offset

Returnerer eit nytt område (som ein streng) forskyvt med eit bestemt tal på rader og kolonnar frå eit gjeve område.

Denne funksjonen gjer det same som den einslydande funksjonen Forskyv i Calc.

Syntaks:

svc.Offset(reference: str, rows: int = 0, columns: int = 0, [height: int], [width: int]): str

Parametrar:

referanse: Området, som ein streng, som metoden vil bruka som referanse til å utføra forskyvingsoperasjonen.

rader: Kor mange rader som det opphavlege området skal forskyvast oppover (negativ verdi) eller nedover (positiv verdi). Bruk 0 (standard) for å forbli i same rada.

kolonnar: Kor mange kolonnar som det opphavlege området skal forskyvast mot venstre (negativ verdi) eller mot høgre (positiv verdi). Bruk 0 (standard) for å forbli i same kolonnen.

høgd: Den loddrette høgda for eit område som byrjar ved den nye områdeposisjonen. Utelat dette argumentet når det ikkje er behov for loddrett endring av storleiken.

breidde: Den vassrette breidd for eit område som byrjar ved den nye områdeposisjonen. Utelat dette argumentet når det ikkje er behov for vassrett endring av storleiken.

Argumenta rader og kolonnar kan ikkje resultera i null eller negativ startrad eller startkolonne.

Argumenta høgd og breidd kan ikkje resultera i null eller eit negativt tal på rader eller kolonnar.

Eksempel:

I Basic

    oDoc.Offset("A1", 2, 2)
    ' ArkX.$C$3 (A1 flytt to rader og to kolonnar ned)
    oDoc.Offset("A1", 2, 2, 5, 6)
    ' ArkX.$C$3:$H$7 (A1 forskjøve med to rader og kolonnar med ei breidd på 5 rader og 6 kolonnar)
  
I Python

    myDoc.Offset("A1", 2, 2)
    myDoc.Offset("A1", 2, 2, 5, 6)
  

OpenRangeSelector

Opens a non-modal dialog that can be used to select a range in the document and returns a string containing the selected range.

note

This method opens the same dialog that is used by LibreOfficeDev when the Shrink button is pressed. For example, the Tools - Goal Seek dialog has a Shrink button to the right of the Formula cell field.


This method does not change the current selection.

Syntaks:

svc.OpenRangeSelector(opt title: str, opt selection: str, singlecell: bool = False, closeafterselect: bool = True): str

Parametrar:

title: The title of the dialog, as a string.

selection: An optional range that is initially selected when the dialog is displayed.

singlecell: When True (default) only single-cell selection is allowed. When False range selection is allowed.

closeafterselect: When True (default) the dialog is closed immediately after the selection is made. When False the user can change the selection as many times as needed and then manually close the dialog.

Eksempel:

I Basic

    Dim sRange as String
    sRange = oDoc.OpenRangeSelector(Title := "Select a range")
  
I Python

    sRange = myDoc.OpenRangeSelector(title = "Select a range")
  

Printf

Returns the input string after substituting its token characters by their values in a given range.

This method does not change the current selection.

tip

This method can be used to quickly extract specific parts of a range name, such as the sheet name or first cell column and row, and use them to compose a new range address.


Syntaks:

svc.Printf(inputstr: str, range: str, tokencharacter: str = "%"): str

Parametrar:

inputstr: The string containing the tokens that will be replaced by the corresponding values in range.

range: A RangeName from which values will be extracted. If it contains a sheet name, the sheet must exist.

tokencharacter: Character used to identify tokens. By default "%" is the token character. The following tokens are accepted:

Eksempel:

I Basic

The example below extracts each element of the RangeName defined in sRange and uses them to compose a message.


    Dim sRange as String, sInputStr as String
    sRange = "Sheet1.A1:E10"
    sInputStr = "Sheet name: %S" & Chr(10) & _
                "First row: %R1" & Chr(10) & _
                "First column %C1" & Chr(10) & _
                "Last row %R2" & Chr(10) & _
                "Last column %C2"
    MsgBox oDoc.Printf(sInputStr, sRange)
  

The Printf method can be combined with SetFormula to create formulas over multiple cells. For instance, consider a table with numeric values in the range "A1:E10" from which formulas are to be created to sum the values in each row and place the results in the range "F1:F10":


    Dim sFormula as String, sRange as String
    sRange = "A1:E10"
    ' Note the use of the "$" character
    sFormula = "=SUM($%C1%R1:$%C2%R1)"
    oDoc.SetFormula("F1:F10", oDoc.Printf(sFormula, sRange))
  
I Python

    sRange = "Sheet1.A1:E10"
    sInputStr = "Sheet name: %S\n" \
                "First row: %R1\n" \
                "First column %C1\n" \
                "Last row %R2\n" \
                "Last column %C2"
    bas = CreateScriptService("Basic")
    bas.MsgBox(myDoc.Printf(sInputStr, sRange))
  

    sRange = "A1:E10
    sFormula = "=SUM($%C1%R1:$%C2%R1)"
    myDoc.SetFormula("F1:F10", myDoc.Printf(sFormula, sRange))
  

PrintOut

Denne metoden sender innhaldet i det gjevne arket til standardskrivaren eller til den skrivaren som er definert av metoden SetPrinter i tenesta Document.

Returnerer Sann viss dokumentet vart skrive ut.

Syntaks:

svc.PrintOut(opt sheetname: str, pages: str = "", copies: num = 1): bool

Parametrar:

arknamn: Arket som skal skrivast ut. Standard der det gjeldande arket.

sider: Sidene som skal skrivast ut som ein streng, som i brukargrensesnittet. Eksempel: «1-4;10;15-18». Standard er alle sidene.

kopiar: Talet på kopiar. Standard er 1.

Eksempel:

I Basic

    If oDoc.PrintOut("SheetX", "1-4;10;15-18", Copies := 2) Then
        ' ...
    End If
  
I Python

    if doc.PrintOut('SheetX', copies=3, pages='45-88'):
        # ...
  

RemoveSheet

Fjernar eit ark frå dokumentet.

Syntaks:

svc.RemoveSheet(sheetname: str): bool

Parametrar:

arknamn: Namnet på arket som skal fjernast.

Eksempel:

I Basic

    oDoc.RemoveSheet("SheetY")
  
I Python

    myDoc.RemoveSheet("SheetY")
  

RenameSheet

Gjev det gjevne arket eit nytt namn og returnerer Sann viss dette lukkast.

Syntaks:

svc.RenameSheet(sheetname: str, newname: str): bool

Parametrar:

arknamn: Namnet på arket som skal gjevast nytt namn.

nyttnamn: Det nye arknamnet. Namnet må ikkje finnast frå før.

Eksempel:

I dette eksempelet endrar du namnet på det aktive arket til «ArkY»:

I Basic

    oDoc.RenameSheet("~", "SheetY")
  
I Python

    mydoc.RenameSheet("~", "SheetY")
  

SetArray

Lagrar den gjevne verdien frå ei oppgjeve målcelle. Det oppdaterte området utvidar seg frå målcella eller frå øvre, venstre hjørne i det gjevne området for å få plass til storleiken på inndataargumentet value. Vektorar vert alltid utvida loddrett.

Metoden returnerer ein streng som representerer det endra området som eit celleområde.

Syntaks:

svc.SetArray(targetcell: str, value: any): str

Parametrar:

målcelle: Cella eller eit område som ein streng der lagringa av den gjevne verdien skal byrja.

verdi: Ein skalar, ein vektor eller ei matrise (i Python, ein- eller todimensjonale lister og tuppler) med dei nye verdiane som skal lagrast frå målcella, eller frå øvre, venstre hjørne av området viss målcella er eit område. Dei nye verdiane må vera strengar, talverdiar eller datoar. Andre typar vil føra til at dei tilsvarande cellene vert tømde.

Eksempel:

I Basic

Det meste eksempelet brukar den innebygde funksjonen DimArray for å laga ei matrise og lagra ho i cella «A1».


    Dim arrData as Variant
    arrData = DimArray(2, 1)
    arrData(0, 0) = 1 : arrData(1, 0) = 2 : arrData(2, 0) = 3
    arrData(0, 1) = "One" : arrData(1, 1) = "Two" : arrData(2, 1) = "Three"
    oDoc.SetArray("Sheet1.A1", arrData)
  

Dette eksempelet brukar metoden RangeInit frå ScriptForge Array service for å laga ei matrise med verdiar som vert lagra frå cella «A1» og nedover.


    ' Fyll første kolonne med verdiar frå 1 til 1000
    oDoc.SetArray("Sheet1.A1", SF_Array.RangeInit(1, 1000))
  
I Python

    arrData = ((1, "One"), (2, "Two"), (3, "Three"))
    myDoc.SetArray("Sheet1.A1", arrData)
  

    myDoc.SetArray("Sheet1.A1", tuple(i + 1 for i in range(1000)))
  
tip

Viss du vil dumpa heile innhaldet i ei matrise i eit ark, brukar du SetArray. Viss du vil dumpa innhaldet i ei matrise berre innanfor grensene for det gjevne celleområdet, brukar du SetValue.


SetValue

Lagrar den gjevne verdien i det spesifiserte området. Storleiken på det endra området er lik storleiken på målområdet.

Metoden returnerer ein streng som representerer det endra området som eit celleområde.

Syntaks:

svc.SetValue(targetrange: str, value: any): str

Parametrar:

målområde: Området som verdiane vert henta frå skal lagrast, som ein streng.

verdi: Ein skalar, ein vektor eller ei matrise med dei nye verdiane for kvar celle i området. Dei nye verdiane må vera strengar, talverdiar eller datoar. Andre typar vil føra til at dei tilsvarande cellene vert tømde.

Heile området vert oppdatert medan resten av arket ikkje vert endra. Viss storleiken på verdi er mindre enn storleiken på målområdet vert dei resterande cellene tømde.

Viss storleiken av verdi er større enn storleiken på målområdet, vert verdi berre delvis kopiert til storleiken på målområdet er fylt opp.

Vektorar vert alltid utvida loddrett unnateke viss målområdet er nøyaktig 1 rad høgt.

Eksempel:

I Basic

    oDoc.SetValue("A1", 2)
    ' Nedanfor er verdi-matrisa mindre enn målområdet (resterande celler vert tømde)
    oDoc.SetValue("A1:F1", Array(1, 2, 3))
    ' Nedanfor har verdien og målområdet same storleiken
    oDoc.SetValue("A1:D2", SF_Array.AppendRow(Array(1, 2, 3, 4), Array(5, 6, 7, 8)))
  

Ønskjer du å fylla ei enkelt rad med verdiar, kan du bruka funksjonen Offset. I eksempelet nedanfor bør du gå ut frå at arrData er ei eindimensjonal matrise:


    Dim firstCell As String : firstCell = "A1"
    Dim lenArray As Integer : lenArray = UBound(arrData) - LBound(arrData) + 1
    Dim newRange As String : newRange = oDoc.Offset(firstCell, width = lenArray)
    oDoc.SetValue(newRange, arrData)
  
I Python

    myDoc.SetValue("A1", 2)
    myDoc.SetValue("A1:F1", (1, 2, 3))
    myDoc.SetValue("A1:D2", ((1, 2, 3, 4), (5, 6, 7, 8)))
  

    firstCell = "A1"
    newRange = doc.Offset(firstCell, width = len(arrData))
    doc.SetValue(newRange, arrData)
  

SetCellStyle

Bruker den gjevne cellestilen på det gjevne målområdet. Heile området vert oppdatert, og resten av arket vert ståande urørt. Viss cellestilen ikkje finst, oppstår det ein feil.

Metoden returnerer ein streng som representerer det endra området som eit celleområde.

Syntaks:

svc.SetCellStyle(targetrange: str, style: str): str

Parametrar:

målområde: Området som stilen skal brukast på, som ein streng.

stil: Namnet på cellestilen som skal brukast..

Eksempel:

I Basic

    oDoc.SetCellStyle("A1:J1", "Heading 1")
    oDoc.SetCellStyle("A2:J100", "Neutral")
  
I Python

    myDoc.SetCellStyle("A1:J1", "Heading 1")
    myDoc.SetCellStyle("A2:J100", "Neutral")
  

SetFormula

Set inn den gjevne (matrisa av) formelen/formlane i det spesifiserte området. Storleiken på det endra området er lik storleiken på området.

Metoden returnerer ein streng som representerer det endra området som eit celleområde.

Syntaks:

svc.SetFormula(targetrange: str, formula: any): str

Parametrar:

målområde: Området der formlane skal setjast inn, som ein streng.

formel: Ein streng, ein vektor eller ei matrise av strengar med nye formlar til kvar celle i målområdet.

Heile området vert oppdatert medan resten av arket er uendra.

Viss den gjevne formelen er ein streng, vert den unike formelen limt inn langs heile området med justering av dei relative referansane.

Vis storleiken på formel er mindre enn storleiken på målområde, vert dei resterande cellene tømde.

Viss storleiken på formel er større enn storleiken på målområdet, vert formelen berre delvis kopiert til storleiken på målområdet er fylt opp.

Vektorar vert alltid utvida loddrett unnateke viss målområdet er nøyaktig 1 rad høgt.

Eksempel:

I Basic

    oDoc.SetFormula("A1", "=A2")
    ' Vassrett vektor delvis tom
    oDoc.SetFormula("A1:F1", Array("=A2", "=B2", "=C2+10"))
    ' D2 inneheld formelen "=H2"
    oDoc.SetFormula("A1:D2", "=E1")
  
I Python

    myDoc.SetFormula("A1", "=A2")
    myDoc.SetFormula("A1:F1", ("=A2", "=B2", "=C2+10"))
    myDoc.SetFormula("A1:D2", "=E1")
  

ShiftDown

Flytter eit gjeve celleområde nedover ved å setja inn tomme rader. Det gjeldande utvalet vert ikkje påverka.

Depending on the value of the wholerow argument the inserted rows can either span the width of the specified range or span all columns in the row.

This method returns a string representing the new location of the initial range.

note

If the shifted range exceeds the sheet edges, then nothing happens.


Syntaks:

svc.ShiftDown(range: str, wholerow: bool = False, opt rows: int): str

Parametrar:

range: The range above which rows will be inserted, as a string.

wholerow: If set to False (default), then the width of the inserted rows will be the same as the width of the specified range. Otherwise, the inserted row will span all columns in the sheet.

rows: The number of rows to be inserted. The default value is the height of the original range. The number of rows must be a positive number.

Eksempel:

I Basic

    ' Moves the range "A3:D3" down by one row; affects only columns A to D
    oDoc.ShiftDown("A3:D3")
    ' The inserted row spans all columns in the sheet
    oDoc.ShiftDown("A3:D3", WholeRow := True)
    ' Flytter området "A3:D3" fem rader ned
    oDoc.ShiftDown("A3:D3", Rows := 5)
    ' Flytter området "A3:D10" ned med to rader og viser den nye plasseringa til det opphavlege området
    Dim sNewRange as String
    sNewRange = oDoc.ShiftDown("A3:D10", Rows := 2)
    MsgBox sNewRange   ' $Sheet1.$A$5:$D$12
  
I Python

    myDoc.ShiftDown("A3:D3")
    myDoc.ShiftDown("A3:D3", wholerow = True)
    myDoc.ShiftDown("A3:D3", rows = 5)
    sNewRange = myDoc.ShiftDown("A3:D10", rows = 2)
    bas = CreateScriptService("Basic")
    bas.MsgBox(sNewRange)
  

ShiftLeft

Slettar kolonnane lengst til venstre i eit gjeve område og flytter alle cellene til venstre for det påverka området til høgre for det. Den gjeldande markeringa vert ikkje påverka.

Depending on the value of the wholecolumn argument the deleted columns can either span the height of the specified range or span all rows in the column.

Denne metoden returnerer ein streng som representerer plasseringa av resten av startområdet. Viss alle cellene i det opphavlege området er sletta, vert det returnert ein tom streng.

Syntaks:

svc.ShiftLeft(range: str, wholecolumn: bool = False, opt columns: int): str

Parametrar:

område: Området som cellene skal slettast i, som ein streng.

wholecolumn: Viss sett til Usann (standard) vil høgda på dei sletta kolonnane vera den same som høgda i det spesifiserte range. Elles vil dei sletta kolonnane spenna over alle radene i arket.

columns: Talet på kolonnar som skal slettast frå det gjevne området. Standardverdien er breidda på det opphavlege range, som også er maksimumsverdien for dette argumentet.

Eksempel:

I Basic

    ' Slettar området "B3:B6"; flyttar alle dei gjenverande cellene mod høgre
    oDoc.ShiftLeft("B3:B6")
    ' Slettar den første kolonnen i området "A3:D6"
    oDoc.ShiftLeft("A3:D6", Columns := 1)
    ' Dei sletta kolonnane (A til D) spenner over alle radene på arket
    oDoc.ShiftLeft("A3:D6", WholeColumn := True)
  
I Python

    myDoc.ShiftLeft("B3:B6")
    myDoc.ShiftLeft("A3:D6", Columns = 1)
    myDoc.ShiftLeft("A3:D6", WholeColumn = True)
  

ShiftUp

Slettar dei øvste rekkjene i eit gjeve område og flytter alle cellene under det påverka området oppover. Den gjeldande markeringa vert ikkje påverka.

Depending on the value of the wholerow argument the deleted rows can either span the width of the specified range or span all columns in the row.

Denne metoden returnerer ein streng som representerer plasseringa av resten av startområdet. Viss alle cellene i det opphavlege området er sletta, vert det returnert ein tom streng.

Syntaks:

svc.ShiftUp(range: str, wholerow: bool = False, opt rows: int): str

Parametrar:

område: Området som cellene skal slettast i, som ein streng.

wholerow: Viss sett til Usann (standard) vil breidda på dei sletta radene vera den same som breidda i det spesifiserte range. Elles vil dei sletta radene spenna over alle kolonnane i arket.

rader: Talet på rader som skal slettast frå det gjevne området. Standardverdien er høgda på det opphavlege range, som også er maksimumsverdien for dette argumentet.

Eksempel:

I Basic

    ' Slettar området "A3:D3"; flytter alle celler nedanfor ei rad opp
    oDoc.ShiftUp("A3:D3")
    ' Slettar den første rada i området "A3:D6"
    oDoc.ShiftUp("A3:D6", Rows := 1)
    ' Dei sletta radene spenner over alle kolonnane i arket
    oDoc.ShiftUp("A3:D6", WholeRow := True)
  
I Python

    myDoc.ShiftUp("A3:D3")
    myDoc.ShiftUp("A3:D6", rows = 1)
    myDoc.ShiftUp("A3:D6", wholerow = True)
  

ShiftRight

Flytter eit gjeve celleområde mot høgre ved å setja inn tomme kolonnar. Det gjeldande utvalet vert ikkje påverka.

Depending on the value of the wholecolumn argument the inserted columns can either span the height of the specified range or span all rows in the column.

Denne metoden returnerer ein streng som representerer den nye plasseringa av det opphavlege området.

note

Viss det flytta området går over kantane på arket, skjer det ingenting.


Syntaks:

svc.ShiftRight(range: str, wholecolumn: bool = False, opt columns: int): str

Parametrar:

område: Det området som får sett inn tomme kolonnar på venstre side, som ein streng.

wholecolumn: Viss sett til Usann (standard) vil høgda på dei innsette kolonnane vera den same som høgda i det spesifiserte range. Elles vil dei sletta kolonnane spenna over alle radene i arket.

Kolonnar: Talet på kolonnar som skal setjast inn. Standardverdien er breidda på det opphavlege range (område).

Eksempel:

I Basic

    ' Flyttar området "A3:A6" ein kolonne til høgre. Påverkar berre radene 3 til 6
    oDoc.ShiftRight("A3:A6")
    ' Flyttar området "A3:A6" fem kolonnar til høgre
    oDoc.ShiftRight("A3:A6", Columns := 5)
    ' Den innsette kolonna spenner over alle radene på arket
    oDoc.ShiftRight("A3:A6", WholeColumn := True)
  
I Python

    myDoc.ShiftRight("A3:A6")
    myDoc.ShiftRight("A3:A6", columns = 5)
    myDoc.ShiftRight("A3:A6", wholecolumn = True)
  

SortRange

Sorterer det gjevne området basert på opptil tre kolonnar/rader. Sorteringsrekkjefølgja kan variera etter kolonne/rad. Det vert returnert ein streng som representerer det endra celleområdet. Storleiken på det endra området vert fullt ut bestemt av storleiken på kjeldeområdet.

Syntaks:

svc.SortRange(range: str, sortkeys: any, sortorder: any = "ASC", destinationcell: str = "", containsheader: bool = False, casesensitive: bool = False, sortcolumns: bool = False): str

Parametrar:

område: Området som skal sorterast, som ein streng.

sorteringsnøklar: Ein skalar (viss 1 kolonne/rad) eller ei matrise av kolonnar/rader som byrjar frå 1. Det høgste talet på nøklar er 3.

sorteringsrekkjefølgje: Ein skalar eller ei matrise med strengar som inneheld verdiane ASC (stigande), DESC (synkande) eller "" (som normalt er stigande). Kvart element er bunde saman med det tilsvarande elementet i sorteringsnøklar. Viss sorteringsrekkjefølgje-matrisa er kortare enn sorteringsnøklar, vert dei resterande nøklane sorterte stigande.

målcelle: Målcella for det sorterte celleområdet, som ein streng. Viss det er gjeve eit område, vert berre cella øvst til venstre rekna med. Kjeldeområdet vert som standard overskrive.

inneheld_overskrift: Når Sann, vert den første rada/kolonnen ikkje sortert.

Store/små : (Skil store og små bokstavar). Berre for samanlikning av strengar. Standard = Usann.

sorter_kolonnar: Når Sann vert kolonnane sorterte frå venstre mot høgre. Standard =Usann : rader vert sorterte ovanfrå og nedover.

Eksempel:

I Basic

    ' Sorteringsområdet basert på kolonnar. A (stigande) og C (fallande)
    oDoc.SortRange("A2:J200", Array(1, 3), Array("ASC", "DESC"), CaseSensitive := True)
  
I Python

    myDoc.SortRange("A2:J200", (1, 3), ("ASC", "DESC"), casesensitive = True)
  
warning

Alle ScriptForge Basic-rutinane og -identifikatorane som vert innleidde med understrek «_» er reserverte for internt bruk. Dei er ikkje meint brukte i Basic-makroar.