Περιεχόμενα

# Υπηρεσία 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