ScriptForge . Basic serbisyo

Ang ScriptForge.Basic nagmumungkahi ang serbisyo ng isang koleksyon ng LibreOffice Basic na mga pamamaraan na isasagawa sa isang konteksto ng Python. Basic Ang mga pamamaraan ng serbisyo ay nagpaparami ng eksaktong syntax at pag-uugali ng mga Basic na builtin na function.

Karaniwang halimbawa:


   bas.MsgBox('Ipakita ang text na ito sa isang message box mula sa Python script')
  
warning

ScriptForge . Basic Ang serbisyo ay limitado sa mga script ng Python.


Panawagan sa serbisyo

note

Bago gamitin ang Basic serbisyo, i-import ang CreateScriptService() pamamaraan mula sa scriptforge module:



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

Mga Katangian

Pangalan

ReadOnly

Type

Mga nilalaman

MB_OK, MB_OKCANCEL, MB_RETRYCANCEL, MB_YESNO, MB_YESNOCANCEL

Mayroon

Integer

Mga Halaga: 0, 1, 5, 4, 3

MB_ICONEXCLAMATION, MB_ICONINFORMATION, MB_ICONQUESTION, MB_ICONSTOP

Mayroon

Integer

Mga Halaga: 48, 64, 32, 16

MB_ABORTRETRYIGNORE, MB_DEFBUTTON1, MB_DEFBUTTON2, MB_DEFBUTTON3

Mayroon

Integer

Mga Halaga: 2, 128, 256, 512

IDABORT, IDCANCEL, IDIGNORE, IDNO, IDOK, IDRETRY, IDYES

Mayroon

Integer

Mga Halaga: 3, 2, 5, 7, 1, 4, 6
Nagpapahiwatig ng mga constant MsgBox piniling pindutan.

StarDesktop

Mayroon

UNO
bagay

Ibinabalik ang StarDesktop bagay na kumakatawan sa LibreOffice application.

ThisComponent

Mayroon

UNO
bagay

Kung ang kasalukuyang bahagi ay tumutukoy sa isang LibreOffice na dokumento, ibinabalik ng pamamaraang ito ang UNO object na kumakatawan sa dokumento. Nagbabalik ang ari-arian na ito wala kapag ang kasalukuyang bahagi ay hindi tumutugma sa isang dokumento.

ThisDatabaseDocument

Mayroon

UNO
bagay

Kung ang script ay isinasagawa mula sa isang Base na dokumento o alinman sa mga subcomponents nito ibabalik ng pamamaraang ito ang pangunahing bahagi ng Base instance. Nagbabalik ang ari-arian na ito wala kung hindi.


Listahan ng Mga Paraan sa Pangunahing Serbisyo

CDate
CDateFromUnoDateTime
CDateToUnoDateTime
ConvertFromUrl
ConvertToUrl
CreateUnoService
CreateUnoStruct
DateAdd

DateDiff
DatePart
DateValue
Format
GetDefaultContext
GetGuiType
GetPathSeparator
GetSystemTicks

GlobalScope.BasicLibraries
GlobalScope.DialogLibraries
InputBox
MsgBox
Now
RGB
Xray


CDate

Kino-convert ang isang numeric na expression o isang string sa a datetime . datetime Python native object.

note

Inilalantad ng pamamaraang ito ang Basic builtin function CDate sa mga script ng Python.


Syntax:

svc.CDate(expression: any): obj

Mga Parameter:

pagpapahayag : isang numeric na expression o isang string na kumakatawan sa isang petsa.

Kapag nag-convert ka ng string expression, ang petsa at oras ay dapat na ilagay sa isa sa mga pattern ng pagtanggap ng petsa na tinukoy para sa iyong setting ng lokal (tingnan ang - Mga Wika at Lokal - Pangkalahatan ) o sa format ng petsa ng ISO (sandali, ang format na ISO lang na may mga gitling, hal. "2012-12-31" ang tinatanggap). Sa mga numeric na expression, ang mga halaga sa kaliwa ng decimal ay kumakatawan sa petsa, simula sa Disyembre 31, 1899. Ang mga halaga sa kanan ng decimal ay kumakatawan sa oras.

Halimbawa:


    d = bas.CDate(1000.25)
    bas.MsgBox(str(d)) # 1902-09-26 06:00:00
    bas.MsgBox(d.year) # 1902
  

CDateFromUnoDateTime

Kino-convert ang representasyon ng petsa/oras ng UNO sa a datetime.datetime Python native object.

Syntax:

svc.CDateFromUnoDateTime(unodate: uno): obj

Mga Parameter:

unodate : Isang bagay sa petsa/oras ng UNO ng isa sa mga sumusunod na uri: com.sun.star.util.DateTime , com.sun.star.util.Date o com.sun.star.util.Time

Halimbawa:

Ang sumusunod na halimbawa ay lumilikha ng a com.sun.star.util.DateTime bagay at ginagawang a datetime.datetime bagay na Python.


    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

Kino-convert ang representasyon ng petsa sa isang com.sun.star.util.DateTime bagay.

Syntax:

svc.CDateToUnoDateTime(date: obj): uno

Mga Parameter:

petsa : Isang Python date/time object ng isa sa mga sumusunod na uri: datetime.datetime , datetime.date , datetime.time , lumutang (time.time) o oras.struct_time .

Halimbawa:


    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

Nagbabalik ng pangalan ng file ng path ng system para sa ibinigay file: URL.

Syntax:

svc.ConvertFromUrl(url: str): str

Mga Parameter:

url : Isang ganap file: URL.

Ibinalik na halaga:

Isang pangalan ng file ng path ng system.

Halimbawa:


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

ConvertToUrl

Nagbabalik a file: URL para sa ibinigay na path ng system.

Syntax:

svc.ConvertToUrl(systempath: str): str

Mga Parameter:

systempath : Isang pangalan ng file ng system bilang isang string.

Ibinalik na halaga:

A file: URL bilang isang string.

Halimbawa:


    url = bas.ConvertToUrl( 'C:\Program Files(x86)\LibreOffice\News.txt')
    bas.MsgBox(url)
  

CreateUnoService

Nag-i-instantiate ng serbisyo ng UNO sa ProcessServiceManager .

Syntax:

svc.CreateUnoService(servicename: str): uno

Mga Parameter:

pangalan ng serbisyo : Isang ganap na kwalipikadong pangalan ng serbisyo tulad ng com.sun.star.ui.dialogs.FilePicker o com.sun.star.sheet.FunctionAccess .

Halimbawa:


    dsk = bas.CreateUnoService('com.sun.star.frame.Desktop')
  

CreateUnoStruct

Nagbabalik ng instance ng isang istruktura ng UNO ng tinukoy na uri.

Syntax:

svc.CreateUnoStruct(unostructure: str): uno

Mga Parameter:

unostructure : Isang ganap na kwalipikadong pangalan ng istraktura tulad ng com.sun.star.beans.Property o com.sun.star.util.DateTime .

Halimbawa:


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

DateAdd

Nagdaragdag ng petsa o agwat ng oras sa isang ibinigay na petsa/oras nang ilang beses at ibinabalik ang resultang petsa.

Syntax:

svc.DateAdd(interval: str, number: num, date: datetime): datetime

Mga Parameter:

pagitan : Isang string na expression mula sa sumusunod na talahanayan, na tumutukoy sa petsa o pagitan ng oras.

pagitan (halaga ng string)

Paliwanag

yyyy

taon

q

quarter

m

Ay

y

Araw ng taon

w

Araw ng Linggo

ww

Linggo ng taon

d

Araw

h

Oras

n

minuto

s

Pangalawa


numero : Isang numerical na expression na tumutukoy kung gaano kadalas ang pagitan ang halaga ay idaragdag kapag positibo o ibawas kapag negatibo.

petsa : Isang binigay datetime.datetime halaga, ang pagitan idadagdag ang halaga numero beses dito datetime.datetime halaga.

Ibinalik na halaga:

A datetime.datetime halaga.

Halimbawa:


    dt = datetime.datetime(2004, 1, 31)
    dt = bas.DateAdd("m", 1, dt)
    print(dt)
  

DateDiff

Ibinabalik ang bilang ng mga agwat ng petsa o oras sa pagitan ng dalawang ibinigay na halaga ng petsa/oras.

Syntax:

svc.DateDiff(interval: str, date1: datetime, date2: datetime, firstdayofweek = 1, firstweekofyear = 1): int

Mga Parameter:

pagitan : Isang string na expression na tumutukoy sa pagitan ng petsa, gaya ng nakadetalye sa itaas DateAdd paraan.

petsa1 , petsa2 : Ang dalawa datetime.datetime mga halagang ihahambing.

unang araw ng linggo : Isang opsyonal na parameter na tumutukoy sa araw ng pagsisimula ng isang linggo.

halaga ng unang araw ng linggo

Paliwanag

0

Gamitin ang default na halaga ng system

1

Linggo (default)

%1$s at %2$s

Lunes

3

Martes

4

Miyerkules

5

Huwebes

6

Biyernes

7

Sabado


unang linggo ng taon : Isang opsyonal na parameter na tumutukoy sa panimulang linggo ng isang taon.

halaga ng unang linggo ng taon

Paliwanag

0

Gamitin ang default na halaga ng system

1

Ang Linggo 1 ay ang linggong may Enero, ika-1 (default)

%1$s at %2$s

Ang Linggo 1 ay ang unang linggo na naglalaman ng apat o higit pang araw ng taong iyon

3

Ang Linggo 1 ay ang unang linggo na naglalaman lamang ng mga araw ng bagong taon


Ibinalik na halaga:

Isang numero.

Halimbawa:


    date1 = datetime.datetime(2005,1, 1)
    date2 = datetime.datetime(2005,12,31)
    diffDays = bas.DateDiff('d', date1, date2)
    print(diffDays)
  

DatePart

Ang PetsaPart function ay nagbabalik ng isang tinukoy na bahagi ng isang petsa.

Syntax:

svc.DatePart(interval: str, date: datetime, firstdayofweek = 1, firstweekofyear = 1): int

Mga Parameter:

pagitan : Isang string na expression na tumutukoy sa pagitan ng petsa, gaya ng nakadetalye sa itaas DateAdd paraan.

petsa : Ang petsa/oras kung saan kinakalkula ang resulta.

unang araw ng linggo, unang linggo ng taon : mga opsyonal na parameter na ayon sa pagkakabanggit ay tumutukoy sa araw ng pagsisimula ng isang linggo at sa panimulang linggo ng isang taon, gaya ng nakadetalye sa itaas DateDiff paraan.

Ibinalik na halaga:

Ang nakuhang bahagi para sa ibinigay na petsa/oras.

Halimbawa:


    print(bas.DatePart("ww", datetime.datetime(2005,12,31)
    print(bas.DatePart('q', datetime.datetime(1999,12,30)
  

DateValue

Kinakalkula ang halaga ng petsa mula sa string ng petsa.

Syntax:

svc.DateValue(date: str): datetime

Mga Parameter:

petsa : Isang string na naglalaman ng petsa na mako-convert sa a Petsa bagay.

note

Ang string ay dumaan sa DateValue dapat ipahayag sa isa sa mga format ng petsa na tinukoy ng setting ng iyong lokal (tingnan ang - Mga Wika at Lokal - Pangkalahatan ) o gamit ang format ng petsa ng ISO na "yyyy-mm-dd" (taon, buwan at araw na pinaghihiwalay ng mga gitling).


Ibinalik na halaga:

Ang nakalkulang petsa.

Halimbawa:


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

Format

Kino-convert ang isang numero sa isang string, at pagkatapos ay i-format ito ayon sa format na iyong tinukoy.

Syntax:

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

Mga Parameter:

pagpapahayag : Numeric na expression na gusto mong i-convert sa isang na-format na string.

pormat : String na tumutukoy sa format code para sa numero. Kung pormat ay tinanggal, ang Format function ay gumagana tulad ng LibreOffice Basic Str() function.

Ibinalik na halaga:

Text string.

Mga Code sa Pag-format

Inilalarawan ng sumusunod na listahan ang mga code na maaari mong gamitin para sa pag-format ng isang numeric na expression:

0: Kung pagpapahayag ay may digit sa posisyon ng 0 sa pormat code, ang digit ay ipinapakita, kung hindi man ay isang zero ang ipapakita.

Kung pagpapahayag ay may mas kaunting mga digit kaysa sa bilang ng mga zero sa pormat code, (sa magkabilang panig ng decimal), ang mga nangunguna o sumusunod na mga zero ay ipinapakita. Kung ang pagpapahayag ay may mas maraming digit sa kaliwa ng decimal separator kaysa sa halaga ng mga zero sa pormat code, ang mga karagdagang digit ay ipinapakita nang walang pag-format.

Mga desimal na lugar sa pagpapahayag ay bilugan ayon sa bilang ng mga zero na lumilitaw pagkatapos ng decimal separator sa pormat code.

#: Kung pagpapahayag naglalaman ng digit sa posisyon ng # placeholder sa pormat code, ang digit ay ipinapakita, kung hindi, walang ipinapakita sa posisyong ito.

Gumagana ang simbolo na ito tulad ng 0, maliban na ang mga nangunguna o sumusunod na mga zero ay hindi ipinapakita kung mayroong higit pang # na character sa pormat code kaysa sa mga digit sa pagpapahayag . Tanging ang mga kaugnay na digit ng pagpapahayag ay ipinapakita.

.: Tinutukoy ng decimal placeholder ang bilang ng mga decimal na lugar sa kaliwa at kanan ng decimal separator.

Kung ang pormat Ang code ay naglalaman lamang ng # na placeholder sa kaliwa ng simbolong ito, ang mga numerong mas mababa sa 1 ay nagsisimula sa isang decimal separator. Upang palaging magpakita ng nangungunang zero na may mga fractional na numero, gamitin ang 0 bilang isang placeholder para sa unang digit sa kaliwa ng decimal separator.

%: Pinaparami ang pagpapahayag sa pamamagitan ng 100 at ipinapasok ang porsyentong tanda (%) kung saan ang pagpapahayag lumilitaw sa pormat code.

E- E+ e- e+ : Kung ang pormat naglalaman ang code ng hindi bababa sa isang digit na placeholder (0 o #) sa kanan ng simbolo na E-, E+, e-, o e+, ang pagpapahayag ay naka-format sa pang-agham o exponential na format. Ang titik E o e ay ipinasok sa pagitan ng numero at ng exponent. Tinutukoy ng bilang ng mga placeholder para sa mga digit sa kanan ng simbolo ang bilang ng mga digit sa exponent.

Kung negatibo ang exponent, direktang ipinapakita ang isang minus sign bago ang exponent na may E-, E+, e-, e+. Kung positibo ang exponent, ipinapakita lang ang plus sign bago ang mga exponent na may E+ o e+.

Ang libu-libong delimiter ay ipinapakita kung ang pormat naglalaman ang code ng delimiter na nakapaloob sa mga digit na placeholder (0 o #).

Ang paggamit ng isang tuldok bilang isang libo at decimal separator ay nakadepende sa rehiyonal na setting. Kapag direkta kang naglagay ng numero sa Basic source code, palaging gumamit ng tuldok bilang decimal delimiter. Ang aktwal na character na ipinapakita bilang isang decimal separator ay depende sa format ng numero sa iyong mga setting ng system.

- + $ ( ) espasyo: Isang plus (+), minus (-), dollar ($), space, o mga bracket na direktang ipinasok sa pormat code ay ipinapakita bilang isang literal na character.

Upang magpakita ng mga character maliban sa mga nakalista dito, dapat mo itong unahan ng backslash (\), o ilakip ito sa mga panipi (" ").

\ : Ipinapakita ng backslash ang susunod na character sa pormat code.

Mga tauhan sa pormat Ang code na may espesyal na kahulugan ay maipapakita lamang bilang literal na mga character kung ang mga ito ay pinangungunahan ng backslash. Ang backslash mismo ay hindi ipinapakita, maliban kung maglagay ka ng double backslash (\\) sa format code.

Ang mga character na dapat unahan ng backslash sa format code upang maipakita bilang literal na mga character ay mga character na nag-format ng petsa at oras (a, c, d, h, m, n, p, q, s, t, w , y, /, :), numeric-formatting na mga character (#, 0, %, E, e, kuwit, tuldok), at string-formatting na mga character (@, &, <, >, !).

Maaari mo ring gamitin ang mga sumusunod na paunang natukoy na mga format ng numero. Maliban sa "Pangkalahatang Numero" , ibinabalik ng lahat ng paunang natukoy na format na code ang numero bilang isang decimal na numero na may dalawang decimal na lugar.

Kung gumagamit ka ng mga paunang natukoy na format, ang pangalan ng format ay dapat na nakapaloob sa mga panipi.

Mga Paunang Natukoy na Format

Pangkalahatang Numero: Ang mga numero ay ipinapakita bilang ipinasok.

Pera: Naglalagay ng dollar sign sa harap ng numero at naglalagay ng mga negatibong numero sa mga bracket.

Naayos: Nagpapakita ng hindi bababa sa isang digit sa harap ng decimal separator.

Pamantayan: Nagpapakita ng mga numero na may separator ng libu-libong.

Porsiyento: I-multiply ang numero sa pamamagitan ng 100 at nagdaragdag ng isang porsyentong tanda sa numero.

Siyentipiko: Nagpapakita ng mga numero sa siyentipikong format (halimbawa, 1.00E+03 para sa 1000).

A pormat maaaring hatiin ang code sa tatlong seksyon na pinaghihiwalay ng mga semicolon. Tinutukoy ng unang bahagi ang format para sa mga positibong halaga, ang pangalawang bahagi para sa mga negatibong halaga, at ang ikatlong bahagi para sa zero. Kung isa lang ang tinukoy mo pormat code, nalalapat ito sa lahat ng numero.

Maaari mong itakda ang lokal na ginagamit para sa pagkontrol sa pag-format ng mga numero, petsa at pera sa LibreOffice Basic sa - Mga Wika at Lokal - Pangkalahatan . Sa Basic na format code, ang decimal point ( . ) ay palaging ginagamit bilang placeholder para sa decimal separator na tinukoy sa iyong lokal at papalitan ng kaukulang character.

Ang parehong naaangkop sa mga setting ng lokal para sa mga format ng petsa, oras at pera. Ang Basic format code ay bibigyang-kahulugan at ipapakita ayon sa iyong setting ng lokal.

Halimbawa:


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

GetDefaultContext

Ibinabalik ang default na konteksto ng pabrika ng serbisyo ng proseso, kung mayroon, kung hindi, nagbabalik ng null reference.

GetDefaultContext ay isang alternatibo sa getComponentContext() paraan na makukuha mula sa XSCRIPTCONTEXT global variable o mula sa uno.py modyul.

Syntax:

svc.GetDefaultContext(): uno

Ibinalik na halaga:

Ang default na konteksto ng bahagi ay ginagamit, kapag nag-instantiate ng mga serbisyo sa pamamagitan ng XMultiServiceFactory . Tingnan ang Propesyonal na UNO kabanata sa Gabay ng Developer sa api.libreoffice.org para sa karagdagang impormasyon.

Halimbawa:


    ctx = bas.GetDefaultContext()
  

GetGuiType

Nagbabalik ng numerical value na tumutukoy sa graphical na user interface. Ang function na ito ay ibinibigay lamang para sa backward compatibility sa mga nakaraang bersyon.

Sumangguni sa sistema() paraan mula sa plataporma Python module sa kilalanin ang operating system .

Syntax:

svc.GetGuiType(): int

Halimbawa:


    n = bas.GetGuiType()
  

GetPathSeparator

Ibinabalik ang operating system-dependent directory separator na ginamit upang tukuyin ang mga path ng file.

Gamitin os.pathsep mula sa os Python module sa tukuyin ang path separator .

Syntax:

svc.GetPathSeparator(): str

Halimbawa:


    sep = bas.GetPathSeparator()
  

GetSystemTicks

Ibinabalik ang bilang ng mga system ticks na ibinigay ng operating system. Maaari mong gamitin ang function na ito upang i-optimize ang ilang mga proseso. Gamitin ang paraang ito upang tantyahin ang oras sa millisecond:

Syntax:

svc.GetSystemTicks(): int

Halimbawa:


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

GlobalScope.BasicLibraries

Ibinabalik ang UNO object na naglalaman ng lahat ng nakabahaging Basic na library at module.

Ang pamamaraang ito ay katumbas ng Python sa GlobalScope . BasicLibraries sa Basic na mga script.

Syntax:

svc.GlobalScope.BasicLibraries(): uno

Ibinalik na halaga:

com.sun.star.script.XLibraryContainer

Halimbawa:

Nilo-load ng sumusunod na halimbawa ang Gimmicks Basic library kung hindi pa ito na-load.


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

GlobalScope.DialogLibraries

Ibinabalik ang UNO object na naglalaman ng lahat ng shared dialog library.

Ang pamamaraang ito ay katumbas ng Python sa GlobalScope . DialogLibraries sa mga Pangunahing script.

Syntax:

svc.GlobalScope.DialogLibraries(): uno

Ibinalik na halaga:

com.sun.star.comp.sfx2.DialogLibraryContainer

Halimbawa:

Ang sumusunod na halimbawa ay nagpapakita ng isang message box na may mga pangalan ng lahat ng available na dialog library.


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

InputBox

Syntax:

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

Mga Parameter:

prompt : String expression na ipinapakita bilang mensahe sa dialog box.

pamagat : String expression na ipinapakita sa title bar ng dialog box.

default : String expression na ipinapakita sa text box bilang default kung walang ibang input na ibinigay.

xpostwips : Integer na expression na tumutukoy sa pahalang na posisyon ng dialog. Ang posisyon ay isang ganap na coordinate at hindi tumutukoy sa window ng LibreOffice.

ypostwips : Integer na expression na tumutukoy sa patayong posisyon ng dialog. Ang posisyon ay isang ganap na coordinate at hindi tumutukoy sa window ng LibreOffice.

Kung xpostwips at ypostwips ay tinanggal, ang dialog ay nakasentro sa screen. Ang posisyon ay tinukoy sa twips .

Ibinalik na halaga:

String

Halimbawa:


    txt = s.InputBox('Mangyaring magpasok ng parirala:', "Minamahal na user")
    s.MsgBox(txt, s.MB_ICONINFORMATION, "Pagkumpirma ng parirala")
  
note

Para sa malalim na impormasyon mangyaring sumangguni sa Input/Output sa Screen gamit ang Python sa Wiki.


MsgBox

Nagpapakita ng dialog box na naglalaman ng mensahe at nagbabalik ng opsyonal na halaga.
Tumutulong ang mga constant ng MB_xx na tukuyin ang uri ng dialog, ang numero at uri ng mga button na ipapakita, kasama ang uri ng icon. Sa pamamagitan ng pagdaragdag ng kani-kanilang mga halaga ay bumubuo sila ng mga bit pattern, na tumutukoy sa MsgBox anyo ng diyalogo.

Syntax:

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

Mga Parameter:

prompt : String expression na ipinapakita bilang isang mensahe sa dialog box. Ang mga line break ay maaaring ipasok sa Chr$(13).

pamagat : String expression na ipinapakita sa title bar ng dialog. Kung tinanggal, ipinapakita ng title bar ang pangalan ng kaukulang aplikasyon.

mga pindutan : Anumang integer expression na tumutukoy sa uri ng dialog, pati na rin ang numero at uri ng mga button na ipapakita, at ang uri ng icon. mga pindutan kumakatawan sa isang kumbinasyon ng mga bit pattern, iyon ay, ang isang kumbinasyon ng mga elemento ay maaaring tukuyin sa pamamagitan ng pagdaragdag ng kani-kanilang mga halaga:

Ibinalik na halaga:

Isang opsyonal na integer gaya ng nakadetalye sa itaas IDxx ari-arian.

Halimbawa:


    txt = s.InputBox('Mangyaring magpasok ng parirala:', "Minamahal na user")
    s.MsgBox(txt, s.MB_ICONINFORMATION, "Pagkumpirma ng parirala")
  
note

Para sa malalim na impormasyon mangyaring sumangguni sa Input/Output sa Screen gamit ang Python sa Wiki.


Now

Ibinabalik ang kasalukuyang petsa at oras ng system bilang a datetime . datetime Python native object.

Syntax:

svc.Now(): datetime

Halimbawa:


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

RGB

Nagbabalik ng integer na value ng kulay na binubuo ng pula, berde, at asul na bahagi.

Syntax:

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

Mga Parameter:

pula : Anumang integer na expression na kumakatawan sa pulang bahagi (0-255) ng pinagsama-samang kulay.

berde : Anumang integer na expression na kumakatawan sa berdeng bahagi (0-255) ng pinagsama-samang kulay.

asul : Anumang integer na expression na kumakatawan sa asul na bahagi (0-255) ng pinagsama-samang kulay.

Ang resulta Mahaba Ang halaga ay kinakalkula gamit ang sumusunod na formula:
Resulta = pula×65536 + berde×256 + asul .

warning

Sa ilalim ng VBA compatibility mode ( Opsyon VBASupport 1 ), ang Mahaba ang halaga ay kinakalkula bilang
Resulta = pula + berde×256 + asul×65536
Tingnan mo RGB Function [VBA]


tip

Ang dialog ng tagapili ng kulay tumutulong sa pag-compute ng pula, berde at asul na bahagi ng isang pinagsama-samang kulay. Pagbabago ng kulay ng teksto at pagpili Pasadyang kulay ipinapakita ang dialog ng tagapili ng kulay.


Ibinalik na halaga:

Integer

Halimbawa:


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

Xray

Siyasatin ang mga bagay o variable ng Uno.

Syntax:

svc.Xray(obj: any)

Mga Parameter:

obj : Isang variable o UNO object.

Halimbawa:


    bas.Xray(bas.StarDesktop)
  
warning

Lahat ScriptForge Ang mga pangunahing gawain o identifier na may prefix na may underscore na character na "_" ay nakalaan para sa panloob na paggamit. Ang mga ito ay hindi nilalayong gamitin sa Basic macros o Python script.


Mangyaring suportahan kami!