Tulong sa LibreOffice 25.8
Ang Mga SFDocuments Ang shared library ay nagbibigay ng ilang pamamaraan at katangian upang mapadali ang pamamahala at pangangasiwa ng mga dokumento ng LibreOffice.
Ang ilang mga pamamaraan ay generic para sa lahat ng uri ng mga dokumento at minana mula sa SF_Document module, samantalang ang iba pang mga pamamaraan na partikular para sa mga dokumento ng Writer ay tinukoy sa SF_Writer modyul.
Bago gamitin ang Manunulat serbisyo ang ScriptForge kailangang i-load o i-import ang library:
Ang Manunulat ang serbisyo ay malapit na nauugnay sa UI serbisyo ng ScriptForge aklatan. Nasa ibaba ang ilang halimbawa kung paano ang Manunulat maaaring gamitin ang serbisyo.
Ang code snippet sa ibaba ay lumilikha ng a Manunulat instance ng serbisyo na tumutugma sa kasalukuyang aktibong dokumento ng Writer.
    Dim oDoc As Object
    Set oDoc = CreateScriptService("SFDocuments.Writer", "Untitled 1") ' Default = ActiveWindow
  Ang isa pang paraan upang lumikha ng isang halimbawa ng Manunulat ang serbisyo ay gumagamit ng UI serbisyo. Sa sumusunod na halimbawa, isang bagong dokumento ng Writer ang ginawa at oDoc ay a Manunulat halimbawa ng serbisyo:
    Dim ui As Object, oDoc As Object
    Set ui = CreateScriptService("UI")
    Set oDoc = ui.CreateDocument("Writer")
  O gamit ang OpenDocument pamamaraan mula sa UI serbisyo:
    Set oDoc = ui.OpenDocument("C:\Me\MyFile.odt")
  Posible ring i-instantiate ang Manunulat serbisyo gamit ang CreateScriptService paraan:
    Dim oDoc As Object
    Set oDoc = CreateScriptService("SFDocuments.Writer", "MyFile.odt")
  Sa halimbawa sa itaas, ang "MyFile.odt" ay ang pangalan ng isang bukas na window ng dokumento. Kung hindi ibinigay ang argumentong ito, isasaalang-alang ang aktibong window.
Inirerekomenda na magbakante ng mga mapagkukunan pagkatapos gamitin:
    Set oDoc = oDoc.Dispose()
  Gayunpaman, kung ang dokumento ay isinara gamit ang Isara ang Dokumento paraan, nagiging hindi na kailangan ang mga libreng mapagkukunan gamit ang command na inilarawan sa itaas.
    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()
  Ang paggamit ng prefix na " Mga SFDocuments. " habang ang pagtawag sa serbisyo ay opsyonal.
| Listahan ng mga Paraan sa Serbisyo ng Manunulat | ||
|---|---|---|
Depende sa mga parameter na ibinigay, babalik ang pamamaraang ito:
Isang zero-based Array (o isang tuple sa Python) na may mga pangalan ng lahat ng mga form na nakapaloob sa dokumento (kung ang anyo wala ang argumento)
A SFDocuments.Form instance ng serbisyo na kumakatawan sa form na tinukoy bilang argumento.
svc.Forms(): str[0..*]
svc.Forms(form: str = ''): svc
svc.Forms(form: int): svc
anyo : Ang pangalan o index na naaayon sa isang form na nakaimbak sa dokumento. Kung wala ang argumentong ito, magbabalik ang pamamaraan ng isang listahan na may mga pangalan ng lahat ng mga form na magagamit sa dokumento.
Sa mga sumusunod na halimbawa, nakukuha ng unang linya ang mga pangalan ng lahat ng form sa dokumento at ang pangalawang linya ay kinukuha ang Form object ng form na pinangalanang "Form_A".
    Set FormNames = oDoc.Forms()
    Set FormA = oDoc.Forms("Form_A")
  
    form_names = doc.Forms()
    form_A = doc.Forms("Form_A")
  Ang pamamaraang ito ay naglo-load ng lahat ng mga istilo na kabilang sa isa o higit pang mga pamilya ng istilo mula sa isang saradong file papunta sa aktwal na dokumento. Ang aktwal na dokumento ay dapat na a Calc o a Manunulat dokumento.
Palaging ini-import nang magkasama:
Mga Estilo ng Talata at Mga Estilo ng Karakter
NumberingStyles at ListStyles
Nagbabalik totoo kung matagumpay na na-import ang mga istilo.
svc.ImportStylesFromFile(filename: str, families: str[1..*], overwrite = False): bool
filename : Ang file kung saan ilo-load ang mga istilo sa FileSystem notasyon. Ang file ay ipinapalagay na kapareho ng uri ng dokumento gaya ng aktwal na dokumento.
mga pamilya : Isa sa mga istilong pamilya na nasa aktwal na dokumento, bilang isang case-sensitive na string o isang hanay ng mga naturang string. Iwanang blangko ang argumentong ito para ma-import ang lahat ng pamilya.
overwrite : Kailan totoo , maaaring ma-overwrite ang mga aktwal na istilo. Default ay Mali .
    oDoc.ImportStylesFromFile("C:\User\Documents\myFile.ods", "ParagraphStyles", True)
  
    doc.ImportStylesFromFile('C:\User\Documents\myFile.ods', ("ParagraphStyles",), False)
  Ipadala ang mga nilalaman ng dokumento sa printer. Ang printer ay maaaring dating tinukoy bilang default, ng user o ng SetPrinter paraan ng Dokumento serbisyo. Nagbabalik totoo kapag matagumpay.
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
mga pahina : Ang mga pahinang ipi-print bilang isang string, tulad ng sa user interface. Halimbawa: "1-4;10;15-18". Default = lahat ng pahina
mga kopya : Ang bilang ng mga kopya, ang default ay 1.
printbackground : Ini-print ang larawan sa background kapag totoo (default).
printblankpages : Kailan Mali (default), inalis ang mga walang laman na pahina.
printevenpages : Nagpi-print ng kahit na mga pahina kapag totoo (default).
printoddpages : Mag-print ng mga kakaibang pahina kung kailan totoo (default).
printimages : Mag-print ng mga graphic na bagay kapag totoo (default).
      oDoc.PrintOut("1-4;10;15-18", Copies := 2, PrintImages := False)
  
    doc.PrintOut(printblankpages = True, copies = 3)