Aide LibreOffice 25.2
Le service Toolbar permet de récupérer des informations relatives aux barres d'outils disponibles pour une fenêtre de document spécifique. Avec ce service, il est possible de :
Basculez la visibilité de barres d’outils spécifiques.
Accéder aux informations sur les boutons disponibles dans chaque barre d'outils.
Chaque application LibreOffice possède son propre ensemble de barres d'outils disponibles. Ce service gère les barres d'outils intégrées et personnalisées.
La barre d'état et la barre de menu ne sont pas considérées comme des barres d'outils dans le contexte de ce service.
Avant d'utiliser le service Toolbar, la bibliothèque ScriptForge doit être chargée ou importée :
Le service Toolbar est appelé à l'aide de la méthode Toolbars, disponible dans le service SFDocuments.Document.
L'exemple ci-dessous obtient une Array avec les noms des barres d'outils disponibles dans le document actuel.
    oDoc = CreateScriptService("Document", ThisComponent)
    arrToolbars = oDoc.Toolbars()
    MsgBox SF_String.Represent(arrToolbars)
  Utilisez la méthode Toolbars sans arguments pour récupérer un tableau avec les noms de barres d'outils disponibles.
L'exemple ci-dessous bascule la visibilité de la barre d'outils :
    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
  | Nom | En lecture seule | Type | Description | 
|---|---|---|---|
| BuiltIn | Oui | Boolean | Renvoie True lorsque la barre d'outils fait partie de l'ensemble des barres d'outils standard fournies avec LibreOffice. | 
| Docked | Oui | Boolean | Renvoie True lorsque la barre d'outils est active dans la fenêtre et ancrée. | 
| HasGlobalScope | Oui | Boolean | Renvoie True lorsque la barre d'outils est disponible dans tous les documents du même type. | 
| Name | Oui | String | Renvoie le nom de la barre d'outils. | 
| ResourceURL | Oui | String | Renvoie l'URL de la ressource de la barre d'outils, sous la forme private:toolbar/toolbar_name. | 
| Visible | Non | Boolean | Renvoie True lorsque la barre d'outils est active et visible dans la fenêtre du document. | 
| XUIElement | Oui | UNO Object | Renvoie l'objet UNO com.sun.star.ui.XUIElement qui représente la barre d'outils. | 
| Liste des méthodes dans le service Toolbar | ||
|---|---|---|
| 
 | 
 | |
Renvoie une Array contenant les noms de tous les boutons de la barre d'outils quand appelé sans arguments.
Fournissez le nom d'un bouton de la barre d'outils comme argument pour obtenir une instance de service ToolbarButton.
svc.ToolbarButtons(opt buttonname: str): any
buttonname : Le nom d'un bouton de la barre d'outils dans la barre d'outils actuelle.
L'exemple ci-dessous renvoie la commande exécutée lorsque le bouton est cliqué dans la barre d'outils :
      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)
    Les barres d'outils inactives n'ont pas de boutons. Par conséquent, l’appel de la méthode ToolbarButtons rendra la barre d’outils visible.