Nápověda LibreOffice 24.8
Služba Toolbar umožňuje získávat informace týkající se nástrojových lišt dostupných v určitém okně dokumentu. Pomocí této služby lze:
Přepínat viditelnost určitých nástrojových lišt.
Získávat informace o tlačítkách na jednotlivých nástrojových lištách.
Každá aplikace LibreOffice má vlastní sadu nástrojových lišt, které v ní jsou k dispozici. Tato služba pracuje jak s vestavěnými, tak s vlastními lištami.
Stavový řádek a hlavní nabídka se v kontextu této služby za nástrojové lišty nepovažují.
Před používáním služby Toolbar je nutné načíst či naimportovat knihovnu ScriptForge pomocí:
Služba Toolbar je získána pomocí metody Toolbars, která je k dispozici ve službě SFDocuments.Document.
V následujícím příkladu se získá Array s názvy nástrojových lišt dostupných v aktuálním dokumentu.
    oDoc = CreateScriptService("Document", ThisComponent)
    arrToolbars = oDoc.Toolbars()
    MsgBox SF_String.Represent(arrToolbars)
  Metodou Toolbars použitou bez argumentů získáte pole s názvy dostupných nástrojových lišt.
V následujícím příkladu je přepnuta viditelnost lišty :
    oDoc = CreateScriptService("Document", ThisComponent)
    toolbar = oDoc.Toolbars("standardbar")
    toolbar.Visible = Not toolbar.Visible
  
    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
  | Název | Pouze pro čtení | Typ | Popis | 
|---|---|---|---|
| BuiltIn | ano | Boolean | Vrátí True, pokud je nástrojová lišta součástí sady standardních, v LibreOffice vestavěných lišt. | 
| Docked | ano | Boolean | Vrátí True, pokud je nástrojová lišta v okně aktivní a je ukotvena. | 
| HasGlobalScope | ano | Boolean | Vrátí True, pokud je nástrojová lišta k dispozici ve všech dokumentech téhož typu. | 
| Name | ano | String | Vrátí název nástrojové lišty. | 
| ResourceURL | ano | String | Vrátí pro nástrojovou lištu zdrojovou adresu URL ve tvaru private:toolbar/toolbar_name. | 
| Visible | ne | Boolean | Vrátí True, pokud je nástrojová lišta aktivní a viditelná v okně dokumentu. | 
| XUIElement | ano | UNO Object | Vrátí objekt UNO com.sun.star.ui.XUIElement, který představuje nástrojovou lištu. | 
| Seznam metod služby Toolbar | ||
|---|---|---|
| 
 | 
 | |
Je-li metoda zavolána bez argumentů, vrátí Array obsahující názvy všech tlačítek nástrojové lišty.
Zadáte-li jako argument název tlačítka nástrojové lišty, získáte instanci služby ToolbarButton.
svc.ToolbarButtons(opt buttonname: str): any
buttonname: Název tlačítka na aktuální nástrojové liště.
V následujícím příkladu se vrátí příkaz provedený při klepnutí na tlačítko na nástrojové liště :
      oToolbar = oDoc.Toolbars("standardbar")
      oToolbarButton = oToolbar.ToolbarButtons("New")
      MsgBox oToolbarButton.OnClick
    
      toolbar = doc.Toolbars("standardbar")
      toolbar_button = toolbar.ToolbarButtons("New")
      bas.MsgBox(toolbar_button.OnClick)
    Neaktivní nástrojové lišty tlačítka nemají, proto volání metody ToolbarButtons způsobí, že se lišta stane viditelnou.