ScriptForge-biblioteker bygger opp en utvidbar samling av makroskriptressurser for LibreOfficeDev som kan startes fra grunnleggende makroer eller Python-skript.
• Grunnleggende makroer krever å laste ScriptForge-biblioteket ved hjelp av følgende setning: GlobalScope.BasicLibraries.loadLibrary("ScriptForge")
• Python-skript krever import fra scriptforge-modulen: fra scriptforge import CreateScriptService
De beskrevne modulene og klassene påkalles fra brukerskript som "Tjenester". En generisk konstruktør av disse tjenestene er designet for det formålet for hvert språk.
Metoden Kasser er tilgjengelig i alle tjenester og bør anropes for å frigjøre ressurser etter bruk:
Gir en samling metoder for å manipulere og transformere matriser med én dimensjon (vektorer) og matriser med to dimensjoner (matriser). Dette inkluderer settoperasjoner, sortering, import fra og eksport til tekstfiler.
Matriser med mer enn to dimensjoner kan ikke brukes med metodene i denne tjenesten, det eneste unntaket er CountDims-metoden som godtar matriser med et hvilket som helst antall dimensjoner.
Tjenesten Base gir en rekke metoder og egenskaper for å forenkle administrasjon og håndtering av LibreOfficeDev Base-dokumenter.
Denne tjenesten er nært knyttet til Dokument-tjenesten, som gir generiske metoder for håndtering av LibreOfficeDev-dokumenter, inkludert basisdokumenter. Derfor utvider Base-tjenesten Dokument-tjenesten og gir ytterligere metoder som er spesifikke for basisdokumenter, slik at brukere kan:
Få tilgang til databasen i et basisdokument.
Åpne skjemadokumenter som er lagret i et basisdokument.
Sjekk om et skjemadokument fra et basisdokument er lastet inn.
Tjenesten ScriptForge.Basic foreslår en samling av LibreOfficeDev Basic-metoder som skal utføres i en Python-kontekst. Grunnleggende tjenestemetoder gjengir den nøyaktige syntaksen og oppførselen til grunnleggende innebygde funksjoner.
Det delte biblioteket SFDocuments gir en rekke metoder og egenskaper for å forenkle administrasjon og håndtering av LibreOfficeDev-dokumenter.
Tjenesten SFDocuments.Calc er en underklasse av SFDocuments.Document tjeneste. Alle metoder og egenskaper definert for Dokument-tjenesten kan også nås ved å bruke en Calc-tjenesteforekomst.
Tjenesten Calc er fokusert på:
Håndtering av ark i et Calc-dokument (kopiere, sette inn, flytte osv.)
Utveksling av data mellom grunnleggende datastrukturer og Calc-områder
Tjenesten Dataark gjør det mulig å visualisere innholdet i databasetabeller samt resultatene av spørringer og SQL-setninger ved å bruke datavisningen i Base. I tillegg tillater denne tjenesten å:
Legg til egendefinerte menyer i datavisningen.
Få tilgang til verdier i bestemte posisjoner i datavisningen.
Plasser markøren i en bestemt celle i datavisningen.
Tjenesten Dialog bidrar til administrasjonen av dialoger som er opprettet med den grunnleggende Dialog Editor eller dialoger som er opprettet i farten . Hver forekomst av gjeldende klasse representerer en enkelt dialogboks som vises for brukeren.
Tjenesten DialogControl administrerer kontrollene som tilhører en dialog som er definert med Basic Dialog Editor. Hver forekomst av gjeldende tjeneste representerer en enkelt kontroll i en dialogboks.
Fokuset er satt på å få og stille inn verdiene som vises av kontrollene i dialogboksen. Formatering er tilgjengelig via egenskapene XControlModel og XControlView.
Merk at innholdet i den unike DialogControl.Value egenskapen varierer i henhold til kontrolltypen.
En spesiell oppmerksomhet er gitt til kontroller av typen trekontroll. Det er lett å befolke et tre, enten gren for gren, eller med et sett med grener på en gang. Fylling av en trekontroll kan utføres statisk eller dynamisk.
SFDocuments-biblioteket gir metoder og egenskaper for å forenkle administrasjon og manipulering av LibreOfficeDev-dokumenter.
Metoder som kan brukes for alle typer dokumenter (tekstdokumenter, ark, presentasjoner osv.) leveres av SFDocuments.Document-tjenesten. Noen eksempler er:
Åpne, lukke og lagre dokumenter
Tilgang til standard eller egendefinerte egenskaper for dokumenter
Tjenesten Unntak er en samling metoder for å hjelpe til med kodefeilsøking i Basic- og Python-skript og i feilhåndtering i Basic-skript.
I Grunnleggende skript, når en kjøretidsfeil oppstår, hjelper metodene og egenskapene til Exception-tjenesten å identifisere feilkonteksten og tillate å håndtere den.
Tjenesten Form gir metoder og egenskaper for å administrere skjemaer i LibreOfficeDev-dokumenter. Denne tjenesten støtter skjemaer i Base-, Calc- og Writer-dokumenter og lar deg:
Åpne og aktiver skjemaer.
Naviger gjennom poster som vises i skjemaet.
Få tilgang til kontrollene inne i skjemaet.
Få tilgang til underskjemaer til et overordnet skjema.
Tjenesten FormControl gir tilgang til kontrollene som tilhører et skjema, et underskjema eller en tabellkontroll i et FormDocument. Hver forekomst av FormControl-tjenesten refererer til en enkelt kontroll i skjemaet. Denne tjenesten lar brukere:
Hent og angi egenskapene til kontrollen representert av 1FormControl2-forekomsten.
Få tilgang til gjeldende verdi som vises av kontrollen.
Tjenesten FormDocument gir tilgang til skjemadokumenter som er lagret i LibreOfficeDev Base-dokumenter.
I et Base dokument kan eksisterende skjemadokumenter vises ved å velge Vis - Skjemaer i brukergrensesnittet. Hvert skjemadokument kan være sammensatt av ett eller flere skjemaer, inkludert hovedskjemaet og andre underskjemaer.
Denne tjenesten gir en rekke metoder knyttet til oversettelse av strenger med minimal innvirkning på programmets kildekode. Metodene som tilbys av L10N-tjenesten kan hovedsakelig brukes til å:
Lag POT-filer som kan brukes som maler for oversettelse av alle strenger i programmet.
Få oversatte strenger under kjøring for språket som er definert i egenskapen Lokal.
Tjenesten Meny kan brukes til å opprette og fjerne menyer fra menylinjen i et LibreOfficeDev-dokumentvindu. Hver menyoppføring kan knyttes til et skript eller med en UNO-kommando. Denne tjenesten gir følgende funksjoner:
Oppretting av menyer med egendefinerte oppføringer, avmerkingsbokser, radioknapper og skilletegn.
Dekorasjon av menyelementer med ikoner og verktøytips.
Tjenesten PopupMenu kan brukes til å lage popup-menyer som kan assosieres med hendelser eller utføres av skript. Denne tjenesten gir følgende funksjoner:
Oppretting av popup-menyer med egendefinerte oppføringer, avmerkingsbokser og radioknapper.
Dekorasjon av menyelementer med ikoner og verktøytips.
Hovedformålet med modulen Tjenester er å gi tilgang til metoden CreateScriptService, som kan kalles inn brukerskript for å instansiere tjenester som er implementert ved hjelp av ScriptForge-rammeverket.
Tjenesten Verktøylinje gjør det mulig å hente informasjon relatert til verktøylinjene som er tilgjengelige for et spesifikt dokumentvindu. Med denne tjenesten er det mulig å:
Slå av eller på synligheten til spesifikke verktøylinjer.
Få tilgang til informasjon om knappene som er tilgjengelige på hver verktøylinje.
Tjenesten ToolbarButton gjør det mulig å hente informasjon relatert til verktøylinjeknappene som er tilgjengelige i en gitt verktøylinje. Med denne tjenesten er det mulig å:
Veksle på synligheten til verktøylinjeelementer.
Utfør kommandoen knyttet til en gitt verktøylinjeknapp.
Det delte biblioteket SFDocuments gir en rekke metoder og egenskaper for å forenkle administrasjon og håndtering av LibreOfficeDev-dokumenter.
Noen metoder er generiske for alle typer dokumenter og er arvet fra SF_Document-modulen, mens andre metoder som er spesifikke for Writer-dokumenter er definert i SF_Writer-modulen.
Merk: Andre ScriptForge ikke beskrevne moduler er reservert for intern bruk. Innholdet deres kan endres uten varsel.
Alle ScriptForge Grunnleggende rutiner eller identifikatorer som er prefikset med et understrekingstegn "_" er reservert for intern bruk. De er ikke ment å brukes i grunnleggende makroer eller Python-skript.