Tulong sa LibreOffice 25.8
Ang ToolbarButton nagbibigay-daan ang serbisyo na makuha ang impormasyong nauugnay sa mga pindutan ng toolbar na magagamit sa isang naibigay na toolbar. Sa serbisyong ito, posible na:
I-toggle ang visibility ng mga elemento ng toolbar.
Isagawa ang utos na nauugnay sa isang ibinigay na toolbar na pindutan.
Bago gamitin ang ToolbarButton serbisyo ang ScriptForge kailangang i-load o i-import ang library:
Ang ToolbarButton ang serbisyo ay ginagamit gamit ang Mga Pindutan ng Toolbar pamamaraan mula sa Toolbar serbisyo.
Kinukuha ng halimbawa sa ibaba ang mga pangalan ng lahat ng mga button na available sa toolbar.
    oDoc = CreateScriptService("Document", ThisComponent)
    oToolbar = oDoc.Toolbars("standardbar")
    arrToolbarButtons = oToolbar.ToolbarButtons()
    MsgBox SF_String.Represent(arrToolbarButtons)
  Gamitin ang Mga Pindutan ng Toolbar paraan nang walang mga argumento upang makuha ang isang array na may lahat ng magagamit na mga pangalan ng button ng toolbar.
Ang halimbawa sa ibaba ay nag-toggle sa visibility ng pindutan sa toolbar:
    oDoc = CreateScriptService("Document", ThisComponent)
    oToolbar = oDoc.Toolbars("standardbar")
    oToolbarButton = oToolbar.ToolbarButtons("Print")
    oToolbarButton.Visible = Not oToolbarButton.Visible
  Ang pangalan ng button ay ipinasa bilang argumento sa Mga Pindutan ng Toolbar paraan ay ang naisalokal na pangalan ng button na tinukoy sa diyalogo.
Ang mga hindi aktibong toolbar ay walang mga pindutan. Samakatuwid, ang pagtawag sa Mga Pindutan ng Toolbar paraan ay gagawing nakikita ang toolbar.
    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
  | Pangalan | Readonly | Type | Mga nilalaman | 
|---|---|---|---|
| Caption | Mayroon | String | Ibinabalik ang pangalan ng button. | 
| Height | Mayroon | Long | Ibinabalik ang taas ng button, sa mga pixel. | 
| Index | Mayroon | Long | Ibinabalik ang index ng button sa parent toolbar nito. | 
| OnClick | Hindi | String | Ang UNO command o script ay naisakatuparan kapag pinindot ang button. Basahin ang pahina ng Wiki Pagtutukoy ng URI Framework ng Scripting para matuto pa kung paano tumukoy ng string ng URI. | 
| Parent | Mayroon | Toolbar serbisyo | Nagbabalik a Toolbar instance ng serbisyo na naaayon sa toolbar ng magulang ng kasalukuyang button ng toolbar. | 
| TipText | Hindi | String | Tinutukoy ang teksto ng tooltip na ipinapakita kapag nag-hover ang user sa button ng toolbar. | 
| Visible | Hindi | Boolean | Tinutukoy kung nakikita o hindi ang button ng toolbar. | 
| Width | Mayroon | Long | Ibinabalik ang lapad ng button, sa mga pixel. | 
| X | Mayroon | Long | Ibinabalik ang X (horizontal) coordinate ng kaliwang sulok sa itaas ng button, sa mga pixel. | 
| Y | Mayroon | Long | Ibinabalik ang Y (vertical) coordinate ng kaliwang sulok sa itaas ng button, sa mga pixel. | 
Isang karaniwang kaso ng paggamit ng mga katangian X at Y na inilarawan sa itaas ay upang buksan ang isang popup menu sa posisyon kung saan matatagpuan ang pindutan ng toolbar.
Ipagpalagay na gagawin mo ang script sa ibaba at iugnay ito sa isang button na pinangalanang "My Button" sa standardbar . Kapag na-click ito, ipapakita ang isang popup menu na may 3 mga opsyon para piliin ng user.
    Sub OpenPopupMenu()
        GlobalScope.BasicLibraries.LoadLibrary("ScriptForge")
        oDoc = CreateScriptService("Document", ThisComponent)
        oToolbar = oDoc.Toolbars("standardbar")
        oButton = oToolbar.ToolbarButtons("My Button")
        oPopup = CreateScriptService("SFWidgets.PopupMenu", , oButton.X, oButton.Y + oButton.Height)
        oPopup.AddItem("Item A", "A")
        oPopup.AddItem("Item B", "B")
        oPopup.AddItem("Item C", "C")
        strResponse = oPopup.Execute(False)
        MsgBox "Ang iyong pinili: " & strResponse
    End Sub
  
    def open_popup_menu(args=None):
        bas = CreateScriptService("Basic")
        doc = CreateScriptService("Document", bas.ThisComponent)
        toolbar = doc.Toolbars("standardbar")
        toolbutton = toolbar.ToolbarButtons("My Button")
        popup = CreateScriptService("PopupMenu", None, toolbutton.X, toolbutton.Y + toolbutton.Height)
        popup.AddItem("Item A", "A")
        popup.AddItem("Item B", "B")
        popup.AddItem("Item C", "C")
        response = popup.Execute(False)
        bas.MsgBox(f"Your choice: {response}")
  | Listahan ng Mga Paraan sa Serbisyo ng ToolbarButton | ||
|---|---|---|
| 
 | 
 | |
Isinasagawa ang command o script na nauugnay sa button ng toolbar.
Ibinabalik ng pamamaraang ito ang halaga na ibinalik ng command o script na naisakatuparan.
Gamitin ang OnClick ari-arian upang matukoy ang utos o script na dapat isakatuparan. Kung ang command/script ay hindi nagbabalik ng anumang halaga, kung gayon Null ay ibinalik.
svc.Execute(): any
Ang halimbawa sa ibaba ay nagpapatupad ng button mula sa toolbar:
      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()