SFWidgets.Verktøylinje tjeneste

Tjenesten Verktøylinje gjør det mulig å hente informasjon relatert til verktøylinjene som er tilgjengelige for et spesifikt dokumentvindu. Med denne tjenesten er det mulig å:

Hver LibreOffice-applikasjon har sitt eget sett med tilgjengelige verktøylinjer. Denne tjenesten håndterer både innebygde og tilpassede verktøylinjer.

note

Statuslinjen og menylinjen anses ikke som verktøylinjer i sammenheng med denne tjenesten.


Tjenestepåkallelse

Før du bruker Verktøylinje-tjenesten, må ScriptForge-biblioteket lastes eller importeres:

note

• Grunnleggende makroer krever å laste ScriptForge-biblioteket ved hjelp av følgende setning:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• Python-skript krever import fra scriptforge-modulen:
fra scriptforge import CreateScriptService


Tjenesten Verktøylinje påkalles ved hjelp av metoden Verktøylinjer, som er tilgjengelig i SFDocuments.Document tjeneste.

I Basic

Eksemplet nedenfor får en Matrise med navnene på verktøylinjene som er tilgjengelige i gjeldende dokument.


    oDoc = CreateScriptService("Document", ThisComponent)
    arrToolbars = oDoc.Toolbars()
    MsgBox SF_String.Represent(arrToolbars)
  
tip

Bruk metoden Verktøylinjer uten argumenter for å hente en matrise med tilgjengelige verktøylinjenavn.


Eksemplet nedenfor veksler mellom synligheten av Standard-verktøylinjen:


    oDoc = CreateScriptService("Document", ThisComponent)
    toolbar = oDoc.Toolbars("standardbar")
    toolbar.Visible = Not toolbar.Visible
  
I Python

    bas = CreateScriptService("Basic")
    doc = CreateScriptService("Document", bas.ThisComponent)
    arr_toolbars = doc.Toolbars()
    bas.MsgBox(repr(toolbars))
  

    bas = CreateScriptService("Basic")
    doc = CreateScriptService("Document", bas.ThisComponent)
    toolbar = doc.Toolbars("standardbar")
    toolbar.Visible = not toolbar.Visible
  

Egenskaper

Navn

Skrivebeskyttet

Type

Beskrivelse

BuiltIn

Ja

Boolean

Returnerer Sann når verktøylinjen er en del av settet med standardverktøylinjer som leveres med LibreOffice.

Docked

Ja

Boolean

Returnerer Sann når verktøylinjen er aktiv i vinduet og forankret.

HasGlobalScope

Ja

Boolean

Returnerer Sann når verktøylinjen er tilgjengelig i alle dokumenter av samme type.

Name

Ja

String

Returnerer navnet på verktøylinjen.

ResourceURL

Ja

String

Returnerer ressurs-URLen til verktøylinjen, i formen private:toolbar/toolbar_name.

Visible

Nei

Boolean

Returnerer True når verktøylinjen er aktiv og synlig i dokumentvinduet.

XUIElement

Ja

UNO Object

Returnerer com.sun.star.ui.XUIElement UNO-objektet som representerer verktøylinjen.


Liste over metoder i verktøylinjetjenesten

ToolbarButtons


ToolbarButtons

Returnerer en Matrise som inneholder navnene på alle verktøylinjeknapper når de kalles opp uten argumenter.

Oppgi navnet på en verktøylinjeknapp som argument for å få en ToolbarButton tjenesteforekomst.

Syntaks:

svc.ToolbarButtons(opt buttonname: str): any

Parametre:

knappnavn: Navnet på en verktøylinjeknapp i gjeldende verktøylinje.

Eksempel:

Eksemplet nedenfor returnerer kommandoen som utføres når knappen Ny klikkes på Standard-verktøylinjen:

I Basic

      oToolbar = oDoc.Toolbars("standardbar")
      oToolbarButton = oToolbar.ToolbarButtons("New")
      MsgBox oToolbarButton.OnClick
    
I Python

      toolbar = doc.Toolbars("standardbar")
      toolbar_button = toolbar.ToolbarButtons("New")
      bas.MsgBox(toolbar_button.OnClick)
    
note

Inaktive verktøylinjer har ikke knapper. Derfor, ved å kalle ToolbarButtons-metoden vil verktøylinjen bli synlig.


warning

Alle ScriptForge Grunnleggende rutiner eller identifikatorer som er prefikset med et understrekingstegn "_" er reservert for intern bruk. De er ikke ment å brukes i grunnleggende makroer eller Python-skript.


Supporter oss!