Innhold

# 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 å:

- Slå av eller på synligheten til spesifikke verktøylinjer.

- Få tilgang til informasjon om knappene som er tilgjengelige på hver verktøylinje.

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

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:

• 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)

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)

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

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.

Lignende emner

SFWidgets.ToolbarButton-tjeneste