SFDocuments.Writer zerbitzua

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

Some methods are generic for all types of documents and are inherited from the SF_Document module, whereas other methods that are specific for Writer documents are defined in the SF_Writer module.

SF_Writer modulua honakoetarako da:

Zerbitzuari deitzea

The Writer service is closely related to the UI service of the ScriptForge library. Below are a few examples of how the Writer service can be invoked.

Basic lengoaian

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.

Python lengoaian

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

Ez da derrigorrezkoa "SFDocuments." aurrizkia erabiltzea zerbitzuari deitzen zaionean.


Definizioak

Propietateak

Metodoak

Writer zerbitzuaren metodoen zerrenda

Forms

PrintOut

…


Forms

Erabilitako parametroen arabera, metodo honek honakoa itzuliko du:

note

This method is applicable only for Writer documents. Calc and Base documents have their own Forms method in the Calc and Base services, respectively.


Sintaxia:

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

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

svc.Forms(form: int): svc

Parametroak:

form: Dokumentuan gordetako inprimaki baten izena edo indizea. Argumentu hori ez badago, metodoak dokumentuan dauden inprimaki guztien izenak dituen zerrenda bat itzuliko du.

Adibidea:

In the following examples, the first line gets the names of all forms in the document and the second line retrieves the Form object of the form named "Form_A".

Basic lengoaian

    Set FormNames = oDoc.Forms()
    Set FormA = oDoc.Forms("Form_A")
  
Python lengoaian

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

PrintOut

Send the contents of the document to the printer. The printer may be previously defined by default, by the user or by the SetPrinter method of the Document service. Returns True when successful.

Sintaxia:

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

Parametroak:

pages: The pages to print as a string, like in the user interface. Example: "1-4;10;15-18". Default = all pages

copies: The number of copies, default is 1.

printbackground: Prints the background image when True (default).

printblankpages: When False (default), omits empty pages.

printevenpages: Prints even pages when True (default).

printoddpages: Print odd pages when True (default).

printimages: Print graphic objects when True (default).

Adibidea:

Basic lengoaian

      oDoc.PrintOut("1-4;10;15-18", Copies := 2, PrintImages := False)
  
Python lengoaian

    doc.PrintOut(printblankpages = True, copies = 3)
  
warning

Azpimarraren karaktere bat, "_", aurrizki gisa duten ScriptForge Basic errutina edo identifikatzaile guztiak barneko erabilerarako erreserbatuta daude. Ez dira Basic makroetan edo Python scriptetan erabili behar.