LibreOffice 25.2 laguntza
SFDocuments liburutegi partekatuak LibreOffice dokumentuak kudeatu eta maneiatzea errazten duten metodo eta propietateak eskaintzen ditu.
Zenbait metodo dokumentu mota guztietarako generikoak dira eta SF_Document modulutik heredatutakoak dira, eta beste batzuk Writer dokumentuetarako espezifikoak dira eta SF_Writer moduluan definituta daude.
Writer zerbitzua erabiltzeko, ScriptForge liburutegia kargatu edo inportatu behar da:
Writer zerbitzua eta ScriptForge liburutegiaren UI zerbitzua estu lotuta daude. Behean ageri dira Writer zerbitzua deitzeko moduak adierazten dituzten zenbait adibide.
Beheko kode-zatiak uneko Writer dokumentu aktiboari dagokion Writer zerbitzu-instantzia bat sortzen du.
    Dim oDoc As Object
    Set oDoc = CreateScriptService("SFDocuments.Writer", "Untitled 1") ' Default = ActiveWindow
  Writer zerbitzuaren beste instantzia bat sortzeko beste modu bat UI zerbitzua erabiltzea da. Hurrengo adibidean, Writer dokumentu berria sortzen da eta oDoc elementua Writer zerbitzuaren instantzia bat da:
    Dim ui As Object, oDoc As Object
    Set ui = CreateScriptService("UI")
    Set oDoc = ui.CreateDocument("Writer")
  Edo UI zerbitzuaren OpenDocument metodoa erabilita:
    Set oDoc = ui.OpenDocument("C:\Me\MyFile.odt")
  Posible da, baita ere, Writer zerbitzuaren instantzia bat sortzea CreateScriptService metodoa erabilita:
    Dim oDoc As Object
    Set oDoc = CreateScriptService("SFDocuments.Writer", "MyFile.odt")
  Goiko adibidean, "MyFile.odt" dokumentu-leiho ireki baten izena da. Argumentu hori ematen ez bada, leiho aktiboa erabiliko da.
Gomendagarria baliabideak askatzea haiek erabili ondoren:
    Set oDoc = oDoc.Dispose()
  Hala ere, dokumentua CloseDocument metodoa erabilita itxi bada, ez da beharrezkoa baliabideak askatzea goian deskribatutako komandoaren bidez.
    myDoc = CreateScriptService("Writer") ' Default = ActiveWindow
  
    ui = CreateScriptService("UI")
    myDoc = ui.CreateDocument("Writer")
  
    myDoc = ui.OpenDocument(r"C:\Documents\MyFile.odt")
  
    myDoc = CreateScriptService("SFDocuments.Writer", "MyFile.odt")
    myDoc.Dispose()
  Ez da derrigorrezkoa "SFDocuments." aurrizkia erabiltzea zerbitzuari deitzen zaionean.
| Writer zerbitzuaren metodoen zerrenda | ||
|---|---|---|
Erabilitako parametroen arabera, metodo honek honakoa itzuliko du:
Dokumentuak dituen inprimaki guztien izenez osatutako zero oinarriko matrize bat (edo tupla bat Pythonen), form argumenturik ez badago.
Argumentu gisa zehaztu den inprimakia ordezkatzen duen SFDocuments.Form zerbitzu-instantzia bat.
svc.Forms(): str[0..*]
svc.Forms(form: str = ''): svc
svc.Forms(form: int): svc
form: Dokumentuan gordetako inprimaki baten izena edo indizea. Argumentu hori ez badago, metodoak dokumentuan dauden inprimaki guztien izenak dituen zerrenda bat itzuliko du.
Hurrengo adibideetan, lehen lerroak dokumentuko inprimaki guztien izenak eskuratzen ditu eta bigarren lerroak "Form_A" izeneko inprimakiaren Form objektua atzitzen du.
    Set FormNames = oDoc.Forms()
    Set FormA = oDoc.Forms("Form_A")
  
    form_names = doc.Forms()
    form_A = doc.Forms("Form_A")
  This method loads all the styles belonging to one or more style families from a closed file into the actual document. The actual document must be a Calc or a Writer document.
Are always imported together:
ParagraphStyles and CharacterStyles
NumberingStyles and ListStyles
Returns True if styles were successfully imported.
svc.ImportStylesFromFile(filename: str, families: str[1..*], overwrite = False): bool
filename: The file from which to load the styles in the FileSystem notation. The file is presumed to be of the same document type as the actual document.
families: One of the style families present in the actual document, as a case-sensitive string or an array of such strings. Leave this argument blank to import all families.
overwrite: When True, the actual styles may be overwritten. Default is False.
    oDoc.ImportStylesFromFile("C:\User\Documents\myFile.ods", "ParagraphStyles", True)
  
    doc.ImportStylesFromFile('C:\User\Documents\myFile.ods', ("ParagraphStyles",), False)
  Dokumentuaren edukiak inprimagailura bidaltzen ditu. Inprimagailua aurretik definitu daiteke, lehenetsi gisa, Document zerbitzuaren SetPrinter metodoa erabiliz. True itzultzen du ekintza ongi gauzatzen bada.
svc.PrintOut(opt pages: str = "", opt copies: num = 1, opt printbackground: bool = True, opt printblankpages: bool = False, opt printevenpages: bool = True, opt printoddpages: bool = True, opt printimages: bool = True): bool
pages: Inprimatuko diren orrialdeak, kate gisa, erabiltzaile-interfazean bezala. Adibidea: "1-4;10;15-18". Balio lehenetsia orrialde guztiak dira.
copies: Kopia kopurua, balio lehenetsia 1 da.
printbackground: Atzeko planoko irudia inprimatzen du True (balio lehenetsia) denean.
printblankpages: False (balio lehenetsia) denean, hutsik dauden orrialdeak baztertzen ditu.
printevenpages: Orrialde bikoitiak inprimatzen ditu True (balio lehenetsia) denean.
printevenpages: Orrialde bakoitiak inprimatzen ditu True (balio lehenetsia) denean.
printimages: Objektu grafikoak inprimatzen ditu True (balio lehenetsia) denean.
      oDoc.PrintOut("1-4;10;15-18", Copies := 2, PrintImages := False)
  
    doc.PrintOut(printblankpages = True, copies = 3)