Mga SFDocuments . Manunulat serbisyo

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.

Panawagan sa serbisyo

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

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

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

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

Mga Kahulugan

Mga Katangian

Pamamaraan

Forms

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.

Ang pamamaraang ito ay naaangkop lamang para sa mga dokumento ng Writer. Ang mga dokumento ng Calc at Base ay may sarili Mga porma pamamaraan sa Calc at Base mga serbisyo, ayon sa pagkakabanggit.

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

ImportStylesFromFile

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)
  

PrintOut

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)
  

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