NativeDragManager  - AS3

Pakket	flash.desktop
Klasse	public class NativeDragManager
Overerving	NativeDragManager Object

Runtimeversies:

AIR 1.0

De klasse NativeDragManager coördineert slepen-en-neerzetten-bewerkingen. Met de native API voor slepen en neerzetten kunt u toestaan dat een gebruiker gegevens sleept tussen een AIR-toepassing en het native besturingssysteem, tussen twee toepassingen, en tussen componenten binnen dezelfde toepassing.

De volgende soorten gegevens kunnen worden overgedragen:

• Bitmaps
• Bestanden
• Tekst
• URL-tekenreeksen
• Objecten met serienummering
• Objectreferenties (alleen geldig binnen de brontoepassing)

Opmerking: alle leden van NativeDragManager zijn statisch. Een instantie van deze klasse hoeft niet worden gecreëerd.

Een bewerking voor slepen en neerzetten is een beweging in de gebruikersinterface die begint wanneer de gebruiker op een zichtbaar item klikt en dit naar een andere plaats sleept. Tijdens de sleepbeweging verzenden interactieve objecten in het weergaveoverzicht native sleepgebeurtenissen naarmate de handeling zich over het AIR-toepassingsvenster beweegt. Handlers voor deze gebeurtenissen kunnen de methoden van de klasse NativeDragManager aanroepen om aan te geven of een gesleept item op een object kan worden neergezet. Als reactie hierop wijzigt de NativeDragManager de muisaanwijzer om feedback aan de gebruiker te geven.

AIR-profielondersteuning: deze functie wordt niet ondersteund op AIR for TV-apparaten. De functie wordt ook niet ondersteund op mobiele apparaten. Met de eigenschap NativeDragManager.isSupported kunt u testen of deze functie tijdens runtime wordt ondersteund. Zie AIR-profielondersteuning voor meer informatie over API-ondersteuning voor meerdere profielen.

Sleepacties

Bewegingen voor slepen en neerzetten worden doorgaans gebruikt voor drie soorten bewerkingen, die acties worden genoemd. Aangezien de betekenis van deze handelingen afhankelijk is van de toepassingscontext, stelt de runtime voor deze handelingen geen specifiek gedrag in. Een goede implementatie van de handelingen verbetert echter de gebruikerservaring in uw toepassing.

De mogelijke handelingen zijn:

• Copy - Er wordt een kopie van de gegevens gemaakt, waarbij het origineel onaangeroerd blijft. (Kopieer het oorspronkelijke object zelf in plaats van de verwijzing naar dit object als u objecten binnen een toepassing sleept.)
• Move - De gegevens worden verplaatst van de oorspronkelijke context naar de context die door het doel van de neerzetbewerking wordt gedefinieerd, zoals wanneer u een item van de ene naar de andere lijst verplaatst.
• Link - Er wordt een verwijzing of snelkoppeling naar de oorspronkelijke gegevens gemaakt en het item blijft in zijn oorspronkelijke context staan.

U kunt de toegestane handelingen voor een sleepbeweging instellen door een parameter allowedActions bij te sluiten in de oproep NativeDragManager.doDrag() waarmee de sleepbewerking wordt gestart. Alle handelingen zijn toegestaan als er geen parameter allowedActions is opgegeven. Mogelijke doelen voor sleepbewerkingen kunnen controleren welke handelingen zijn toegestaan met de eigenschap allowedActions van een object NativeDragEvent, en mogen geen neerzethandeling accepteren waarin alleen niet-compatibele handelingen zijn toegestaan (dit wordt echter niet door de runtime afgedwongen).

Als een doel voor neerzetten maar één actie implementeert, kan het object de eigenschap dropAction van de NativeDragManager in de handlers instellen voor zowel de nativeDragEnter- als de nativeDragOver-gebeurtenis. Door de eigenschap vóór het neerzetten in te stellen, kan de sleepmanager de muisaanwijzer zo bijwerken dat deze de ondersteunde actie aangeeft en wordt voorkomen dat een gebruiker met behulp van optietoetsen een niet-compatibele actie kiest. Als de opgegeven actie een ongeldige actie is, wordt het neerzetten niet toegestaan, zelfs niet als het doel de methode acceptDrop() aanroept.

Een mogelijk doel voor een neerzetbewerking moet de gekozen handeling opgeven door de eigenschap NativeDragManager.dropAction in te stellen als antwoord op de gebeurtenis nativeDragDrop wanneer een neerzethandeling wordt geaccepteerd. Deze handeling wordt aan het initiërende weergaveobject in de gebeurtenis nativeDragComplete gerapporteerd. Als het doel voor de neerzetbewerking geen actie heeft ingesteld, wordt een standaardactie gekozen uit de lijst met toegestane acties. Hierbij wordt deze volgorde gehanteerd: copy, move, link. Het initiërende object is verantwoordelijk voor het bijwerken van zijn interne staat als antwoord op de gekozen handeling.

Tekenreeksconstanten voor de namen van de handelingen worden gedefinieerd in de klasse NativeDragActions.

Volgorde van gebeurtenissen

Een sleepbeweging wordt gestart door de methode NativeDragManager.doDrag() op te roepen binnen een gebeurtenishandler mouseDown of mouseMove en gebruikt de volgende volgorde van gebeurtenissen als antwoord op gebruikershandelingen:

• de gebeurtenis nativeDragStart - Wanneer NativeDragManager.doDrag() wordt aangeroepen, wordt het interactieve object dat als een parameter aan de methode is doorgegeven, het initiatorobject en verzendt het een nativeDragStart-gebeurtenis.
• de gebeurtenis nativeDragUpdate - Tijdens de sleepbewerking zal het initiatorobject voortdurend nativeDragUpdate-gebeurtenissen verzenden.
• de gebeurtenissen nativeDragEnter, nativeDragOver - Wanneer een sleepbeweging boven een interactief object beweegt, verzendt dat object een nativeDragEnter-gebeurtenis. Terwijl de sleepbeweging boven het interactieve object blijft, verzendt dit object voortdurend nativeDragOver-gebeurtenissen. Als antwoord op elk van deze gebeurtenissen moet een object dat dient als mogelijk doel voor een neerzetbewerking de eigenschappen van de gebeurtenis controleren om na te gaan of het de neerzethandeling kan accepteren. Als de gegevensindeling en de toegestane handelingen geschikt zijn, moet de gebeurtenishandler voor deze gebeurtenissen NativeDragManager.acceptDrop() aanroepen, waarbij een verwijzing naar het weergaveobject dat zal dienen als doel van de sleepbeweging wordt doorgegeven (doorgaans is dit het object dat de nativeDragEnter- of nativeDragOver-gebeurtenis heeft verzonden). De gebruiker kan het gesleepte item vervolgens op het doel neerzetten.
• de gebeurtenis nativeDragExit - Wanneer een sleepbeweging een interactief object verlaat, verzendt het object een nativeDragExit-gebeurtenis. Als het object door een eerdere aanroep van de methode NativeDragManager.acceptDrop() was aangeduid als het doel van de sleepbeweging, is deze aanroep niet meer geldig en moet acceptDrop() opnieuw worden aangeroepen als de beweging het interactieve object opnieuw binnengaat.
• de gebeurtenis nativeDragDrop - Het doelweergaveobject verzendt een gebeurtenis nativeDragDrop wanneer de gebruiker de muisknop boven het object loslaat. De handler voor deze gebeurtenis heeft toegang tot de gegevens in de eigenschap transferable van het gebeurtenisobject en moet de eigenschap NativeDragManager.dropAction instellen om te signaleren welke handeling door het initiatorobject moet worden uitgevoerd.
• nativeDragComplete - Wanneer de gebruiker de muisknop aan het einde van een sleepbeweging loslaat, verzendt het initiatorobject een nativeDragComplete-gebeurtenis (ongeacht of het neerzetten werd voltooid of niet). De handler voor deze gebeurtenis kan de eigenschap dropAction van het gebeurtenisobject controleren om te bepalen welke aanpassing aan de interne gegevensstatus er eventueel nodig is, zoals het verwijderen van een item dat uit een lijst werd gesleept. Als dropAction NativeDragActions.NONE is, is het gesleepte item niet op een geschikt doel neergezet.

Bewegingen tussen toepassingen

Wanneer een sleepbeweging een AIR-toepassingsvenster binnengaat vanuit een niet-AIR-toepassing, is er geen initiatorobject om de nativeDragStart- of nativeDragComplete-gebeurtenis te verzenden. Voor het overige zullen de gebeurtenissen die tijdens de beweging worden verzonden hetzelfde patroon volgen als bij een beweging die binnen dezelfde AIR-toepassing begint en eindigt.

Wanneer een sleepbeweging een AIR-toepassingsvenster verlaat, is er geen doelobject om de nativeDragEnter-, nativeDragOver- of nativeDragDrop-gebeurtenis te verzenden. Het initiatorobject verzendt wel nog een nativeDragComplete-gebeurtenis, die de sleephandeling meldt die door het native besturingssysteem is ingesteld (of none als het neerzetten niet werd geaccepteerd).

Wanneer een sleepbeweging van de ene naar de andere AIR-toepassing beweegt, verzenden de initiator- en doelweergaveobjecten zoals gewoonlijk gebeurtenissen binnen de eigen afzonderlijke toepassingen.

Gegevensoverdracht

De gegevens die tijdens een beweging voor slepen en neerzetten werden overgedragen worden in een klembordobject ingesloten. Dit gegevensobject wordt aan de sleepbewerking toegevoegd met de methode NativeDragManager.doDrag(), die die sleepbeweging start. Mogelijke doelen voor neerzetten hebben toegang tot het klembordobject via de eigenschap clipboard van het native drag-gebeurtenisobject. Wanneer de sleepbewerking is gestart, kan het klembordobject alleen in de gebeurtenishandler van een NativeDragEvent worden benaderd. Alle andere pogingen om toegang te krijgen tot het object, genereren een runtime-fout.

Beveiligingsoverwegingen

De beveiligingssandboxen van de initiatorobjecten en de mogelijke doelobjecten bepalen hoe de gegevens die worden gesleept kunnen worden benaderd. Als beide objecten zich in dezelfde sandbox bevinden, kunnen de gegevens vanuit elk object NativeDragEvent worden benaderd. Als de initiator- en doelobjecten zich echter in verschillende sandboxen bevinden, kunnen de gegevens enkel worden benaderd in de doelsandbox binnen de gebeurtenishandler voor de gebeurtenis nativeDragDrop. Andere native gebeurtenishandlers voor slepen hebben nog steeds toegang tot het klembordobject waarnaar in de eigenschap clipboard van de gebeurtenis wordt verwezen om te bepalen welke gegevensindelingen beschikbaar zijn, maar het aanroepen van de methode clipboard.getData() genereert een beveiligingsfout.

Verwante API-elementen

---