Difference between revisions of "NL/Documentation/BASIC Guide/Events"
Line 82: | Line 82: | ||
;<tt>Muis verplaatst met ingedrukte toets</tt>:gebruiker sleept muis met ingedrukte toets | ;<tt>Muis verplaatst met ingedrukte toets</tt>:gebruiker sleept muis met ingedrukte toets | ||
;<tt>Muisknop ingedrukt</tt>:gebruiker drukt op een muisknop | ;<tt>Muisknop ingedrukt</tt>:gebruiker drukt op een muisknop | ||
+ | {{Documentation/Note|Deze gebeurtenis wordt ook gebruikt voor het weergeven van een verzoek in een pop-up contextmenu op het besturingselement. In dat geval zal het lid <tt>PopupTrigger</tt> van de gebeurtenis dat aan uw macrofunctie wordt doorgegeven <tt>TRUE</tt> zijn. In het bijzonder, als zo'n verzoek wordt gedaan door te drukken op de rechter muisknop van het besturingselement, zal de gebeurtenis twee keer wordne geactiveerd: eenmaal voor het verzoek in de pop-up en eenmaal voor de echte gebeurtenis van de muis. Als u alleen geïnteresseerd bent in de klik met de muisklik zou uw macro alle aanroepen met <tt>PopupTrigger</tt> is <tt>TRUE</tt> moeten negeren.}} | ||
+ | ;<tt>Muisknop losgelaten</tt>:gebruiker laat ingedrukte muisknop los | ||
+ | ;<tt>Muis buiten</tt>:gebruiker verplaatst muis buiten het huidige venster | ||
− | + | De structuur van de geassocieerde gebeurtenis-objecten wordt gedefinieerd in de structuur <idl>com.sun.star.awt.MouseEvent</idl> die de volgende informatie verschaft: | |
− | + | ||
− | + | ||
− | + | ;<tt>Buttons (kort)</tt>:knop ingedrukt (één of meer constanten overeenkomend met <idl>com.sun.star.awt.MouseButton</idl>) | |
+ | ;<tt>X (lang)</tt>:X-coördinaat van de muis, gemeten in pixels vanaf de linker bovenzijde van het besturingselement | ||
+ | ;<tt>Y (lang)</tt>:Y-coördinaat van de muis, gemeten in pixels vanaf de linker bovenzijde van het besturingselement | ||
+ | ;<tt>ClickCount (lang)</tt>:aantal klikken geassocieerd met de gebeurtenis van de muis (als {{OOo}} snel genoeg kan reageren is <tt>ClickCount</tt> ook 1 voor een dubbelklik omdat slechts een individuele gebeurtenis wordt geactiveerd) | ||
− | + | De constanten gedefinieerd in <idl>com.sun.star.awt.MouseButton</idl> voor de muisknoppen zijn: | |
− | + | ||
− | + | ||
− | + | ||
− | + | ;<tt>LEFT</tt>:linker muisknop | |
+ | ;<tt>RIGHT</tt>:rechter muisknop | ||
+ | ;<tt>MIDDLE</tt>:middelste muisknop | ||
− | + | Het volgende voorbeeld geeft zowel de muispositie als de ingedrukte muisknop weer: | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
<source lang="oobas"> | <source lang="oobas"> | ||
− | Sub | + | Sub MuisOmhoog(Gebeurtenis As Object) |
Dim Msg As String | Dim Msg As String | ||
− | Msg = " | + | Msg = "Toetsen: " |
− | If | + | If Gebeurtenis.Buttons AND com.sun.star.awt.MouseButton.LEFT Then |
− | Msg = Msg & " | + | Msg = Msg & "LINKS " |
End If | End If | ||
− | If | + | If Gebeurtenis.Buttons AND com.sun.star.awt.MouseButton.RIGHT Then |
− | Msg = Msg & " | + | Msg = Msg & "RECHTS " |
End If | End If | ||
− | If | + | If Gebeurtenis.Buttons AND com.sun.star.awt.MouseButton.MIDDLE Then |
− | Msg = Msg & " | + | Msg = Msg & "MIDDELSTE " |
End If | End If | ||
− | Msg = Msg & Chr(13) & " | + | Msg = Msg & Chr(13) & "Positie: " |
− | Msg = Msg & | + | Msg = Msg & Gebeurtenis.X & "/" & Gebeurtenis.Y |
MsgBox Msg | MsgBox Msg | ||
Revision as of 12:54, 18 March 2013
Apache OpenOffice dialoogvensters en formulieren zijn gebaseerd op een gebeurtenis georiënteerd programmeermodel waar u gebeurtenis-behandelaars kunt toewijzen aan de besturingselementen. Een gebeurtenis-behandelaar voert een voorgedefinieerde procedure uit als een bepaalde actie plaatsvindt, zelfs als die actie een andere gebeurtenis is. U kunt ook documenten of geopende gegevensbronnen bewerken met gebeurtenis-behandeling net als andere besturingselementen benaderen.
Apache OpenOffice besturingselementen herkennen verschillende typen van gebeurtenissen die kunnen worden geactiveerd in verschillende situaties. Deze typen gebeurtenis kunnen worden verdeeld in vier groepen:
- Gecontroleerd door muis: Gebeurtenissen die reageren op acties van de muis (bijvoorbeeld, eenvoudige muis-bewegingen of een klik op een bepaalde locatie op het scherm).
- Gecontroleerd door toetsenbord: Gebeurtenissen die worden geactiveerd door bepaalde toets-aanslagen.
- Aanpassingen van de focus: Gebeurtenissen die Apache OpenOffice uitvoert als besturingselementen worden geactiveerd of gedeactiveerd.
- Specifieke gebeurtenissen voor besturingselementen: Gebeurtenissen die alleen gebeuren in relatie met bepaalde besturingselementen.
Als u werkt met gebeurtenissen, verzeker u er dan van dat u het bijbehorend dialoogvenster maakt in de ontwikkelomgeving van Apache OpenOffice en dat het de vereiste besturingselementen of documenten (als u de gebeurtenissen wilt toepassen op een formulier) bevat.
De bovenstaande afbeelding toont de Apache OpenOffice BASIC ontwikkelomgeving met een dialoogvenster dat twee keuzelijsten bevat. U kunt de gegevens vanuit de ene lijst naar de andere verplaatsen met behulp van de knoppen tussen de twee keuzelijsten.
Als u het ontwerp op het scherm wilt weergeven, dan zou u de geassocieerde procedures voor Apache OpenOffice BASIC moeten maken zodat die kunnen worden aangeroepen door de gebeurtenisbehandelaars. Hoewel u deze procedures in elke module kunt gebruiken, is het beter hun gebruik tot twee modules te beperken. Om uw code makkelijker te kunnen lezen, zou u betekenisvolle namen moeten geven aan deze procedures. Direct springend naar een algemene programmaprocedure vanuit een macro kan onduidelijke code opleveren. In plaats daarvan, om onderhoud van de code en probleemoplossing te vereenvoudigen, zou u een andere procedure moeten maken om te dienen als startpunt voor gebeurtenisbehandeling – zelfs als het alleen maar één enkele aanroep naar de doelprocedure uitvoert.
De code in het volgende voorbeeld verplaatst een invoer vanuit de linker naar de rechter lijst van een dialoogvenster.
Sub cmdSelecteren_Initiated Dim lstItems As Object Dim lstSelectie As Object lstItems = Dlg.getControl("lstItems") lstSelectie = Dlg.getControl("lstSelectie") If lstItems.SelectedItem > 0 Then lstSelectie.AddItem(lstItems.SelectedItem, 0) lstItems.removeItems(lstItems.SelectItemPos, 1) Else Beep End If End Sub
Als deze procedure werd gemaakt in Apache OpenOffice BASIC kunt u die toewijzen aan een vereiste gebeurtenis met behulp van het venster voor de eigenschappen van de editor voor dialoogvensters.
Het dialoogvenster voor toewijzing somt alle beschikbare gebeurtenissen op. Om een macro toe te wijzen aan een gebeurtenis:
- Selecteer de gebeurtenis
- Klik op Macro...
- Blader naar en selecteer de macro die u wilt toewijzen
- Klik op OK
Parameters
Het plaatsvinden van een bepaalde gebeurtenis is niet altijd genoeg voor een gewenste reactie. Aanvullende informatie kan nodig zijn. Bijvoorbeeld: u zou mogelijk de positie op het scherm waar op de muis werd gedrukt nodig kunnen hebben om een muisklik te verwerken.
In Apache OpenOffice BASIC kunt u parameters voor objecten gebruiken om meer informatie aan een procedure te verschaffen over een gebeurtenis, bijvoorbeeld:
Sub GebeurtenisVerwerken(Event As Object) End Sub
De structuur en eigenschappen van het object Event zijn afhankelijk van het type gebeurtenis dat de aanroep van de procedure activeert.
Ongeacht het type gebeurtenis, verschaffen alle objecten toegang tot het relevante besturingselement en diens model. Het besturingselement kan worden benaderd met behulp van Event.Source en het model ervan met behulp van Event.Source.Model. Het dialoogvenster kan worden benaderd met behulp van Event.Source.Context.
U kunt deze eigenschappen gebruiken om een gebeurtenis te activeren binnen een gebeurtenisbehandelaar.
Gebeurtenissen voor de muis
Apache OpenOffice BASIC herkent de volgende gebeurtenissen voor de muis:
- Muis verplaatst
- gebruiker verplaatst de muis
- Muis verplaatst met ingedrukte toets
- gebruiker sleept muis met ingedrukte toets
- Muisknop ingedrukt
- gebruiker drukt op een muisknop
- Muisknop losgelaten
- gebruiker laat ingedrukte muisknop los
- Muis buiten
- gebruiker verplaatst muis buiten het huidige venster
De structuur van de geassocieerde gebeurtenis-objecten wordt gedefinieerd in de structuur com.sun.star.awt.MouseEvent die de volgende informatie verschaft:
- Buttons (kort)
- knop ingedrukt (één of meer constanten overeenkomend met com.sun.star.awt.MouseButton)
- X (lang)
- X-coördinaat van de muis, gemeten in pixels vanaf de linker bovenzijde van het besturingselement
- Y (lang)
- Y-coördinaat van de muis, gemeten in pixels vanaf de linker bovenzijde van het besturingselement
- ClickCount (lang)
- aantal klikken geassocieerd met de gebeurtenis van de muis (als Apache OpenOffice snel genoeg kan reageren is ClickCount ook 1 voor een dubbelklik omdat slechts een individuele gebeurtenis wordt geactiveerd)
De constanten gedefinieerd in com.sun.star.awt.MouseButton voor de muisknoppen zijn:
- LEFT
- linker muisknop
- RIGHT
- rechter muisknop
- MIDDLE
- middelste muisknop
Het volgende voorbeeld geeft zowel de muispositie als de ingedrukte muisknop weer:
Sub MuisOmhoog(Gebeurtenis As Object) Dim Msg As String Msg = "Toetsen: " If Gebeurtenis.Buttons AND com.sun.star.awt.MouseButton.LEFT Then Msg = Msg & "LINKS " End If If Gebeurtenis.Buttons AND com.sun.star.awt.MouseButton.RIGHT Then Msg = Msg & "RECHTS " End If If Gebeurtenis.Buttons AND com.sun.star.awt.MouseButton.MIDDLE Then Msg = Msg & "MIDDELSTE " End If Msg = Msg & Chr(13) & "Positie: " Msg = Msg & Gebeurtenis.X & "/" & Gebeurtenis.Y MsgBox Msg End Sub
Keyboard Events
The following keyboard events are available in Apache OpenOffice Basic:
- Key pressed
- user presses a key.
- Key released
- user releases a key
Both events relate to logical key actions and not to physical actions. If the user presses several keys to output a single character (for example, to add an accent to a character), then Apache OpenOffice Basic only creates one event.
A single key action on a modification key, such as the Shift key or the Alt key does not create an independent event.
Information about a pressed key is provided by the event object that Apache OpenOffice Basic supplies to the procedure for event handling. It contains the following properties:
- KeyCode (short)
- code of the pressed key (default values in accordance with com.sun.star.awt.Key)
- KeyChar (String)
- character that is entered (taking the modification keys into consideration)
The following example uses the KeyCode property to establish if the Enter key, the Tab key, or one of the other control keys has been pressed. If one of these keys has been pressed, the name of the key is returned, otherwise the character that was typed is returned:
Sub KeyPressed(Event As Object) Dim Msg As String Select Case Event.KeyCode Case com.sun.star.awt.Key.RETURN Msg = "Return pressed" Case com.sun.star.awt.Key.TAB Msg = "Tab pressed" Case com.sun.star.awt.Key.DELETE Msg = "Delete pressed" Case com.sun.star.awt.Key.ESCAPE Msg = "Escape pressed" Case com.sun.star.awt.Key.DOWN Msg = "Down pressed" Case com.sun.star.awt.Key.UP Msg = "Up pressed" Case com.sun.star.awt.Key.LEFT Msg = "Left pressed" Case com.sun.star.awt.Key.RIGHT Msg = "Right pressed" Case Else Msg = "Character " & Event.KeyChar & " entered" End Select MsgBox Msg End Sub
Information about other keyboard constants can be found in the API Reference under the com.sun.star.awt.Key group of constants.
Focus Events
Focus events indicate if a control element receives or loses focus. You can use these events to, for example, determine if a user has finished processing a control element so that you can update other elements of a dialog. The following focus events are available:
- When receiving focus
- element receives focus
- When losing focus
- element loses focus
The Event objects for the focus events are structured as follows:
- FocusFlags (short)
- cause of focus change (default value in accordance with com.sun.star.awt.FocusChangeReason )
- NextFocus (Object)
- object that receives focus (only for the When losing focus event)
- Temporary (Boolean)
- the focus is temporarily lost
Control Element-Specific Events
In addition to the preceding events, which are supported by all control elements, there are also some control element-specific events that are only defined for certain control elements. The most important of these events are:
- When Item Changed
- the value of a control element changes
- Item Status Changed
- the status of a control element changes
- Text modified
- the text of a control element changes
- When initiating
- an action that can be performed when the control element is triggered (for example, a button is pressed)
When you work with events, note that some events, such as the When initiating event, can be initiated each time you click the mouse on some control elements (for example, on radio buttons). No action is performed to check if the status of the control element has actually changed. To avoid such “blind events”, save the old control element value in a global variable, and then check to see if the value has changed when an event is executing.
The When initiating event is also noteworthy for the following reasons:
- This event is initiated by either a key-press or a mouse button. Thus, it provides a consistent interface for users who navigate by mouse or by keyboard.
- When the Repeat property of a command button is set to True, this event is the one which is repeatedly sent, as long as the triggering action (key down or mouse-button down) remains in effect.
The properties for the Item Status Changed event are:
- Selected (long)
- currently selected entry
- Highlighted (long)
- currently highlighted entry
- ItemId (long)
- ID of entry
Content on this page is licensed under the Public Documentation License (PDL). |