SFWidgets.ToolbarButton service

The ToolbarButton service allows to retrieve information related to the toolbar buttons available in a given toolbar. With this service it is possible to:

Toggle the visibility of toolbar elements.
Execute the command associated with a given toolbar button.

Извикване на услугата

Преди да използвате услугата ToolbarButton, библиотеката ScriptForge трябва да бъде заредена или импортирана:

• Макросите на Basic изискват зареждане на библиотеката ScriptForge чрез следния оператор:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• Скриптовете на Python изискват импортиране от модула scriptforge:
from scriptforge import CreateScriptService

The ToolbarButton service is invoked using the ToolbarButtons method from the Toolbar service.

В Basic

The example below retrieves the names of all buttons available in the Standard toolbar.


    oDoc = CreateScriptService("Document", ThisComponent)
    oToolbar = oDoc.Toolbars("standardbar")
    arrToolbarButtons = oToolbar.ToolbarButtons()
    MsgBox SF_String.Represent(arrToolbarButtons)

Use the ToolbarButtons method without arguments to retrieve an array with all available toolbar button names.

The example below toggles the visibility of the Print button in the Standard toolbar:


    oDoc = CreateScriptService("Document", ThisComponent)
    oToolbar = oDoc.Toolbars("standardbar")
    oToolbarButton = oToolbar.ToolbarButtons("Print")
    oToolbarButton.Visible = Not oToolbarButton.Visible

The button name passed as argument to the ToolbarButtons method is the localized button name defined in the Tools - Customize - Toolbars dialog.

Inactive toolbars do not have buttons. Therefore, calling the ToolbarButtons method will make the toolbar visible.

В Python


    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

Свойства

Име	Само за четене	Тип	Описание
Caption	Да	String	Returns the name of the button.
Height	Да	Long	Returns the height of the button, in pixels.
Index	Да	Long	Returns the index of the button in its parent toolbar.
OnClick	Не	String	The UNO command or script executed when the button is pressed. Read the Wiki page Scripting Framework URI Specification to learn more on how to define a URI string.
Parent	Да	Toolbar service	Returns a Toolbar service instance corresponding to the parent toolbar of the current toolbar button.
TipText	Не	String	Specifies the tooltip text shown when the user hovers over the toolbar button.
Visible	Не	Boolean	Specifies whether the toolbar button is visible or not.
Width	Да	Long	Returns the width of the button, in pixels.
X	Да	Long	Returns the X (horizontal) coordinate of the top-left corner of the button, in pixels.
Y	Да	Long	Returns the Y (vertical) coordinate of the top-left corner of the button, in pixels.

Use of ToolbarButton alongside the PopupMenu service

A common use case of the properties X and Y described above is to open a popup menu in the position where the toolbar button is located.

Suppose you create the script below and associate it with a button named "My Button" in the standardbar. When it is clicked, a popup menu will be shown with 3 options for the user to select.

В Basic


    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 "Your choice: " & strResponse
    End Sub

В Python


    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}")

List of Methods in the ToolbarButton Service
Execute

Execute

Executes the command or script associated with the toolbar button.

This method returns the value returned by the command or script executed.

Use the OnClick property to determine the command or script that shall be executed. If the command/script does not return any value, then Null is returned.

Синтаксис:

svc.Execute(): any

Пример:

The example below executes the Print button from the Standard toolbar:

В Basic


      oDoc = CreateScriptService("Document", ThisComponent)
      oToolbar = oDoc.Toolbars("standardbar")
      oToolbarButton = oToolbar.ToolbarButtons("Print")
      oToolbarButton.Execute()

В Python


      bas = CreateScriptService("Basic")
    doc = CreateScriptService("Document", bas.ThisComponent)
    toolbar = doc.Toolbars("standardbar")
    toolbar_button = toolbar.ToolbarButtons("Print")
    toolbar_button.Execute()

В ScriptForge всички подпрограми или идентификатори на Basic с префикс „_“ са запазени за вътрешна употреба. Те не са предназначени за използване в макроси на Basic.

SFWidgets.Toolbar service