IContainer  - AS3 Flex

Geeft de knopmodus van deze sprite op. Wanneer de waarde true is, gedraagt deze sprite zich als een knop. Dit betekent dat de aanwijzer verandert in een handje wanneer de cursor zich op de sprite bevindt en dat de sprite de gebeurtenis click kan ontvangen wanneer op de Enter-toets of de spatiebalk wordt gedrukt terwijl de sprite focus heeft. U kunt voorkomen dat het handje wordt weergegeven door de eigenschap useHandCursor in te stellen op false, in welk geval de aanwijzer wordt weergegeven.

Hoewel u beter de klasse SimpleButton kunt gebruiken om knoppen te maken, kunt u de eigenschap buttonMode gebruiken om een sprite knopachtige functionaliteit te geven. Wanneer u een sprite wilt opnemen in de tabvolgorde, stelt u de eigenschap tabEnabled (die wordt overerfd van de klasse InteractiveObject en standaard is ingesteld op false) in op true. Daarnaast dient u te overwegen of u wilt dat de onderliggende objecten van de sprite gebruikersinvoer hebben. Bij de meeste knoppen wordt geen gebruikersinvoerinteractiviteit ingesteld voor onderliggende objecten aangezien hierdoor de gebeurtenisstroom in de war wordt gestuurd. Wanneer u gebruikersinvoerinteractiviteit wilt uitschakelen voor alle onderliggende objecten, moet u de eigenschap mouseChildren (die is overerfd van de klasse DisplayObjectContainer) instellen op false.

Wanneer u de eigenschap buttonMode gebruikt met de klasse MovieClip (een subklasse van de klasse Sprite), kunt u extra functionaliteit toevoegen aan de knop. Wanneer u frames genaamd _up, _over en _down toevoegt, biedt Flash Player automatische statuswijzigingen. (Deze functionaliteit lijkt op de functionaliteit die in eerdere versies van ActionScript werd geboden voor filmclips die als knoppen werden gebruikt.) Deze automatische statuswijzigingen zijn niet beschikbaar voor sprites, die geen tijdlijn hebben en dus geen frames die u een naam kunt geven.

Containers use an internal content pane to control scrolling. The creatingContentPane is true while the container is creating the content pane so that some events can be ignored or blocked.

The Button control designated as the default button for the container. When controls in the container have focus, pressing the Enter key is the same as clicking this Button control.

Geeft op of het object gebeurtenissen doubleClick ontvangt. De standaardwaarde is false. Dit betekent dat een instantie InteractiveObject standaard geen gebeurtenissen doubleClick ontvangt. Wanneer de eigenschap doubleClickEnabled is ingesteld op true, ontvangt de instantie gebeurtenissen doubleClick binnen de grenzen. Wanneer de eigenschap mouseEnabled van de instantie InteractiveObject tevens is ingesteld op true, kan het object gebeurtenissen doubleClick ontvangen.

Bij het instellen van deze eigenschap wordt geen gebeurtenis verzonden. U kunt een gebeurtenislistener toevoegen voor de gebeurtenis doubleClick met de methode addEventListener().

Geeft het weergaveobject op waarover de sprite wordt gesleept of waarop de sprite is neergezet.

Gets the FocusManager that controls focus for this component and its peers. Each popup has its own focus loop and therefore its own instance of a FocusManager. To make sure you're talking to the right one, use this method.

Geeft op of dit object een focusrechthoek weergeeft. Deze kan een van de volgende drie waarden hebben: true, false of null. De waarden true en false werken zoals wordt verwacht, en bepalen of de driehoek met de focus al dan niet wordt weergegeven. De waarde null geeft aan dat dit object is onderworpen aan de eigenschap stageFocusRect van het werkgebied.

Geeft het object Graphics op dat bij deze sprite hoort, waarbij vectortekenopdrachten kunnen optreden.

Wijst een andere sprite aan als raakgebied voor een sprite. Wanneer de eigenschap hitArea niet bestaat of de waarde null of undefined heeft, wordt de filmclip zelf als raakgebied gebruikt. De waarde van de eigenschap hitArea kan een verwijzing zijn naar een object Sprite.

U kunt de eigenschap hitArea op elk moment wijzigen. De aangepaste sprite gebruikt direct het nieuwe gedrag voor het raakgebied. De sprite die als raakgebied wordt opgegeven, hoeft niet zichtbaar te zijn. De grafische vorm ervan wordt ook als raakgebied gedetecteerd wanneer de sprite niet zichtbaar is.

Opmerking: u moet de eigenschap mouseEnabled van de sprite die als raakgebied wordt gebruikt instellen op false. Zo niet, dan werkt de spriteknop mogelijk niet omdat de sprite die is toegewezen als raakgebied de gebruikersinvoergebeurtenissen ontvangt in plaats van de spriteknop.

The current position of the horizontal scroll bar. This is equal to the distance in pixels between the left edge of the scrollable surface and the leftmost piece of the surface that is currently visible.

Bepaalt of de onderliggende elementen van het object door de muis of door een gebruikersinvoerapparaat worden ingeschakeld. Als een object wordt ingeschakeld, kan een gebruiker ermee communiceren met behulp van een muis of een gebruikersinvoerapparaat. De standaardwaarde is true.

Deze eigenschap is handig wanneer u een knop maakt met een instantie van de klasse Sprite (in plaats van de klasse SimpleButton). Wanneer u een instantie Sprite gebruikt om een knop te maken, kunt u het uiterlijk van de knop aanpassen met de methode addChild() en zo aanvullende instanties Sprites toevoegen. Dit kan leiden tot onverwacht gedrag bij muisgebeurtenissen aangezien de instanties Sprite die u toevoegt als onderliggende objecten het doelobject van een muisgebeurtenis kunnen worden, terwijl u verwacht dat de bovenliggende instantie het doelobject is. Wanneer u er zeker van wilt zijn dat de bovenliggende instantie fungeert als doelobject voor muisgebeurtenissen, stelt u de eigenschap mouseChildren van de bovenliggende instantie in op false.

Bij het instellen van deze eigenschap wordt geen gebeurtenis verzonden. U moet de methode addEventListener() gebruiken om interactieve functionaliteit toe te voegen.

Geeft aan of dit object berichten van de muis of gebruikersinvoer ontvangt. De standaardwaarde is true. Dit betekent dat iedere instantie InteractiveObject die in het weergaveoverzicht voorkomt, standaard muisgebeurtenissen of andere gebruikersinvoergebeurtenissen ontvangt. Als mouseEnabled op false is ingesteld, ontvangt de instantie geen muisgebeurtenissen (of andere gebruikersinvoergebeurtenissen zoals toetsenbordgebeurtenissen). De onderliggende items van deze instantie in het weergaveoverzicht worden niet beïnvloed. U kunt de werking van mouseEnabled voor alle onderliggende items van een object uit het weergaveoverzicht wijzigen met flash.display.DisplayObjectContainer.mouseChildren.

Bij het instellen van deze eigenschap wordt geen gebeurtenis verzonden. U moet de methode addEventListener() gebruiken om interactieve functionaliteit toe te voegen.

Retourneert het aantal onderliggende objecten van dit object.

Beheert geluid binnen deze sprite.

Opmerking: deze eigenschap heeft geen invloed op de HTML-inhoud in een HTMLControl-object (in Adobe AIR).

Determines whether the children of the object are tab enabled.

Note: Do not use this property with Flex. Instead, use the UIComponent.hasFocusableChildren property.

Verwante API-elementen

Geeft op of dit object in de tabvolgorde is opgenomen. Wanneer dit object is opgenomen in de tabvolgorde, is de waarde true; anders is de waarde false. De waarde is standaard false, met uitzondering van de volgende objecten:

• De waarde van een object SimpleButton is true.
• De waarde van een object TextField met type = "input" is true.
• De waarde van een object Sprite of een object MovieClip met buttonMode = true is true.

Geeft de tabvolgorde van objecten in een SWF-bestand op. De eigenschap tabIndex is standaard -1. Dit betekent dat er geen tabindex is ingesteld voor het object.

Wanneer een momenteel weergegeven object in het SWF-bestand de eigenschap tabIndex bevat, wordt automatische tabvolgorde uitgeschakeld en wordt de tabvolgorde berekend op basis van de eigenschappen tabIndex van objecten in het SWF-bestand. De aangepaste tabvolgorde omvat alleen objecten met eigenschappen tabIndex.

De eigenschap tabIndex kan een positief geheel getal zijn. De objecten worden gerangschikt op basis van hun eigenschappen tabIndex, in oplopende volgorde. Een object met een waarde tabIndex van 1 komt voor een object met een waarde tabIndex van 2. Gebruik dezelfde waarde tabIndex niet voor meerdere objecten.

De aangepaste tabvolgorde die door de eigenschap tabIndex wordt gedefinieerd, is vlak. Dit betekent dat er geen aandacht wordt besteed aan de hiërarchische relaties van objecten in het SWF-bestand. Alle objecten in het SWF-bestand met eigenschappen tabIndex worden opgenomen in de tabvolgorde en de tabvolgorde wordt bepaald op basis van de volgorde van de waarden tabIndex.

Opmerking: als u de tabvolgorde voor instanties TLFTextField wilt instellen, gebruikt u het onderliggende weergaveobject van TLFTextField als InteractiveObject en vervolgens stelt u de eigenschap tabIndex in. Bijvoorbeeld:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

Retourneert een object TextSnapshot voor deze instantie DisplayObjectContainer.

Een Booleaanse waarde die aangeeft of het wijzende handje wordt weergegeven wanneer de cursor wordt bewogen over een sprite waarin de eigenschap buttonMode is ingesteld op true. De standaardwaarde van de eigenschap useHandCursor is true. Wanneer useHandCursor is ingesteld op true, wordt het wijzende handje dat voor knoppen wordt gebruikt, weergegeven wanneer de cursor over een knopsprite beweegt. Wanneer useHandCursor is ingesteld op false, wordt in plaats daarvan de pijlaanwijzer gebruikt.

U kunt de eigenschap useHandCursor op elk moment wijzigen. De aangepaste sprite gebruikt direct het nieuwe uiterlijk voor de aanwijzer.

Opmerking: In Flex of Flash Builder kunt u de eigenschap mouseChildren beter op false instellen als de sprite onderliggende sprites heeft. Wanneer u bijvoorbeeld wilt dat een handje wordt weergegeven boven een Flex-besturingselement <mx:Label>, stelt u de eigenschappen useHandCursor en buttonMode in op true en de eigenschap mouseChildren op false .

The current position of the vertical scroll bar. This is equal to the distance in pixels between the top edge of the scrollable surface and the topmost piece of the surface that is currently visible.

Returns an object that has four properties: left, top, right, and bottom. The value of each property equals the thickness of the chrome (visual elements) around the edge of the container.

The chrome includes the border thickness. If the horizontalScrollPolicy or verticalScrollPolicy property value is ScrollPolicy.ON, the chrome also includes the thickness of the corresponding scroll bar. If a scroll policy is ScrollPolicy.AUTO, the chrome measurement does not include the scroll bar thickness, even if a scroll bar is displayed.

Subclasses of Container should override this method, so that they include other chrome to be taken into account when positioning the Container's children. For example, the viewMetrics property for the Panel class should return an object whose top property includes the thickness of the Panel container's title bar.

Voegt een onderliggende instantie DisplayObject toe aan deze instantie DisplayObjectContainer. Het onderliggende object wordt toegevoegd voor (boven) alle andere onderliggende objecten van deze instantie DisplayObjectContainer. (Wanneer u een onderliggend object wilt toevoegen aan een specifieke indexpositie, gebruikt u de methode addChildAt().)

Wanneer u een onderliggend object toevoegt dat al een ander weergaveobjectcontainer als bovenliggend object heeft, wordt het object verwijderd uit de lijst met onderliggende objecten van de andere weergaveobjectcontainer.

Opmerking: De opdracht stage.addChild kan problemen veroorzaken met een gepubliceerd SWF-bestand, zoals veiligheidsproblemen en conflicten met andere geladen SWF-bestanden. Er is slechts één werkgebied binnen een Flash-runtime-instantie, ongeacht hoeveel SWF-bestanden u in de runtime laadt. Objecten moeten over het algemeen niet direct aan het werkgebied worden toegevoegd. Het enige object dat zich niet in het werkgebied mag bevinden, is het hoofdobject. Maak een DisplayObjectContainer waarin alle items op de weergavelijst staan. Voeg vervolgens, indien nodig, die DisplayObjectContainer-instantie toe aan het werkgebied.

Parameters

Voegt een onderliggende instantie DisplayObject toe aan deze instantie DisplayObjectContainer. Het onderliggende object wordt toegevoegd op de opgegeven indexpositie. Index 0 vertegenwoordigt de achterkant (onderkant) van het weergaveoverzicht voor het object DisplayObjectContainer.

In het volgende voorbeeld worden bijvoorbeeld drie weergaveobjecten, genaamd a, b en c, weergegeven op respectievelijk de indexpositie 0, 2 en 1:

Wanneer u een onderliggend object toevoegt dat al een ander weergaveobjectcontainer als bovenliggend object heeft, wordt het object verwijderd uit de lijst met onderliggende objecten van de andere weergaveobjectcontainer.

Parameters

Geeft aan of vanwege beveiligingsbeperkingen weergaveobjecten worden weggelaten uit de lijst die wordt geretourneerd wanneer de methode DisplayObjectContainer.getObjectsUnderPoint() wordt aangeroepen met het opgegeven punt point. Standaard heeft inhoud van een bepaald domein geen toegang tot objecten van een ander domein, tenzij dit is toegestaan via een aanroep van de methode Security.allowDomain(). Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center.

De parameter point is de coördinaatruimte van het werkgebied, die kan verschillen van de coördinaatruimte van de weergaveobjectcontainer (tenzij de weergaveobjectcontainer het werkgebied is). U kunt de methoden globalToLocal() en localToGlobal() gebruiken om punten om te zetten tussen deze twee coördinaatruimten.

Parameters

Bepaalt of het opgegeven weergaveobject een onderliggend object van de instantie DisplayObjectContainer of de instantie zelf is. Er wordt gezocht in het hele weergaveoverzicht, met inbegrip van de instantie DisplayObjectContainer. Onderliggende objecten van onderliggende objecten enzovoort retourneren elk de waarde true.

Parameters

Retourneert de onderliggende weergaveobjectinstantie bij de opgegeven index.

Parameters

Retourneert de onderliggende weergaveobjectinstantie met de opgegeven naam. Wanneer meer dan één onderliggend weergaveobject de opgegeven naam heeft, retourneert de methode het eerste object in de lijst met onderliggende objecten.

De methode getChildAt() is sneller dan de methode getChildByName(). De methode getChildAt() heeft toegang tot een onderliggend object via een array in de cache, terwijl de methode getChildByName() een gekoppelde lijst moet doorlopen om toegang te krijgen tot een onderliggend object.

Parameters

Retourneert de indexpositie van een onderliggende (child) instantie DisplayObject.

Parameters

Retourneert een array met objecten die zich onder het opgegeven punt bevinden en onderliggende objecten van deze instantie DisplayObjectContainer zijn (of onderliggende objecten van onderliggende objecten van die instantie). Eventuele onderliggende objecten die om beveiligingsredenen niet toegankelijk zijn, worden weggelaten uit de geretourneerde array. Wanneer u wilt bepalen of deze beveiligingsbeperking van invloed is op de geretourneerde array, roept u de methode areInaccessibleObjectsUnderPoint() aan.

De parameter point is de coördinaatruimte van het werkgebied, die kan verschillen van de coördinaatruimte van de weergaveobjectcontainer (tenzij de weergaveobjectcontainer het werkgebied is). U kunt de methoden globalToLocal() en localToGlobal() gebruiken om punten om te zetten tussen deze twee coördinaatruimten.

Parameters

Verwijdert de opgegeven onderliggende instantie DisplayObject uit de lijst met onderliggende objecten van de instantie DisplayObjectContainer. De eigenschap parent van het verwijderde onderliggende object wordt ingesteld op null en het object wordt opgeschoond wanneer er geen andere referenties naar het object bestaan. De indexposities van eventuele weergaveobjecten boven het onderliggende object in de DisplayObjectContainer worden met 1 verlaagd.

De opschoonfunctie wijst ongebruikte geheugenruimte opnieuw toe. Wanneer niet meer actief wordt verwezen naar een variabele of object of wanneer de variabele of het object nergens meer is opgeslagen, wordt de geheugenruimte die de variabele of het object innam leeggemaakt wanneer er geen andere referenties naar bestaan.

Parameters

Verwijdert een onderliggend DisplayObject uit de opgegeven indexpositie in de lijst met onderliggende objecten van de DisplayObjectContainer. De eigenschap parent van het verwijderde onderliggende object wordt ingesteld op null en het object wordt opgeschoond wanneer er geen andere referenties naar het object bestaan. De indexposities van eventuele weergaveobjecten boven het onderliggende object in de DisplayObjectContainer worden met 1 verlaagd.

De opschoonfunctie wijst ongebruikte geheugenruimte opnieuw toe. Wanneer niet meer actief wordt verwezen naar een variabele of object of wanneer de variabele of het object nergens meer is opgeslagen, wordt de geheugenruimte die de variabele of het object innam leeggemaakt wanneer er geen andere referenties naar bestaan.

Parameters

Wijzigt de positie van een bestaand onderliggend object in de weergaveobjectcontainer. Dit is van invloed op de laagvolgorde van onderliggende objecten. In het volgende voorbeeld worden bijvoorbeeld drie weergaveobjecten, genaamd a, b en c, weergegeven op respectievelijk de indexpositie 0, 1 en 2:

Wanneer u de methode setChildIndex() gebruikt en een indexpositie opgeeft die al in gebruik is, veranderen alleen de posities tussen de voormalige en de nieuwe positie van het weergaveobject. Alle andere posities blijven dezelfde. Als een onderliggend item wordt verplaatst naar een index die LAGER ligt dan de huidige index, zullen de indexverwijzingen van alle onderliggende items daartussenin met 1 TOENEMEN. Als een onderliggend item wordt verplaatst naar een index die HOGER ligt dan de huidige index, zullen de indexverwijzingen van alle onderliggende items daartussenin met 1 AFNEMEN. Wanneer de weergaveobjectcontainer in het vorige voorbeeld bijvoorbeeld container heet, kunt u de positie van de weergaveobjecten genaamd a en b omwisselen door de volgende code aan te roepen:

container.setChildIndex(container.getChildAt(1), 0);

Deze code resulteert in de volgende rangschikking van objecten:

Parameters

Hiermee kan de gebruiker de opgegeven sprite slepen. De sprite blijft versleepbaar totdat dit expliciet wordt beëindigd met een aanroep van de methode Sprite.stopDrag() of totdat een andere sprite versleepbaar wordt gemaakt. Er kan slechts één sprite tegelijk versleepbaar zijn.

Driedimensionale weergaveobjecten volgen de cursor en Sprite.startDrag() verplaatst het object binnen het driedimensionale vlak dat wordt gedefinieerd door het weergaveobject. Als het weergaveobject een tweedimensionaal object is en het onderliggende object is van een driedimensionaal object, wordt het tweedimensionale object verplaatst binnen het driedimensionale vlak dat wordt gedefinieerd door het driedimensionale bovenliggende object.

Parameters

Beëindigt de methode startDrag(). Een sprite versleepbaar is gemaakt met de methode startDrag(), blijft versleepbaar totdat de methode stopDrag() wordt toegevoegd of totdat een andere sprite versleepbaar wordt. Er kan slechts één sprite tegelijk versleepbaar zijn.

Wisselt de z-volgorde (van voor naar achter) van de twee opgegeven onderliggende objecten om. Alle andere onderliggende objecten in de weergaveobjectcontainer behouden hun indexpositie.

Parameters

Wisselt de z-volgorde (van voor naar achter) van de onderliggende objecten op de twee opgegeven indexposities in de lijst met onderliggende objecten om. Alle andere onderliggende objecten in de weergaveobjectcontainer behouden hun indexpositie.

Parameters