Aide LibreOffice 25.8
Le service Platform fournit une collection de propriétés sur l'environnement et le contexte d'exécution actuels, telles que :
La plate-forme matérielle (architecture, nombre de CPU, type de machine, etc.)
Informations sur le système d'exploitation (type de système d'exploitation, version, etc.)
La version de LibreOffice
Le nom d'utilisateur actuel
Toutes les propriétés du service Platform sont en lecture seule.
Avant d'utiliser le service Platform, la bibliothèque ScriptForge doit être chargée ou importée :
Les exemples ci-dessous en Basic et Python instancient le service Platform et accèdent à la propriété Architecture.
      GlobalScope.BasicLibraries.LoadLibrary("ScriptForge")
      Dim platform As Variant
      platform = CreateScriptService("Platform")
      MsgBox platform.Architecture
    
      from scriptforge import CreateScriptService
      svc = CreateScriptService("Platform")
      bas = CreateScriptService("Basic")
      bas.MsgBox(svc.Architecture)
    | Nom | Lecture seule | Type | Description | 
|---|---|---|---|
| Architecture | Oui | String | L'architecture du bit matériel. Exemple : '32bit' ou '64bit' | 
| ComputerName | Oui | String | Le nom du réseau de l'ordinateur. | 
| CPUCount | Oui | Integer | Le nombre d'unités centrales de traitement. | 
| CurrentUser | Oui | String | Le nom de l'utilisateur actuellement connecté. | 
| Extensions | Oui | Matrice de chaîne | Renvoie une matrice de chaînes de base zéro contenant les ID internes de toutes les extensions installées. | 
| FilterNames | Oui | Matrice de chaîne | Renvoie une matrice non triée de base zéro de chaînes contenant les noms de filtres d'import et d'export de documents disponibles. | 
| Fonts | Oui | Matrice de chaîne | Renvoie une matrice de chaînes de base zéro contenant les noms de toutes les polices disponibles. | 
| FormatLocale | Oui | String | Renvoie les paramètres régionaux utilisés pour les nombres et les dates sous forme de chaîne au format "la-CO" (langue-PAYS). | 
| Locale | Oui | String | Renvoie les paramètres régionaux du système d'exploitation sous forme de chaîne au format "la-CO" (langue-PAYS). Cela équivaut à la propriété SystemLocale. | 
| Machine | Oui | String | Le type de machines. Exemples : 'i386' ou 'x86_64'. | 
| OfficeLocale | Oui | String | Renvoie les paramètres régionaux de l'interface utilisateur sous forme de chaîne au format "la-CO" (langue-PAYS). | 
| OfficeVersion | Oui | String | La version réelle de LibreOffice exprimée sous la forme Exemple : 'LibreOffice 7.4.1.2 (The Document Foundation, Debian et Ubuntu)' | 
| OSName | Oui | String | Le type de système d'exploitation. Exemple : 'Darwin, Linux' ou 'Windows'. | 
| OSPlatform | Oui | String | Une seule chaîne identifiant la plate-forme sous-jacente avec autant d'informations utiles et lisibles par l'homme que possible. Exemple : 'Linux-5.8.0-44-generic-x86_64-with-glibc2.32' | 
| OSRelease | Oui | String | La version du système d'exploitation. Exemple : '5.8.0-44-generic' | 
| OSVersion | Oui | String | La version du système d'exploitation. Exemple : '#50-Ubuntu SMP Mar 9 février 06:29:41 UTC 2021' | 
| Printers | Oui | String | La liste des imprimantes disponibles sous la forme d'une matrice de base zéro. L'imprimante par défaut est placée en première position de la liste (index = 0). | 
| Processor | Oui | String | Le vrai nom du processeur. Exemple : 'amdk6'. Cette propriété peut renvoyer la même valeur que la propriété Machine. | 
| PythonVersion | Oui | String | Renvoie la version de l'interpréteur Python utilisé sous forme de chaîne au format "Python major.minor.patchlevel" (ex : "Python 3.9.7"). | 
| SystemLocale | Oui | String | Renvoie les paramètres régionaux du système d'exploitation sous forme de chaîne au format "la-CO" (langue-PAYS). Ceci est équivalent à la propriété Locale. | 
| UntitledPrefix | Oui | String | Renvoie le préfixe utilisé pour nommer les nouveaux documents (« Sans nom » en français). | 
| UserData | Oui | Dictionary | Renvoie une instance ScriptForge.Dictionary contenant des paires clé-valeur en relation avec la boîte de dialogue Outils - Options - Données utilisateur. | 
Une identification complète du nom du système d'exploitation est disponible à partir de la formule Calc INFO("system").
Les exemples suivants en Basic et Python illustrent comment utiliser la propriété Fonts pour écrire les noms de toutes les polices disponibles dans la feuille Calc active à partir de la cellule "A1" :
    Dim oDoc as Object
    Dim allFonts as Object
    Dim svcPlatform as Object
    Set oDoc = CreateScriptService("Calc")
    Set svcPlatform = CreateScriptService("Platform")
    allFonts = svcPlatform.Fonts
    oDoc.setArray("~.A1", allFonts)
  L'exemple ci-dessous montre comment créer une table Calc avec toutes les valeurs stockées dans la propriété UserData, qui est une instance de service Dictionary :
    Dim svcPlatform as Object, oUserData as Object, oDoc as Object
    Dim arrUserData As Object, currCell As String
    Set svcPlatform = CreateScriptService("Platform")
    oUserData = svcPlatform.UserData
    arrUserData = oUserData.ConvertToArray()
    Set oDoc = CreateScriptService("Calc", ThisComponent)
    oDoc.SetArray("~.A1", Array(Array("Key", "Value")))
    oDoc.SetArray("~.A2", arrUserData)
  Les exemples ci-dessus peuvent être écrits en Python comme suit :
    from scriptforge import CreateScriptService
    bas = CreateScriptService("Basic")
    doc = CreateScriptService("Calc", bas.ThisComponent)
    svc_platform = CreateScriptService("Platform")
    all_fonts = svc_platform.Fonts
    doc.setArray("~.A1", all_fonts)
  
    from scriptforge import CreateScriptService
    bas = CreateScriptService("Basic")
    doc = CreateScriptService("Calc", bas.ThisComponent)
    svc_platform = CreateScriptService("Platform")
    user_data = svc_platform.UserData
    arr_user_data = [[key, user_data[key]] for key in user_data]
    doc.SetArray("~.A1", (("Key", "Value"),))
    doc.SetArray("~.A2", arr_user_data)