ການບໍລິການ ScriptForge.Basic

ການບໍລິການ ScriptForge.Basic ສະເໜີຊຸດວິທີການຂອງ LibreOffice Basic ເພື່ອໃຫ້ປະຕິບັດການໃນສະພາບແວດລ້ອມຂອງ Python. ວິທີການຂອງການບໍລິການ Basic ຈະມີຮູບແບບຄຳສັ່ງ ແລະ ພຶດຕິກຳທີ່ຄືກັນກັບຟັງຊັນທີ່ມາພ້ອມກັບ Basic.

ຕົວຢ່າງທົ່ວໄປ:

   bas.MsgBox('ສະແດງຂໍ້ຄວາມນີ້ໃນກ່ອງຂໍ້ຄວາມຈາກສະຄຣິບ Python')
  

ການບໍລິການ ScriptForge.Basic ແມ່ນຈຳກັດໄວ້ສຳລັບສະຄຣິບ Python ເທົ່ານັ້ນ.

ການເອີ້ນໃຊ້ບໍລິການ

ກ່ອນທີ່ຈະໃຊ້ການບໍລິການ Basic, ໃຫ້ແຈ້ງການນຳເຂົ້າ (import) ວິທີການ CreateScriptService() ຈາກໂມດູນ scriptforge:

    from scriptforge import CreateScriptService
    bas = CreateScriptService("Basic")
  

ຄຸນສົມບັດ

ມີທາງເລືອກອື່ນໃນ Python ສຳລັບວິທີການທີ່ໝາຍດ້ວຍ (*).

CDate

ປ່ຽນສຳນວນຕົວເລກ ຫຼື ສາຍອັກຂະລະໃຫ້ເປັນອັອບເຈັກ datetime.datetime ດັ້ງເດີມຂອງ Python.

ວິທີການນີ້ເປີດໃຊ້ຟັງຊັນທີ່ມາພ້ອມກັບ 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 ໃຫ້ເປັນວັດຖຸ native ຂອງ Python ປະເພດ datetime.datetime.

svc.CDateFromUnoDateTime(unodate: uno): obj

unodate: ວັດຖຸວັນທີ/ເວລາແບບ UNO ໃນປະເພດໃດໜຶ່ງດັ່ງນີ້: com.sun.star.util.DateTime, com.sun.star.util.Date ຫຼື 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

ສົ່ງຄືນຊື່ເສັ້ນທາງໄຟລ໌ຂອງລະບົບ (system path) ສຳລັບ URL ແບບ file: ທີ່ລະບຸ.

svc.ConvertFromUrl(url: str): str

url: URL ແບບ file: ທີ່ຄົບຖ້ວນ (absolute URL).

ຊື່ເສັ້ນທາງໄຟລ໌ຂອງລະບົບ.

    filename = bas.ConvertFromUrl( "file:///C:/Program%20Files%20(x86)/LibreOffice/News.txt" )
    bas.MsgBox(filename)
  

ວິທີການ fileUrlToSystemPath() ຂອງ ໂມດູນ uno ຈະສົ່ງຄືນເສັ້ນທາງລະບົບໂດຍໃຊ້ຮູບແບບຄຳສັ່ງທີ່ຄືກັນ.

    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)
  

ວິທີການ systemPathToFileUrl() ຂອງ ໂມດູນ uno ຈະສົ່ງຄືນ 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 (UNO structure) ຕາມປະເພດທີ່ລະບຸ.

svc.CreateUnoStruct(unostructure: str): uno

unostructure: ຊື່ໂຄງສ້າງທີ່ຄົບຖ້ວນ ເຊັ່ນ com.sun.star.beans.Property ຫຼື com.sun.star.util.DateTime.

    date_struct = CreateUnoStruct('com.sun.star.util.DateTime')
  

ວິທີການ createUnoStruct() ຂອງ ໂມດູນ uno ຈະສ້າງອິນສະແຕນຊ໌ຂອງປະເພດໂຄງສ້າງ 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 ເຂົ້າໄປຈັກຄັ້ງ (ຖ້າເປັນບວກ) ຫຼື ລົບອອກຈັກຄັ້ງ (ຖ້າເປັນລົບ).

ວັນທີ: ຄ່າ 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: ສອງຄ່າ 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

date: ສະຕຣິງທີ່ບັນຈຸວັນທີທີ່ຈະຖືກແປງເປັນວັດຖຸ ວັນທີ.

ສະຕຣິງທີ່ສົ່ງໄປຫາ DateValue ຕ້ອງສະແດງຢູ່ໃນຮູບແບບວັນທີໃດໜຶ່ງທີ່ກຳນົດໂດຍການຕັ້ງຄ່າທ້ອງຖິ່ນ (locale) ຂອງທ່ານ (ເບິ່ງ - ພາສາ ແລະ ການຕັ້ງຄ່າທ້ອງຖິ່ນ - ທົ່ວໄປ) ຫຼື ໃຊ້ຮູບແບບວັນທີ ISO "yyyy-mm-dd" (ປີ, ເດືອນ ແລະ ວັນ ແຍກກັນດ້ວຍເຄື່ອງໝາຍຂີດກາງ).

ວັນທີທີ່ຄຳນວນໄດ້.

    dt = bas.DateValue("23-02-2011")
    print(dt)
  

Format

ແປງຕົວເລກໃຫ້ເປັນຂໍ້ຄວາມ, ແລ້ວຈັດຮູບແບບຕາມທີ່ທ່ານລະບຸ.

svc.Format(expression: any, format = ''): str

    txt = bas.Format(6328.2, '##.##0.00')
    print(txt)
  

GetDefaultContext

ສົ່ງຄືນຄອນເທັກ (context) ເລີ່ມຕົ້ນຂອງໂຮງງານບໍລິການຂະບວນການ (process service factory), ຖ້າມີຢູ່, ຖ້າບໍ່ດັ່ງນັ້ນຈະສົ່ງຄືນການອ້າງອີງແບບ null.

GetDefaultContext ແມ່ນທາງເລືອກອື່ນນອກຈາກວິທີການ getComponentContext() ທີ່ມີໃຫ້ໃຊ້ຈາກຕົວປ່ຽນທົ່ວໂລກ XSCRIPTCONTEXT ຫຼື ຈາກໂມດູນ uno.py.

svc.GetDefaultContext(): uno

ຄອນເທັກສ່ວນປະກອບເລີ່ມຕົ້ນຈະຖືກໃຊ້ ເມື່ອມີການສ້າງອິນສະແຕນຊ໌ການບໍລິການຜ່ານ XMultiServiceFactory. ເບິ່ງບົດ Professional UNO ໃນ Developer's Guide ທີ່ api.libreoffice.org ສຳລັບຂໍ້ມູນເພີ່ມເຕີມ.

    ctx = bas.GetDefaultContext()
  

GetGuiType

ສົ່ງຄືນຄ່າຕົວເລກທີ່ລະບຸສ່ວນຕິດຕໍ່ຜູ້ໃຊ້ແບບກຣາບຟິກ. ຟັງຊັນນີ້ມີໄວ້ເພື່ອຄວາມເຂົ້າກັນໄດ້ກັບລຸ້ນກ່ອນໆເທົ່ານັ້ນ.

ເບິ່ງວິທີການ system() ຈາກໂມດູນ Python platform ເພື່ອ ລະບຸລະບົບປະຕິບັດການ.

svc.GetGuiType(): int

    n = bas.GetGuiType()
  

ຄຳແນະນຳການຂຽນສະຄຣິບທີ່ມີປະສິດທິພາບກວ່າ ມີໃຫ້ສຶກສາຢູ່ທີ່ໜ້າຊ່ວຍເຫຼືອ ການລະບຸລະບົບປະຕິບັດການ.

• ບໍລິການ ScriptForge.Platform ໃຫ້ຂໍ້ມູນຄຸນສົມບັດຕ່າງໆກ່ຽວກັບສະພາບແວດລ້ອມ ແລະ ບໍລິບົດຂອງການເຮັດວຽກໃນປັດຈຸບັນ, ລວມທັງການກວດຫາແພລັດຟອມ.

• ການລະບຸຊື່ລະບົບປະຕິບັດການຢ່າງລະອຽດ ສາມາດໃຊ້ໄດ້ຈາກສູດ Calc INFO("system").

GetPathSeparator

ສົ່ງຄືນຕົວຂັ້ນໄດເຣັກທໍຣີຕາມລະບົບປະຕິບັດການ ທີ່ໃຊ້ເພື່ອລະບຸເສັ້ນທາງໄຟລ໌.

ໃຊ້ os.pathsep ຈາກໂມດູນ Python os ເພື່ອ ລະບຸຕົວຂັ້ນເສັ້ນທາງ.

svc.GetPathSeparator(): str

    sep = bas.GetPathSeparator()
  

GetSystemTicks

ສົ່ງຄືນຈຳນວນ system ticks ທີ່ສະໜອງໃຫ້ໂດຍລະບົບປະຕິບັດການ. ທ່ານສາມາດໃຊ້ຟັງຊັນນີ້ເພື່ອປັບແຕ່ງບາງຂະບວນການໃຫ້ດີຂຶ້ນ. ໃຊ້ວິທີການນີ້ເພື່ອປະມານເວລາເປັນມິລິວິນາທີ:

svc.GetSystemTicks(): int

    ticks_ini = bas.GetSystemTicks()
    time.sleep(1)
    ticks_end = bas.GetSystemTicks()
    bas.MsgBox("{} - {} = {}".format(ticks_end, ticks_ini,ticks_end - ticks_ini))
  

GlobalScope.BasicLibraries

ສົ່ງຄືນວັດຖຸ UNO ທີ່ປະກອບມີທຸກຄັງສຳນວນ ແລະ ໂມດູນ Basic ທີ່ໃຊ້ຮ່ວມກັນ.

ເມທອດນີ້ແມ່ນສິ່ງທີ່ທຽບເທົ່າໃນ Python ຂອງ GlobalScope.BasicLibraries ໃນສະຄຣິບ Basic.

svc.GlobalScope.BasicLibraries(): uno

com.sun.star.script.XLibraryContainer

ຕົວຢ່າງຕໍ່ໄປນີ້ຈະໂຫລດໄລບຣາຣີ Gimmicks Basic ຖ້າມັນຍັງບໍ່ທັນໄດ້ຖືກໂຫລດເທື່ອ.

    libs = bas.GlobalScope.BasicLibraries()
    if not libs.isLibraryLoaded("Gimmicks"):
        libs.loadLibrary("Gimmicks")
  

GlobalScope.DialogLibraries

ສົ່ງຄືນວັດຖຸ UNO ທີ່ບັນຈຸໄລບຣາຣີກ່ອງໂຕ້ຕອບທີ່ໃຊ້ຮ່ວມກັນທັງໝົດ.

ເມທອດນີ້ແມ່ນສິ່ງທີ່ທຽບເທົ່າໃນ Python ຂອງ GlobalScope.DialogLibraries ໃນສະຄຣິບ Basic.

svc.GlobalScope.DialogLibraries(): uno

com.sun.star.comp.sfx2.DialogLibraryContainer

ຕົວຢ່າງຕໍ່ໄປນີ້ຈະສະແດງກ່ອງຂໍ້ຄວາມທີ່ມີຊື່ຂອງໄລບຣາຣີກ່ອງໂຕ້ຕອບທີ່ມີຢູ່ທັງໝົດ.

    dlg_libs = bas.GlobalScope.DialogLibraries()
    lib_names = dlg_libs.getElementNames()
    bas.MsgBox("\n".join(lib_names))
  

InputBox

svc.InputBox(prompt: str, [title: str], [default: str], [xpostwips: int, ypostwips: int]): str

String

    txt = s.InputBox('ກະລຸນາປ້ອນຂໍ້ຄວາມ:', "ຮຽນຜູ້ໃຊ້")
    s.MsgBox(txt, s.MB_ICONINFORMATION, "ການຢືນຢັນຂໍ້ຄວາມ")
  

ສຳລັບຂໍ້ມູນລະອຽດ ກະລຸນາເບິ່ງທີ່ Input/Output to Screen with Python ໃນ Wiki.

MsgBox

ສະແດງກ່ອງໂຕ້ຕອບທີ່ມີຂໍ້ຄວາມ ແລະ ສົ່ງຄືນຄ່າທີ່ເປັນທາງເລືອກ.
ຄ່າຄົງທີ່ MB_xx ຊ່ວຍລະບຸປະເພດຂອງກ່ອງໂຕ້ຕອບ, ຈຳນວນ ແລະ ປະເພດຂອງປຸ່ມທີ່ຈະສະແດງ, ລວມທັງປະເພດໄອຄອນ. ໂດຍການບວກຄ່າຂອງພວກມັນເຂົ້າກັນ ຈະເຮັດໃຫ້ເກີດເປັນຮູບແບບບິດ ທີ່ກຳນົດລັກສະນະຂອງກ່ອງໂຕ້ຕອບ MsgBox.

bas.MsgBox(prompt: str, [buttons: int], [title: str])[: int]

ຕົວເລກຖ້ວນທີ່ເປັນທາງເລືອກ ຕາມລາຍລະອຽດໃນຄຸນສົມບັດ IDxx ຂ້າງເທິງ.

    txt = s.InputBox('ກະລຸນາປ້ອນຂໍ້ຄວາມ:', "ຮຽນຜູ້ໃຊ້")
    s.MsgBox(txt, s.MB_ICONINFORMATION, "ການຢືນຢັນຂໍ້ຄວາມ")
  

ສຳລັບຂໍ້ມູນລະອຽດ ກະລຸນາເບິ່ງທີ່ Input/Output to Screen with Python ໃນ Wiki.

Now

ສົ່ງຄືນວັນທີ ແລະ ເວລາປັດຈຸບັນຂອງລະບົບເປັນວັດຖຸ native ຂອງ Python ປະເພດ datetime.datetime.

svc.Now(): datetime

    bas.MsgBox(bas.Now(), bas.MB_OK, "Now")
  

RGB

ສົ່ງຄືນຄ່າສີເປັນຕົວເລກຖ້ວນ ທີ່ປະກອບດ້ວຍສ່ວນປະກອບຂອງສີແດງ, ສີຂຽວ, ແລະ ສີນ້ຳເງິນ.

svc.RGB(red:int, green: int, blue: int): int

red: ນິພົດຈຳນວນຖ້ວນໃດໜຶ່ງທີ່ແທນສ່ວນປະກອບສີແດງ (0-255) ຂອງສີປະສົມ.

green: ນິພົດຈຳນວນຖ້ວນໃດໜຶ່ງທີ່ແທນສ່ວນປະກອບສີຂຽວ (0-255) ຂອງສີປະສົມ.

blue: ນິພົດຈຳນວນຖ້ວນໃດໜຶ່ງທີ່ແທນສ່ວນປະກອບສີຟ້າ (0-255) ຂອງສີປະສົມ.

ຄ່າ Long ທີ່ໄດ້ຮັບແມ່ນການຄິດໄລ່ຕາມສູດດັ່ງນີ້:
Result = red×65536 + green×256 + blue.

ພາຍໃຕ້ໂໝດການເຂົ້າກັນໄດ້ກັບ VBA (Option VBASupport 1), ຄ່າ Long ຈະຖືກຄິດໄລ່ເປັນ
Result = red + green×256 + blue×65536
ເບິ່ງ ຟັງຊັນ RGB [VBA]

ກ່ອງໂຕ້ຕອບຕົວເລືອກສີ ຊ່ວຍໃນການຄິດໄລ່ສ່ວນປະກອບສີແດງ, ສີຂຽວ ແລະ ສີຟ້າ ຂອງສີປະສົມ. ການປ່ຽນສີຂໍ້ຄວາມ ແລະ ການເລືອກ ສີກຳນົດເອງ ຈະສະແດງກ່ອງໂຕ້ຕອບຕົວເລືອກສີ.

Integer

    YELLOW = bas.RGB(255,255,0)
  

Xray

ກວດສອບວັດຖຸ UNO ຫຼື ຕົວປ່ຽນ.

svc.Xray(obj: any)

obj: ຕົວປ່ຽນ ຫຼື ວັດຖຸ UNO.

    bas.Xray(bas.StarDesktop)
  

ຣູທີນ ຫຼື ຕົວລະບຸ Basic ຂອງ ScriptForge ທັງໝົດທີ່ຂຶ້ນຕົ້ນດ້ວຍເຄື່ອງໝາຍຂີດກ້ອງ "_" ແມ່ນສະຫງວນໄວ້ສຳລັບໃຊ້ພາຍໃນ. ພວກມັນບໍ່ໄດ້ມີໄວ້ໃຫ້ໃຊ້ໃນມາໂຄຣ Basic ຫຼື ສະຄຣິບ Python.