ScriptForge . Basic serbisyo

Ang ScriptForge.Basic nagmumungkahi ang serbisyo ng isang koleksyon ng LibreOfficeDev 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 LibreOfficeDev application.

ThisComponent

Mayroon

UNO
bagay

Kung ang kasalukuyang bahagi ay tumutukoy sa isang LibreOfficeDev 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


note

Umiiral ang mga alternatibong Python para sa mga pamamaraan na minarkahan ng (*).


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.

Uri ng pagbabalik:

Isang pangalan ng file ng path ng system.

Halimbawa:


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

uno module fileUrlToSystemPath() method ay nagbabalik ng path ng system gamit ang magkaparehong syntax.



    import uno
    filename = uno.fileUrlToSystemPath( "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.

Uri ng pagbabalik:

A file: URL bilang isang string.

Halimbawa:


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

uno module systemPathToFileUrl() method ay nagbabalik ng URL ng file para sa ibinigay na path ng system.



    from uno import systemPathToFileUrl as ConvertToUrl
    filename = ConvertToUrl( 'C:\Program Files(x86)\LibreOffice\News.txt' )
    bas.MsgBox(filename)
  

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')
  
tip

uno module createUnoStruct() method ay lumilikha ng isang instance ng isang Uno structure type.



    import uno
    p = uno.createUnoStruct( 'com.sun.star.beans.Property' )
    bas.MsgBox(p)
  

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.

Uri ng pagbabalik:

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


Uri ng pagbabalik:

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.

Uri ng pagbabalik:

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).


Uri ng pagbabalik:

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.

format: String that specifies the format code for the number. If format is omitted, the Format function works like the LibreOfficeDev Basic Str() function.

Uri ng pagbabalik:

Text string.

Mga Code sa Pag-format

In BASIC, a format code can be divided into three sections that are separated by semicolons. The first part defines the format for positive values, the second part for negative values, and the third part for zero. If you only specify one format code, it applies to all numbers.

Maaari mong itakda ang lokal na ginagamit para sa pagkontrol sa pag-format ng mga numero, petsa at pera sa LibreOfficeDev 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.

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

Code

Description

0

If expression has a digit at the position of the 0 in the format code, the digit is displayed, otherwise a zero is displayed.

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.

#

If expression contains a digit at the position of the # placeholder in the format code, the digit is displayed, otherwise nothing is displayed at this position.

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.

. (period)

The decimal placeholder determines the number of decimal places to the left and right of the 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.

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.

%

Multiplies the expressionby 100 and inserts the percent sign (%) where the expression appears in the format code.

E- E+ e- e+

If the format code contains at least one digit placeholder (0 or #) to the right of the symbol E-, E+, e-, or e+, the expression is formatted in the scientific or exponential format. The letter E or e is inserted between the number and the exponent. The number of placeholders for digits to the right of the symbol determines the number of digits in the 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+.

- + $ ( ) space

: A plus (+), minus (-), dollar ($), space, or brackets entered directly in the format code is displayed as a literal character.

\

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

The backslash displays the next character in the format 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 (@, &, <, >, !).


Predefined formats

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.

Code

Description

"<"

Convert expression to lower case

">"

Convert expression to upper case.

"c" or "General Date"

Returns the numeric expression in short date format, optionally with "H:MM:SS AM/PM". If expression is a string, returns the string.

"n"

Returns the minute of the numeric expression, with 1 or 2 digits.

"nn"

Returns the minute of the numeric expression with two digits.

"w"

Returns the week day of the numeric expression. 1 is Sunday and 7 is Saturday.

"General Number"

Returns the numeric expression with 12 digits (0.############).

"Currency"

Returns the numeric expression in the currency of the locale.

"Fixed"

Returns the numeric expression with 2 decimal places (0.00).

"Standard"

Returns the numeric expression with thousands separators and 2 decimals (@0.00).

"Percent"

Returns the numeric expression as percent value (0.00%).

"Scientific"

Returns the numeric expression in scientific notation (#.00E+00);

"Yes/No"

Returns "Yes" if the numeric expression is not equal to zero, "No" otherwise. "Yes" and "No" are localized.

"True/False"

Returns "True" if the numeric expression is not equal to zero, "False" otherwise. "True" and "False" are localized.

"On/Off"

Returns "On" if the numeric expression is not equal to zero, "Off" otherwise. "On" and "Off" are localized.

"Long Date" or "dddddd"

Returns the numeric expression in system long date format, and depends on the locale.

"Medium Date"

Returns the numeric expression in date format DD-MMM-YY, and depends on the locale.

"Short Date" or "ddddd"

Returns the numeric expression in system short date format, and depends on the locale.

"Long Time" or "ttttt"

Returns the numeric expression in system long time format, and depends on the locale("H:MM:SS AM/PM").

"Medium Time"

Returns the numeric expression in system medium time format, and depends on the locale (HH:MM AM/PM)

"Short Time"

Returns the numeric expression in system short time format, and depends on the locale (HH:MM).


Maaari mong itakda ang lokal na ginagamit para sa pagkontrol sa pag-format ng mga numero, petsa at pera sa LibreOfficeDev 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

Uri ng pagbabalik:

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()
  
note

Wiser script instructions are available from Identifying the operating system help page.


tip

• ScriptForge.Platform service provides a collection of properties about the current execution environment and context, that include platform detection.

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


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

Uri ng pagbabalik:

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

Uri ng pagbabalik:

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 LibreOfficeDev.

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

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

Uri ng pagbabalik:

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:

Uri ng pagbabalik:

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.


Uri ng pagbabalik:

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.