LibreOffice 25.8 Hjælp
ToolbarButton-tjenesten giver mulighed for at hente information relateret til de værktøjslinjeknapper, som er tilgængelige i en given værktøjslinje. Med denne tjeneste er det muligt at:
Skift synligheden af værktøjslinjeelementer.
Udfør kommandoen forbundet med en given knap på værktøjslinjen.
Før du bruger ToolbarButton-tjenesten skal ScriptForge-biblioteket være indlæst eller importeret:
Tjenesten ToolbarButton kaldes med metoden ToolbarButtons fra Toolbar-tjenesten.
Eksemplet herunder henter navnene på alle tilgængelige knapper i -værktøjslinjen.
    oDoc = CreateScriptService("Document", ThisComponent)
    oToolbar = oDoc.Toolbars("standardbar")
    arrToolbarButtons = oToolbar.ToolbarButtons()
    MsgBox SF_String.Represent(arrToolbarButtons)
  Brug metoden ToolbarButtons uden argumenter for at hente et array med navne på alle tilgængelige knapper.
Eksemplet nedenfor skifter mellem synlighed eller ej af -knappen i -værktøjslinjen.
    oDoc = CreateScriptService("Document", ThisComponent)
    oToolbar = oDoc.Toolbars("standardbar")
    oToolbarButton = oToolbar.ToolbarButtons("Udskriv")
    oToolbarButton.Visible = Not oToolbarButton.Visible
  Knapnavnet, der blev sendt som argument til ToolbarButtons-metoden er det lokaliserede (oversatte) knapnavn defineret i -dialogen.
Inaktive værktøjslinjer har ikke knapper. Derfor vil kald af ToolbarButtons-metoden gøre værktøjslinjen synlig.
    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("Udskriv")
    toolbar_button.Visible = not toolbar_button.Visible
  | Navn | Skrivebeskyttet | Type | Beskrivelse | 
|---|---|---|---|
| Caption | Ja | String | Returnerer navnet på knappen. | 
| Height | Ja | Long | Returnerer knappens højde i pixels. | 
| Index | Ja | Long | Returnerer indekset for knappen i dens overordnede værktøjslinje. | 
| OnClick | Nej | String | UNO-kommandoen eller UNO-scriptet udføres, når knappen trykkes. Læs wikisiden Scripting Framework URI Specification for at lære mere om, hvordan du definerer en URI-streng (Uniform Ressource Identifier). | 
| Parent | Ja | Tjenesten Toolbar | Returnerer en instans af Toolbar-tjenesten, som svarer til den overordnede værktøjslinje for den aktuelle værktøjslinjeknap. | 
| TipText | Nej | String | Specificerer værktøjstippet, der vises når brugeren holder musemarkøren over værktøjsknappen. | 
| Visible | Nej | Boolean | Angiver, om knappen på værktøjslinjen er synlig eller ej. | 
| Width | Ja | Long | Returnerer knappens bredde i pixels. | 
| X | Ja | Long | Returnerer X-koordinaten (vandret) for knappens øverste venstre hjørne i pixels. | 
| Y | Ja | Long | Returnerer Y-koordinaten (lodret) for knappens øverste venstre hjørne i pixels. | 
En hyppig brug af egenskaberne X og Y beskrevet ovenfor er at åbne en popup-menu på det sted, hvor værktøjslinjeknappen er placeret.
Antag at du opretter scriptet nedenfor og knytter det til en knap med navnet "Min knap" i standardlinjen. Når der klikkes på knappen, vises en menu med 3 muligheder, som brugeren kan vælge imellem.
    Sub OpenPopupMenu()
        GlobalScope.BasicLibraries.LoadLibrary("ScriptForge")
        oDoc = CreateScriptService("Document", ThisComponent)
        oToolbar = oDoc.Toolbars("standardbar")
        oButton = oToolbar.ToolbarButtons("Min knap")
        oPopup = CreateScriptService("SFWidgets.PopupMenu", , oButton.X, oButton.Y + oButton.Height)
        oPopup.AddItem("Mulighed A", "A")
        oPopup.AddItem("Mulighed B", "B")
        oPopup.AddItem("Mulighed C", "C")
        strResponse = oPopup.Execute(False)
        MsgBox "Dit valg: " & strResponse
    End Sub
  
    def open_popup_menu(args=None):
        bas = CreateScriptService("Basic")
        doc = CreateScriptService("Document", bas.ThisComponent)
        toolbar = doc.Toolbars("standardbar")
        toolbutton = toolbar.ToolbarButtons("Min knap")
        popup = CreateScriptService("PopupMenu", None, toolbutton.X, toolbutton.Y + toolbutton.Height)
        popup.AddItem("Mulighed A", "A")
        popup.AddItem("Mulighed B", "B")
        popup.AddItem("Mulighed C", "C")
        response = popup.Execute(False)
        bas.MsgBox(f"Dit valg: {response}")
  | Liste over metoder i tjenesten ToolbarButton | ||
|---|---|---|
| 
 | 
 | |
Udfører kommandoen eller scriptet, der er knyttet til knappen på værktøjslinjen.
Denne metode returnerer den værdi, der returneres af den udførte kommando eller script.
Brug egenskaben OnClick (ved_klik) til at fastlægge den kommando eller det script, som skal udføres. Hvis kommandoen/scriptet ikke returnerer nogen værdi, så returneres Null.
svc.Execute(): any
Eksemplet herunder udfører -knappen fra -værktøjslinjen:
      oDoc = CreateScriptService("Document", ThisComponent)
      oToolbar = oDoc.Toolbars("standardbar")
      oToolbarButton = oToolbar.ToolbarButtons("Udskriv")
      oToolbarButton.Execute()
    
      bas = CreateScriptService("Basic")
    doc = CreateScriptService("Document", bas.ThisComponent)
    toolbar = doc.Toolbars("standardbar")
    toolbar_button = toolbar.ToolbarButtons("Udskriv")
    toolbar_button.Execute()