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.

Usługa SFWidgets.ToolbarButton