Υπηρεσία SFWidgets.Toolbar

Η υπηρεσία Toolbar επιτρέπει την ανάκτηση πληροφοριών που σχετίζονται με τις γραμμές εργαλείων που είναι διαθέσιμες για ένα συγκεκριμένο παράθυρο εγγράφου. Με αυτήν την υπηρεσία είναι δυνατά τα παρακάτω:

Εναλλαγή της ορατότητας συγκεκριμένων γραμμών εργαλείων.
Πρόσβαση σε πληροφορίες σχετικά με τα πλήκτρα που είναι διαθέσιμα σε κάθε γραμμή εργαλείων.

Κάθε εφαρμογή του LibreOffice έχει το δικό της σύνολο διαθέσιμων γραμμών εργαλείων. Αυτή η υπηρεσία χειρίζεται τόσο τις ενσωματωμένες όσο και τις προσαρμοσμένες γραμμές εργαλείων.

Η γραμμή κατάστασης και η γραμμή μενού δεν θεωρούνται γραμμές εργαλείων στο πλαίσιο αυτής της υπηρεσίας.

Κλήση υπηρεσίας

Πριν χρησιμοποιήσετε την υπηρεσία Toolbar, πρέπει να φορτωθεί ή να εισαχθεί η βιβλιοθήκη ScriptForge:

• Οι μακροεντολές Basic απαιτούν τη φόρτωση της βιβλιοθήκης ScriptForge χρησιμοποιώντας την ακόλουθη πρόταση:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• Τα σενάρια Python απαιτούν εισαγωγή από την ενότητα scriptforge:
από το scriptforge import CreateScriptService

Η υπηρεσία Toolbar καλείται χρησιμοποιώντας τη μέθοδο Toolbars, η οποία είναι διαθέσιμη στην υπηρεσία SFDocuments.Document.

Σε Basic

Το παρακάτω παράδειγμα λαμβάνει ένα Array με τα ονόματα των γραμμών εργαλείων που είναι διαθέσιμες στο τρέχον έγγραφο.


    oDoc = CreateScriptService("Document", ThisComponent)
    arrToolbars = oDoc.Toolbars()
    MsgBox SF_String.Represent(arrToolbars)

Χρησιμοποιήστε τη μέθοδο Toolbars χωρίς ορίσματα για να ανακτήσετε έναν πίνακα με διαθέσιμα ονόματα γραμμών εργαλείων.

Το παρακάτω παράδειγμα αλλάζει την ορατότητα της γραμμής εργαλείων Standard:


    oDoc = CreateScriptService("Document", ThisComponent)
    toolbar = oDoc.Toolbars("standardbar")
    toolbar.Visible = Not toolbar.Visible

Σε Python


    bas = CreateScriptService("Basic")
    doc = CreateScriptService("Document", bas.ThisComponent)
    arr_toolbars = doc.Toolbars()
    bas.MsgBox(repr(toolbars))


    bas = CreateScriptService("Basic")
    doc = CreateScriptService("Document", bas.ThisComponent)
    toolbar = doc.Toolbars("standardbar")
    toolbar.Visible = not toolbar.Visible

Ιδιότητες

Όνομα	Μόνο για ανάγνωση	Τύπος	Περιγραφή
BuiltIn	Ναι	Boolean	Επιστρέφει True όταν η γραμμή εργαλείων είναι μέρος του συνόλου των τυπικών γραμμών εργαλείων που αποστέλλονται με το LibreOffice.
Docked	Ναι	Boolean	Επιστρέφει True, όταν η γραμμή εργαλείων είναι ενεργή στο παράθυρο και προσαρτημένη.
HasGlobalScope	Ναι	Boolean	Επιστρέφει True, όταν η γραμμή εργαλείων είναι διαθέσιμη σε όλα τα έγγραφα του ίδιου τύπου.
Name	Ναι	String	Επιστρέφει το όνομα της γραμμής εργαλείων.
ResourceURL	Ναι	String	Επιστρέφει τη διεύθυνση URL του πόρου της γραμμής εργαλείων, με τη μορφή private:toolbar/toolbar_name.
Visible	Όχι	Boolean	Επιστρέφει True, όταν η γραμμή εργαλείων είναι ενεργή και ορατή στο παράθυρο του εγγράφου.
XUIElement	Ναι	UNO Object	Επιστρέφει το αντικείμενο UNO com.sun.star.ui.XUIElement που αντιπροσωπεύει τη γραμμή εργαλείων.

Κατάλογος μεθόδων στην υπηρεσία Toolbar
ToolbarButtons

ToolbarButtons

Επιστρέφει ένα Array που περιέχει τα ονόματα όλων των πλήκτρων της γραμμής εργαλείων όταν καλείται χωρίς ορίσματα.

Δώστε το όνομα ενός πλήκτρου της γραμμής εργαλείων ως όρισμα για να αποκτήσετε μια παρουσία υπηρεσίας ToolbarButton.

Σύνταξη:

svc.ToolbarButtons(opt buttonname: str): any

Παράμετροι:

buttonname: Το όνομα ενός πλήκτρου της γραμμής εργαλείων στην τρέχουσα γραμμή εργαλείων.

Παράδειγμα:

Το παρακάτω παράδειγμα επιστρέφει την εντολή που εκτελείται όταν πατιέται το πλήκτρο Νέο στη γραμμή εργαλείων Τυπική:

Σε Basic


      oToolbar = oDoc.Toolbars("standardbar")
      oToolbarButton = oToolbar.ToolbarButtons("New")
      MsgBox oToolbarButton.OnClick

Σε Python


      toolbar = doc.Toolbars("standardbar")
      toolbar_button = toolbar.ToolbarButtons("New")
      bas.MsgBox(toolbar_button.OnClick)

Οι ανενεργές γραμμές εργαλείων δεν έχουν πλήκτρα. Επομένως, η κλήση της μεθόδου ToolbarButtons θα κάνει τη γραμμή εργαλείων ορατή.

Όλες οι ρουτίνες ή αναγνωριστικά του ScriptForge στη Basic που έχουν το πρόθεμα χαρακτήρα υπογράμμισης "_" δεσμεύονται για εσωτερική χρήση. Δεν προορίζονται να χρησιμοποιηθούν σε μακροεντολές Basic ή σενάρια Python.

Υπηρεσία SFWidgets.ToolbarButton