Pomoč LibreOffice 24.8
Storitev ToolbarButton omogoča pridobivanje informacij, ki se nanašajo na gumbe orodne vrstice, ki so na voljo v dani orodni vrstici. Ta storitev omogoča:
Preklopite vidljivost elementov orodne vrstice.
Izvede ukaz, povezan z danim gumbom orodne vrstice.
Pred uporabo storitve ToolbarButton je potrebno naložiti ali uvoziti knjižnico ScriptForge:
Storitev ToolbarButton prikličete z uporabo metode ToolbarButtons iz storitve Toolbar.
Spodnji primer pridobi imena vseh gumbov, ki so na voljo v orodni vrstici .
    oDoc = CreateScriptService("Document", ThisComponent)
    oToolbar = oDoc.Toolbars("standardbar")
    arrToolbarButtons = oToolbar.ToolbarButtons()
    MsgBox SF_String.Represent(arrToolbarButtons)
  Uporabite metodo ToolbarButtons brez argumentov za pridobivanje polja z imeni vseh razpoložljivih gumbov orodnih vrstic.
Spodnji primer preklopi vidnost gumba v orodni vrstici :
    oDoc = CreateScriptService("Document", ThisComponent)
    oToolbar = oDoc.Toolbars("standardbar")
    oToolbarButton = oToolbar.ToolbarButtons("Print")
    oToolbarButton.Visible = Not oToolbarButton.Visible
  Ime gumba, podano kot argument metodi ToolbarButtons, je lokalizirano ime gumba, določenega v pogovornem oknu .
Nedejavne orodne vrstice nimajo gumbov. Zato klic metode ToolbarButtons povzroči, da je orodna vrstica vidna.
    bas = CreateScriptService("Basic")
    doc = CreateScriptService("Document", bas.ThisComponent)
    toolbar = doc.Toolbars("standardbar")
    arr_toolbar_buttons = toolbar.ToolbarButtons()
    bas.MsgBox(repr(arr_toolbar_buttons))
  
    bas = CreateScriptService("Basic")
    doc = CreateScriptService("Document", bas.ThisComponent)
    toolbar = doc.Toolbars("standardbar")
    toolbar_button = toolbar.ToolbarButtons("Print")
    toolbar_button.Visible = not toolbar_button.Visible
  | Ime | Samo za branje | Vrsta | Opis | 
|---|---|---|---|
| Caption | Da | String | Vrne ime gumba. | 
| Height | Da | Long | Vrne višino gumba v slikovnih točkah. | 
| Index | Da | Long | Vrne indeks gumba v njegovi nadrejeni orodni vrstici. | 
| OnClick | Ne | String | Ukaz UNO ali skript, ki se izvede ob pritisku gumba. Če želite izvedeti več o določanju nizov URI, si preberite stran wiki specifikacije URI ogrodja za skriptanje (v angl.). | 
| Parent | Da | Storitev | Vrne instanco storitve Toolbar, ki ustreza nadrejeni orodni vrstici trenutnega gumba orodne vrstice. | 
| TipText | Ne | String | Namig oz. besedilo pomoči, ki se prikaže, če z miško postanete nad gumbom orodne vrstice. | 
| Visible | Ne | Boolean | Določa, ali je gumb orodne vrstice viden ali ne. | 
| Width | Da | Long | Vrne širino gumba v slikovnih točkah. | 
| X | Da | Long | Vrne (vodoravno) koordinato X levega vrhnjega kota gumba v slikovnih točkah. | 
| Y | Da | Long | Vrne (navpično) koordinato Y levega vrhnjega kota gumba v slikovnih točkah. | 
Pogost primer rabe zgoraj opisanih lastnosti X in Y je pri odpiranju pojavnega menija na položaju, kjer se nahaja gumb orodne vrstice.
Recimo, da ustvarite spodnji skript in ga povežete z gumbom z imenom »Moj gumb« v standardbar (vrstici Standardno). Ko ga kliknete, se prikaže pojavni meni s tremi možnostmi, med katerimi lahko uporabnik izbira.
    Sub OpenPopupMenu()
        GlobalScope.BasicLibraries.LoadLibrary("ScriptForge")
        oDoc = CreateScriptService("Document", ThisComponent)
        oToolbar = oDoc.Toolbars("standardbar")
        oButton = oToolbar.ToolbarButtons("Moj gumb")
        oPopup = CreateScriptService("SFWidgets.PopupMenu", , oButton.X, oButton.Y + oButton.Height)
        oPopup.AddItem("Element A", "A")
        oPopup.AddItem("Element B", "B")
        oPopup.AddItem("Element C", "C")
        strResponse = oPopup.Execute(False)
        MsgBox "Vaš izbor: " & strResponse
    End Sub
  
    def open_popup_menu(args=None):
        bas = CreateScriptService("Basic")
        doc = CreateScriptService("Document", bas.ThisComponent)
        toolbar = doc.Toolbars("standardbar")
        toolbutton = toolbar.ToolbarButtons("Moj gumb")
        popup = CreateScriptService("PopupMenu", None, toolbutton.X, toolbutton.Y + toolbutton.Height)
        popup.AddItem("Element A", "A")
        popup.AddItem("Element B", "B")
        popup.AddItem("Element C", "C")
        response = popup.Execute(False)
        bas.MsgBox(f"Vaš izbor: {response}")
  | Seznam metod v storitvi ToolbarButton | ||
|---|---|---|
| 
 | 
 | |
Izvede ukaz ali skript, povezan z gumbom orodne vrstice.
Ta metoda vrne vrednost, ki jo vrne izvedeni ukaz ali skript.
Uporabite lastnost OnClick za določanje ukaza ali skripta, ki naj se izvrši. Če ukaz/skript ne vrne nobene vrednosti, je vrnjena vrednost Null.
svc.Execute(): any
Spodnji primer izvede gumb iz orodne vrstice :
      oDoc = CreateScriptService("Document", ThisComponent)
      oToolbar = oDoc.Toolbars("standardbar")
      oToolbarButton = oToolbar.ToolbarButtons("Print")
      oToolbarButton.Execute()
    
      bas = CreateScriptService("Basic")
    doc = CreateScriptService("Document", bas.ThisComponent)
    toolbar = doc.Toolbars("standardbar")
    toolbar_button = toolbar.ToolbarButtons("Print")
    toolbar_button.Execute()