Spis treści

# Usługa SFWidgets.Toolbar

Usługa Toolbar pozwala na pobranie informacji związanych z paskami narzędzi dostępnymi dla konkretnego okna dokumentu. Dzięki tej usłudze możliwe jest:

- Przełączanie widoczności określonych pasków narzędzi.

- Uzyskiwanie dostępu do informacji o przyciskach dostępnych na każdym pasku narzędzi.

Każda aplikacja LibreOffice ma własny zestaw dostępnych pasków narzędzi. Ta usługa obsługuje zarówno wbudowane, jak i niestandardowe paski narzędzi.

Pasek stanu i pasek menu nie są uważane za paski narzędzi w kontekście tej usługi.

## Wywoływanie usługi

Przed użyciem usługi Toolbar należy załadować lub zaimportować bibliotekę ScriptForge:

• Podstawowe makra wymagają załadowania biblioteki ScriptForge przy użyciu następującej instrukcji:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")
• Skrypty Pythona wymagają importu z modułu scriptforge:
from scriptforge import CreateScriptService

Usługę Toolbar wywołuje się za pomocą metody Toolbars, która jest dostępna w usłudze SFDocuments.Document.

##### W języku Basic

Poniższy przykład pobiera Array z nazwami pasków narzędzi dostępnych w bieżącym dokumencie.

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

Użyj metody Toolbars bez argumentów, aby pobrać tablicę z dostępnymi nazwami pasków narzędzi.

Poniższy przykład przełącza widoczność paska narzędzi Standardowy:

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

##### W języku 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

## Właściwości

Nazwa | Tylko do odczytu | Typ | Opis
--- | --- | --- | ---
BuiltIn | Tak | Boolean | Zwraca True, jeśli pasek narzędzi jest częścią zestawu standardowych pasków narzędzi dostarczanych z LibreOffice.
Docked | Tak | Boolean | Zwraca True, gdy pasek narzędzi jest aktywny w oknie i zadokowany.
HasGlobalScope | Tak | Boolean | Zwraca wartość True, gdy pasek narzędzi jest dostępny we wszystkich dokumentach tego samego typu.
Name | Tak | String | Zwraca nazwę paska narzędzi.
ResourceURL | Tak | String | Zwraca adres URL zasobu paska narzędzi w formularzu private:toolbar/toolbar_name.
Visible | Nie | Boolean | Zwraca wartość True, gdy pasek narzędzi jest aktywny i widoczny w oknie dokumentu.
XUIElement | Tak | UNO Object | Zwraca obiekt UNO com.sun.star.ui.XUIElement reprezentujący pasek narzędzi.

Lista metod w usłudze Toolbar
ToolbarButtons |  |

## ToolbarButtons

Zwraca Array zawierającą nazwy wszystkich przycisków paska narzędzi, gdy są wywoływane bez argumentów.

Podaj nazwę przycisku paska narzędzi jako argument, aby uzyskać instancję usługi ToolbarButton.

### Składnia:

svc.ToolbarButtons(opt buttonname: str): any

### Parametry:

buttonname: nazwa przycisku paska narzędzi na bieżącym pasku narzędzi.

### Przykład:

Poniższy przykład zwraca polecenie wykonane po kliknięciu przycisku Nowy na pasku narzędzi Standardowy:

##### W języku Basic

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

##### W języku Python

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

Nieaktywne paski narzędzi nie mają przycisków. Dlatego wywołanie metody ToolbarButtons spowoduje wyświetlenie paska narzędzi.

Wszystkie podstawowe procedury lub identyfikatory ScriptForge poprzedzone znakiem podkreślenia „_” są zarezerwowane do użytku wewnętrznego. Nie należy ich używać w makrach Basic ani skryptach Pythona.

Tematy pokrewne

Usługa SFWidgets.ToolbarButton