Edukiak

# ScriptForge.Platform zerbitzua

Platform zerbitzuak uneko exekuzio-inguruneari eta -testuinguruneari buruzko propietateen bilduma bat eskaintzen du, adibidez:

- Hardware-plataforma (arkitektura, PUZ zenbaketa, makina mota, etab.)

- Sistema eragilearen buruzko informazioa (mota, argitalpena, bertsioa, etab.)

- LibreOffice bertsioa

- Uneko erabiltzailearen izena

Platform zerbitzuaren propietate guztiak soilik irakurtzeko dira.

## Zerbitzuari deitzea

Platform zerbitzua erabiltzeko, ScriptForge liburutegia kargatu edo inportatu behar da:

• Basic makroak erabiltzkeo, ScriptForge liburutegia kargatu behar da honako instrukzioa erabiliz:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")
• Python scriptak erabiltzeko, berriz, scriptforge modulu baten inportazioa behar dute:
from scriptforge import CreateScriptService

Beheko adibideak, bai Basic lengoaian bai Python lengoaian, Platform zerbitzuaren instantzia bat sortzen du eta Architecture propietatea atzitzen du.

##### Basic lengoaian

          GlobalScope.BasicLibraries.LoadLibrary("ScriptForge")
          Dim platform As Variant
          platform = CreateScriptService("Platform")
          MsgBox platform.Architecture

##### Python lengoaian

          from scriptforge import CreateScriptService
          svc = CreateScriptService("Platform")
          bas = CreateScriptService("Basic")
          bas.MsgBox(svc.Architecture)

## Propietateak

Izena | Irakurtzeko soilik | Mota | Deskribapena
--- | --- | --- | ---
Architecture | Bai | String | Hardwarearen bit-arkitektura. Adibidez: '32bit' edo '64bit'
ComputerName | Bai | String | Ordenagailuaren izena sarean.
CPUCount | Bai | Integer | Prozesatzeko unitate zentralen (PUZ) kopurua.
CurrentUser | Bai | String | Unean saioa hasita duen erabiltzailearen izena.
Extensions | Bai | Kate-matrizea | Zeron oinarritutako kate-matrize bat itzultzen du, instalatutako hedapen guztien barneko IDak dituena.
FilterNames | Bai | Kate-matrizea | Zeron oinarritutako eta ordenatu gabeko kate-matrize bat itzultzen du, dokumentuak inportatu eta esportatzeko iragazki-izen erabilgarriak dituena.
Fonts | Bai | String motako matrizea | Zeron oinarritutako kate-matrize bat itzultzen du, erabilgarri dauden letra-tipo guztien izenak dituena.
FormatLocale | Bai | String | Zenbakietarako eta datetarako erabilitako eskualde-ezarpena itzultzen du "hi-HE" formatuan (hizkuntza-HERRIALDEA).
Locale | Bai | String | Sistema eragilearen eskualde-ezarpena itzultzen du "hi-HE" (hizkuntza-HERRIALDEA) formatuko kate gisa. Hori SystemLocale propietatearen baliokidea da.
Machine | Bai | String | Makina mota. Adibideak: 'i386' edo 'x86_64'.
OfficeLocale | Bai | String | Erabiltzaile-interfazearen eskualde-ezarpena itzultzen du "hi-HE" (hizkuntza-HERRIALDEA) formatuko kate gisa.
OfficeVersion | Bai | String | Uneko LibreOffice bertsioa, honal adierazita: ' LibreOffice w.x.y.z (The Document Foundation)'. Adibidea: 'LibreOffice 7.4.1.2 (The Document Foundation, Debian and Ubuntu)'
OSName | Bai | String | Sistema eragilearen mota. Adibideak: 'Darwin, Linux' edo'Windows'.
OSPlatform | Bai | String | Kate bakar bat plataforma ahalik eta gehien identifikatzeko, gizakiak irakurtzeko moduko informazio ahalik eta erabilgarrienarekin. Adibidea: 'Linux-5.8.0-44-generic-x86_64-with-glibc2.32'
OSRelease | Bai | String | Sistema eragilearen argitalpena. Adibidea: '5.8.0-44-generic'
OSVersion | Bai | String | Sistema eragilearen eraikuntza edo bertsioa. Adibidea: '#50-Ubuntu SMP Tue Feb 9 06:29:41 UTC 2021'
Printers | Bai | String array | Erabilgarri dauden inprimagailuen zerrenda, zeron oinarritutako matrize gisa. Inprimagailu lehenetsia zerrendaren lehen postua kokatuko da (indizea = 0).
Processor | Bai | String | Prozesatzaileaaren benetako izena. Adibidea: 'amdk6'. Propietate honek eta Machine propietatek balio bera eman dezakete.
PythonVersion | Bai | String | Erabiltzen ari den Python interpretatzailearen bertsioa itzultzen du, kate gisa, "Python handia.txikia.adabakia" formatuan (adibidea: "Python 3.9.7").
SystemLocale | Bai | String | Sistema eragilearen eskualde-ezarpena itzulzen du "hi-HE" (hizkuntza-HERRIALDEA) formatuko kate gisa. Locale propietatearen baliokidea da hori.
UntitledPrefix | Yes | String | Returns the prefix used to name new documents ("Untitled " in english).
UserData | Yes | Dictionary | Returns a ScriptForge.Dictionary instance containing key-value pairs in relation with Tools - Options - User Data dialog.

Extensive operating system name identification is available from INFO("system") Calc formula.

### Adibidea:

##### Basic lengoaian

Basic eta Python lengoaietako hurrengo adibideetan Fonts propietatea nola erabiltzen den ikusi daiteke. Adibide horietan, erabilgarri dauden letra-tipo guztien izenak uneko Calc orrian idatzi dira, "A1" gelaxkan hasita:

        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)

The example below demonstrates how to create a Calc table with all the values stored in the UserData property, which is a Dictionary service instance:

        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)

##### Python lengoaian

The examples above can be written in Python as follows:

        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)

Azpimarraren karaktere bat, "_", aurrizki gisa duten ScriptForge Basic errutina edo identifikatzaile guztiak barneko erabilerarako erreserbatuta daude. Ez dira Basic makroetan edo Python scriptetan erabili behar.

Erlazionatutako gaiak

Sistema eragilea identifikatzea

Plataformaren informazioa INFO("sistema") Calc formularekin

GetGuiType funtzioa

Tools liburutegia