SFWidgets . ToolbarButton serbisyo

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.

Panawagan sa serbisyo

Bago gamitin ang ToolbarButton serbisyo ang ScriptForge kailangang i-load o i-import ang library:

• Ang mga pangunahing macro ay kailangang mag-load ScriptForge aklatan gamit ang sumusunod na pahayag:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• Ang mga script ng Python ay nangangailangan ng pag-import mula sa scriptforge module:
mula sa scriptforge import CreateScriptService

Ang ToolbarButton ang serbisyo ay ginagamit gamit ang Mga Pindutan ng Toolbar pamamaraan mula sa Toolbar serbisyo.

Sa Basic

Kinukuha ng halimbawa sa ibaba ang mga pangalan ng lahat ng mga button na available sa Pamantayan 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 Print pindutan sa Pamantayan 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 Mga Tool - I-customize - Mga Toolbar diyalogo.

Ang mga hindi aktibong toolbar ay walang mga pindutan. Samakatuwid, ang pagtawag sa Mga Pindutan ng Toolbar paraan ay gagawing nakikita ang toolbar.

Sa 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

Mga Katangian

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.

Paggamit ng ToolbarButton sa tabi ng PopupMenu serbisyo

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.

Sa 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 "Ang iyong pinili: " & strResponse
    End Sub

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

Listahan ng Mga Paraan sa Serbisyo ng ToolbarButton
Execute

Execute

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.

Syntax:

svc.Execute(): any

Halimbawa:

Ang halimbawa sa ibaba ay nagpapatupad ng Print button mula sa Pamantayan toolbar:

Sa Basic


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

Sa Python


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

Lahat ScriptForge Ang mga pangunahing gawain o identifier na may prefix na may underscore na character na "_" ay nakalaan para sa panloob na paggamit. Ang mga ito ay hindi nilalayong gamitin sa Basic macros o Python script.

SFWidgets . Toolbar serbisyo