Tjenesten SFDialogs. Dialog

Tjenesten Dialog bidrager til håndteringen af dialoger, der er oprettet med Basics Dialog-redigering. Hver forekomst af den aktuelle klasse repræsenter et enkelt dialogfelt, der vises for brugeren.

Et dialogfelt kan vises i modal eller ikke-modal tilstand.

I modal tilstand vises feltet og udførelsen af makro-processen er udsat, indtil der trykkes på en af knapperne OK eller Annuller. I mellemtiden kan brugerhandlinger, udført på feltet, udløse bestemte handlinger.

I ikke-modal tilstand "Flyder" dialogfeltet på brugerskrivebordet og udførelsen af makroprocessen fortsætter normalt. En ikke-modal dialog lukker, når den afsluttes med metoden Terminate() eller når sessionen LibreOffice Slutter. Knappen Luk vindue er inaktiv i ikke-modale dialoger.

Et dialogfelt forsvinger fra hukommelsen efter dets udtrykkelige afslfutning.

Tjenesten SFDialogs.Dialog er nært beslægtet med tjenesten SFDialogs.DialogControl.

Kald og brug af tjeneste

Før brug af tjenesten Dialog skal biblioteket ScriptForge være indlæst eller importeret:

• Basic-makroer kræver, at biblioteket ScriptForge indlæses med følgende udtryk:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• Python-scripts kræver import af scriptforge-modulet:
from scriptforge import CreateScriptService

Tjenesten Dialog kaldes med metoden CreateScriptService. Den kræver tre positions-argumenter til at angive dialogfeltet, der skal aktiveres:

Container: "GlobalScope" til forudinstallerede biblioteker eller et vinduesnavn som defineret af tjenesten ScriptForge.UI. Standardværdien tom streng "" står for det aktuelle dokument.

Bibliotek: Biblioteksnavn med skelnen mellem Store og små bogstaver, der findes i containeren. Standardværdien er "Standard".

DialogNavn: En streng, hvor der skelnes mellem Store og små bogstaver, og som betegner dialogen.

LibreOffice Basic- og Python-eksemplerne herunder viser dialogen dlgConsole, der tilhører det delte bibliotek ScriptForge:


      Dim oDlg As Object, lButton As Long
      Dim Container As String, Library As String, DialogName As String
      Set oDlg = CreateScriptService("SFDialogs.Dialog", "GlobalScope", "ScriptForge", "dlgConsole")
      '... initialisering af kontrolelementer skrives her...
      lButton = oDlg.Execute()
      'Standard tilstand = Modal
      If lButton = oDlg.OKBUTTON Then
      '... Proceskontrollerer og gør, hvad der er nødvendigt her
      End If
      oDlg.Terminate()

Eller med Python:


    dlg = CreateScriptService('SFDialogs.Dialog', 'GlobalScope', 'ScriptForge', 'dlgConsole')
    # ... initialisering af kontroller skrives her...
    rc = dlg.Execute()
    # Standard-tilstand er Modal
    if rc == dlg.OKBUTTON:
        # ... Behandl kontroller og gør, hvad der er nødvendigt her
    dlg.Terminate()

Alternativt kan en forekomst af Dialog hentes via tjenesten SFDialogs.DialogEvent, forudsat at dialogen blevinitieret med tjenesten Dialog. DialogEvent returnerer den forekomst af tjenesten SFDialogs.Dialog, der udløste hændelsen.


    Sub SomeEvent(ByRef poEvent As Object)
        Dim oDlg As Object
        Set oDlg = CreateScriptService("SFDialogs.DialogEvent", poEvent)
    End Sub

med Python:


    def some_event(event: uno):
        dlg = CreateScriptService("SFDialogs.DialogEvent", event)

Bemærk, at i de tidligere eksempler kan præfikset "SFDialogs." udelades, når det skønnes passende.

Egenskaber

Navn	Skrivebeskyttet	Type	Beskrivelse
OKBUTTON	Ja	Integer	Værdi = 1. Der blev trykket på en OK-knap.
CANCELBUTTON	Ja	Integer	Værdi = 1. Der blev trykket på en OK-knap.
Caption	Nej	String	Angiv dialogens titel.
Height	Nej	Long	Angiv højden på dialogfeltet.
Modal	Ja	Boolean	Angiver, om dialogfeltet aktuelt er i udførelse i modal tilstand.
Name	Ja	String	Dialogens navn
Page	Nej	Integer	En dialog kan have flere sider, som brugeren kan gå igennem trin for trin. Dialogobjektets sideegenskab definerer, hvilken af dialogens sider, der er aktiv.
Visible	Nej	Boolean	Angiv, om dialogfeltet er synligt på skrivebordet. Som standard er det ikke synligt, før metoden Execute() køres og synligt derefter.
XDialogModel	Ja	UNO object	Det UNO-objekt, der repræsenter dialogenmodellen. Se detaljeret information i XControlModel og UnoControlDialogModel i APIens (Application Programming Interface) dokumentation.
XDialogView	Ja	UNO object	Det UNO-objekt, der repræsenter dialogvisningen. Se detaljeret information i XControl og UnoControlDialog i APIens (Application Programming Interface) dokumentation.
Width	Nej	Long	Angiv dialogfeltets bredde.

Hændelsesegenskaber

Returns a URI string with the reference to the script triggered by the event. Read its specification in the scripting framework URI specification.

Navn	Skrivebeskyttet	Beskrivelse af Basic IDE
OnFocusGained	Ja	Når fokus modtages
OnFocusLost	Ja	Når fokus mistes
OnKeyPressed	Ja	Tast trykket
OnKeyReleased	Ja	Tast sluppet
OnMouseDragged	Ja	Mus flyttet mens tast trykkes
OnMouseEntered	Ja	Mus indenfor
OnMouseExited	Ja	Mus udenfor
OnMouseMoved	Ja	Mus flyttet
OnMousePressed	Ja	Museknap trykket
OnMouseReleased	Ja	Museknap sluttet

	Metoder
Activate Center Controls	EndExecute Execute GetTextsFromL10N	Resize Terminate

Activate

Sæt fokus på den aktuelle forekomst af Dialog. Returner True, hvis fokuseringen lykkedes.

Den metode kaldes fra en dialog, en kontrolhændelse eller når der vises en dialog i ikke-modal tilstand.

Syntaks:

svc.Activate(): bool

Eksempel:


      Dim oDlg As Object
      Set oDlg = CreateScriptService(,, "myDialog")
      oDlg.Execute()
      ' ...
      oDlg.Activate()

Både Python- og LibreOffice-Basic-eksempler antager, at dialogen er gemt i det aktuelle dokuments Standard-bibliotek.


     dlg = CreateScriptService(,,'myDialog')
     dlg.Execute()
     # ...
     dlg.Activate()

Center

Centrerer den aktuelle forekomst af dialogen midt på det ordnede vindue. Uden argumenter centrerer metoden dialogen i midten af det aktuelle vindue.

Returnerer