Υπηρεσία ScriptForge.Basic
Η υπηρεσία ScriptForge.Basic προτείνει μια συλλογή μεθόδων του LibreOffice Basic που θα εκτελεστούν σε περιβάλλον Python. Οι μέθοδοι υπηρεσίας Basic αναπαράγουν την ακριβή σύνταξη και συμπεριφορά των ενσωματωμένων συναρτήσεων Basic.
Τυπικό παράδειγμα:
bas.MsgBox('Display this text in a message box from a Python script')
Η χρήση της υπηρεσίας ScriptForge.Basic περιορίζεται σε σενάρια Python.
Κλήση υπηρεσίας
Πριν να χρησιμοποιήσετε την υπηρεσία Basic, εισαγάγετε τη μέθοδο CreateScriptService() από τη λειτουργική μονάδα scriptforge:
from scriptforge import CreateScriptService
bas = CreateScriptService("Basic")
Ιδιότητες
Όνομα |
Μόνο για ανάγνωση |
Τύπος |
Περιγραφή |
|---|---|---|---|
|
MB_OK, MB_OKCANCEL, MB_RETRYCANCEL, MB_YESNO, MB_YESNOCANCEL |
Ναι |
Integer |
Τιμές: 0, 1, 5, 4, 3 |
|
MB_ICONEXCLAMATION, MB_ICONINFORMATION, MB_ICONQUESTION, MB_ICONSTOP |
Ναι |
Integer |
Τιμές: 48, 64, 32, 16 |
|
MB_ABORTRETRYIGNORE, MB_DEFBUTTON1, MB_DEFBUTTON2, MB_DEFBUTTON3 |
Ναι |
Integer |
Τιμές: 2, 128, 256, 512 |
|
IDABORT, IDCANCEL, IDIGNORE, IDNO, IDOK, IDRETRY, IDYES |
Ναι |
Integer |
Τιμές: 3, 2, 5, 7, 1, 4, 6 |
|
StarDesktop |
Ναι |
Αντικείμενο |
Επιστρέφει το αντικείμενο StarDesktop που αντιπροσωπεύει την εφαρμογή LibreOffice. |
|
ThisComponent |
Ναι |
Αντικείμενο |
Εάν το τρέχον στοιχείο αναφέρεται σε έγγραφο του LibreOffice, αυτή η μέθοδος επιστρέφει το αντικείμενο UNO που αντιπροσωπεύει το έγγραφο. Αυτή η ιδιότητα επιστρέφει None, όταν το τρέχον στοιχείο δεν αντιστοιχεί σε έγγραφο. |
|
ThisDatabaseDocument |
Ναι |
Αντικείμενο |
Εάν η δέσμη ενεργειών εκτελείται από ένα έγγραφο Base ή οποιοδήποτε από τα υποσυστατικά του, αυτή η μέθοδος επιστρέφει το κύριο στοιχείο της παρουσίας Base. Αυτή η ιδιότητα επιστρέφει διαφορετικά None. |
|
Κατάλογος μεθόδων στην Υπηρεσία Basic |
||
|---|---|---|
|
CDate |
DateDiff |
GlobalScope.BasicLibraries |
Υπάρχουν εναλλακτικές λύσεις σε Python για μεθόδους που σημειώνονται με (*).
CDate
Μετατρέπει μια αριθμητική έκφραση ή μια συμβολοσειρά σε εγγενές αντικείμενο Python του τύπου datetime.datetime.
Αυτή η μέθοδος εκθέτει την ενσωματωμένη συνάρτηση Basic CDate σε σενάρια Python.
svc.CDate(expression: any): obj
expression: (έκφραση) μια αριθμητική έκφραση ή μια συμβολοσειρά που αντιπροσωπεύει μια ημερομηνία.
d = bas.CDate(1000.25)
bas.MsgBox(str(d)) # 1902-09-26 06:00:00
bas.MsgBox(d.year) # 1902
CDateFromUnoDateTime
Μετατρέπει μια αναπαράσταση ημερομηνίας/ώρας UNO σε ένα εγγενές αντικείμενο της Python του τύπου datetime.datetime.
svc.CDateFromUnoDateTime(unodate: uno): obj
unodate: Ένα αντικείμενο UNO ημερομηνίας/ώρας ενός από τους ακόλουθους τύπους: com.sun.star.util.DateTime, com.sun.star.util. Ημερομηνία ή com.sun.star.util.Time
Το παρακάτω παράδειγμα δημιουργεί ένα αντικείμενο com.sun.star.util.DateTime και το μετατρέπει σε αντικείμενο Python datetime.datetime.
uno_date = bas.CreateUnoStruct('com.sun.star.util.DateTime')
uno_date.Year = 1983
uno_date.Month = 2
uno_date.Day = 23
new_date = bas.CDateFromUnoDateTime(uno_date)
bas.MsgBox(str(new_date)) # 1983-02-23 00:00:00
CDateToUnoDateTime
Μετατρέπει μια αναπαράσταση ημερομηνίας σε αντικείμενο com.sun.star.util.DateTime.
svc.CDateToUnoDateTime(date: obj): uno
date (ημερομηνία): Ένα αντικείμενο ημερομηνίας/ώρας Python ενός από τους ακόλουθους τύπους: datetime.datetime, datetime.date, datetime.time , float (time.time) ή time.struct_time.
from datetime import datetime
current_datetime = datetime.now()
uno_date = bas.CDateToUnoDateTime(current_datetime)
bas.MsgBox(str(uno_date.Year) + "-" + str(uno_date.Month) + "-" + str(uno_date.Day))
ConvertFromUrl
Επιστρέφει ένα όνομα αρχείου διαδρομής συστήματος για τη δεδομένη διεύθυνση URL file: (αρχείο).
svc.ConvertFromUrl(url: str): str
url: Μια απόλυτη διεύθυνση URL file:.
Όνομα αρχείου διαδρομής συστήματος.
filename = bas.ConvertFromUrl( "file:///C:/Program%20Files%20(x86)/LibreOffice/News.txt" )
bas.MsgBox(filename)
Η μέθοδος uno module επιστρέφει μια διαδρομή συστήματος χρησιμοποιώντας μια ταυτόσημη σύνταξη.
import uno
filename = uno.fileUrlToSystemPath( "file:///C:/Program%20Files%20(x86)/LibreOffice/News.txt" )
bas.MsgBox(filename)
ConvertToUrl
Επιστρέφει μια διεύθυνση URL file: (αρχείου)για τη δεδομένη διαδρομή συστήματος.
svc.ConvertToUrl(systempath: str): str
systempath (διαδρομή συστήματος): Ένα όνομα αρχείου συστήματος ως συμβολοσειρά.
URL ενός file: (αρχείου) ως συμβολοσειρά.
url = bas.ConvertToUrl( 'C:\Program Files(x86)\LibreOffice\News.txt' )
bas.MsgBox(url)
Η μέθοδος uno module επιστρέφει μια διεύθυνση URL αρχείου για τη δεδομένη διαδρομή συστήματος.
from uno import systemPathToFileUrl as ConvertToUrl
filename = ConvertToUrl( 'C:\Program Files(x86)\LibreOffice\News.txt' )
bas.MsgBox(filename)
CreateUnoService
Δημιουργεί μια υπηρεσία UNO με το ProcessServiceManager.
svc.CreateUnoService(servicename: str): uno
servicename (όνομα υπηρεσίας): Ένα πλήρως πιστοποιημένο όνομα υπηρεσίας όπως com.sun.star.ui.dialogs.FilePicker ή com.sun.star.sheet.FunctionAccess.
dsk = bas.CreateUnoService('com.sun.star.frame.Desktop')
CreateUnoStruct
Επιστρέφει μια παρουσία μιας δομής UNO του καθορισμένου τύπου.
svc.CreateUnoStruct(unostructure: str): uno
unostructure: Ένα πλήρως αναγνωρισμένο όνομα δομής όπως com.sun.star.beans.Property, ή com.sun.star.util.DateTime.
date_struct = CreateUnoStruct('com.sun.star.util.DateTime')
Η μέθοδος uno module createUnoStruct() δημιουργεί μια παρουσία ενός τύπου δομής Uno.
import uno
p = uno.createUnoStruct( 'com.sun.star.beans.Property' )
bas.MsgBox(p)
DateAdd
Προσθέτει μια ημερομηνία ή ένα χρονικό διάστημα σε μια δεδομένη ημερομηνία/χρόνο αρκετές φορές και επιστρέφει την ημερομηνία που προκύπτει.
svc.DateAdd(interval: str, number: num, date: datetime): datetime
interval (διάστημα): Μια έκφραση συμβολοσειράς από τον παρακάτω πίνακα, που καθορίζει την ημερομηνία ή το χρονικό διάστημα.
number (αριθμός): Μια αριθμητική έκφραση που καθορίζει πόσο συχνά θα προστίθεται η τιμή interval όταν είναι θετική ή θα αφαιρείται όταν είναι αρνητική.
date (ημερομηνία): Μια δεδομένη τιμή datetime.datetime, η τιμή interval θα προστεθεί number (αριθμός) φορών σε αυτήν την τιμή datetime.datetime.
Μια τιμή datetime.datetime.
dt = datetime.datetime(2004, 1, 31)
dt = bas.DateAdd("m", 1, dt)
print(dt)
DateDiff
Επιστρέφει τον αριθμό των διαστημάτων ημερομηνίας ή χρόνου μεταξύ δύο δεδομένων τιμών ημερομηνίας/χρόνου.
svc.DateDiff(interval: str, date1: datetime, date2: datetime, firstdayofweek = 1, firstweekofyear = 1): int
interval (διάστημα): Μια έκφραση συμβολοσειράς που καθορίζει το διάστημα ημερομηνίας, όπως περιγράφεται στην παραπάνω μέθοδο DateAdd.
date1, date2 (ημερομηνία1, ημερομηνία2): Οι δύο τιμές datetime.datetime προς σύγκριση.
Ένας αριθμός.
date1 = datetime.datetime(2005,1, 1)
date2 = datetime.datetime(2005,12,31)
diffDays = bas.DateDiff('d', date1, date2)
print(diffDays)
DatePart
Η συνάρτηση DatePart επιστρέφει ένα καθορισμένο τμήμα μιας ημερομηνίας.
svc.DatePart(interval: str, date: datetime, firstdayofweek = 1, firstweekofyear = 1): int
interval (διάστημα): Μια έκφραση συμβολοσειράς που καθορίζει το διάστημα ημερομηνίας, όπως περιγράφεται στην παραπάνω μέθοδο DateAdd.
date (ημερομηνία): Η ημερομηνία/χρόνος από την οποία υπολογίζεται το αποτέλεσμα.
firstdayofweek, firstweekofyear (πρώτη ημέρα της εβδομάδας, πρώτη εβδομάδα του έτους): προαιρετικές παράμετροι που καθορίζουν αντίστοιχα την ημέρα έναρξης μιας εβδομάδας και την εβδομάδα έναρξης ενός έτους, όπως περιγράφεται παραπάνω στη μέθοδο DateDiff.
Το εξαγόμενο τμήμα για τη δεδομένη ημερομηνία/χρόνο.
print(bas.DatePart("ww", datetime.datetime(2005,12,31)
print(bas.DatePart('q', datetime.datetime(1999,12,30)
DateValue
Υπολογίζει μια τιμή ημερομηνίας από μια συμβολοσειρά ημερομηνίας.
svc.DateValue(date: str): datetime
ημερομηνία: Μια συμβολοσειρά που περιέχει την ημερομηνία που θα μετατραπεί σε αντικείμενο Ημερομηνίας.
Η συμβολοσειρά που μεταβιβάστηκε στο DateValue πρέπει να εκφράζεται σε μία από τις μορφές ημερομηνίας που ορίζονται από την τοπική ρύθμιση (δείτε ), ή χρήση της μορφής ημερομηνίας ISO "εεεε-μμ-ηη" (έτος, μήνας και ημέρα χωρίζονται με παύλες).
Η υπολογιζόμενη ημερομηνία.
dt = bas.DateValue("23-02-2011")
print(dt)
Format
Μετατρέπει έναν αριθμό σε συμβολοσειρά και, στη συνέχεια, τον μορφοποιεί σύμφωνα με τη μορφή που καθορίζετε.
svc.Format(expression: any, format = ''): str