IContainer  - AS3 Flex

Anger knappläge för den här spriten. Om true uppför sig denna sprite som en knapp, vilket betyder att den utlöser visningen av handmarkören när pekaren passerar över spriten och kan ta emot en click-händelse om enter eller mellanslag trycks ner när spriten är i fokus. Du kan undertrycka visningen av handmarkören genom att sätta useHandCursor-egenskapen till false, vilket medför att pekaren visas.

Det är bättre att använda klass SimpleButton för att skapa knappar, men du kan använda buttonMode-egenskapen för att ge en sprite vissa knappliknande funktioner. För att ta med en sprite i tabbordningen sätter man tabEnabled-egenskapen (som ärvts från klass InteractiveObject och är false som standard) till true. Tänk också på om du vill att din sprites underordnade ska vara aktiverade för användarinmatningar. De flesta knappar aktiverar inte användarindatainteraktivitet för sina underordnade objekt eftersom det stör händelseflödet. För att inaktivera användarindatainteraktivitet för samtliga underordnade objekt måste du sätta mouseChildren-egenskapen (som ärvts från klassen DisplayObjectContainer) till false.

Om du använder buttonMode-egenskapen med klass MovieClip (som är en underklass till klass Sprite) kan din knapp ha vissa ytterligare funktioner. Om du tar tar med bildrutorna labeled _up, _over, och _down tillhandahåller Flash Player automatiska statusändringar (funktioner som liknar dem hos tidigare versioner av ActionScript för filmklipp som används som knappar). Dessa automatiska statusändringar finns inte tillgängliga för spriter, som inte har något tidslinje och därför inga bildrutor att etikettera.

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.

Anger om det här objektet tar emot doubleClick-händelser. Standardvärdet är false, vilket innebär att en InteractiveObject-instans inte tar emot doubleClick-händelser som standard. Om doubleClickEnabled-egenskapen står på true tar instansen emot doubleClick-händelser inom sina gränser. Egenskapen mouseEnabled för InteractiveObject-instansen måste också anges som true för att objektet ska ta emot doubleClick-händelser.

Ingen händelse skickas när denna egenskap sätts. Du måste använda addEventListener()-metoden för att lägga till en händelseavlyssnare för doubleClick-händelsen.

Anger det visningsobjekt som spriten dras över, eller som spriten släpptes på.

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.

Anger om det här objektet visar en fokusram. Den kan ta ett av tre värden: true, false eller null. Värdena true och false fungerar som förväntat och anger om fokusrektangeln visas eller inte. Ett värde på null anger att detta objekt lyder stageFocusRect-egenskapen i Stage.

Anger det Graphics-objekt som tillhör denna sprite där kommandon för vektorritning kan göras.

Utser en annan sprite som ska fungera som träffområde för en sprite. Om hitArea-egenskapen saknas, eller om värdet är null eller odefinierat, används själva spriten som träffområde. Värdet för hitArea-egenskapen kan utgöras av en referens till ett Sprite-objekt.

Du kan ändra egenskapen hitArea när som helst. Den ändrade spriten får omedelbart det nya träffområdesbeteendet. Det sprite som valts som träffområde behöver inte vara synligt. Dess grafiska form fungerar fortfarande som träffområde även om det inte syns.

Obs! Du måste välja false för egenskapen mouseEnabled för den sprite som är träffområdet. I annat fall fungerar spriteknappen eventuellt inte eftersom den sprite som valts som träffområde tar emot användarindatahändelser i stället för din spriteknapp.

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.

Avgör om objektets underordnade objekt är aktiverade för en mus eller annan användarindataenhet (eller inte). Om ett objekt är aktiverat kan användaren interagera med det via en mus eller annan användarindataenhet. Standardvärdet är true.

Denna egenskap är användbar när du skapar en knapp med en Sprite-klassinstans (i stället för att använda SimpleButton-klassen). När du använder en Sprite-instans för att skapa en knapp kan du välja att dekorera knappen genom att använda addChild()-metoden för att lägga till ytterligare Sprite-instanser. Denna process kan leda till oväntat beteende med mushändelser eftersom de Sprite-instanser du lägger till som underordnade kan bli målobjektet för en mushändelse när du förväntar dig att den överordnade instansen ska vara målobjektet. För att säkerställa att den överordnade instansen används som målobjekt för mushändelser kan du sätta mouseChildren-egenskapen för den överordnade instansen till false.

Ingen händelse skickas när denna egenskap sätts. Du måste använda addEventListener()-metoden för att skapa interaktiv funktionalitet.

Anger om det här objektet tar emot musmeddelanden eller annan indata från användaren. Standardvärdet är true, vilket innebär att varje InteractiveObject-instans som förekommer på visningslistan tar emot mushändelser eller andra indatahändelser från användaren som standard. Om mouseEnabled är inställt på false, tar instansen inte emot några mushändelser (eller andra indatahändelser från användaren, t.ex. tangentbordshändelser). Eventuella underordnade till denna instans i visningslistan påverkas inte. För att ändra mouseEnabled-beteendet för samtliga underordnade till ett objekt i visningslistan använder man flash.display.DisplayObjectContainer.mouseChildren.

Ingen händelse skickas när denna egenskap sätts. Du måste använda addEventListener()-metoden för att skapa interaktiv funktionalitet.

Returnerar antalet underordnade objekt det här objektet har.

Styr ljudet i den här spriten.

Obs! Den här egenskapen påverkar inte HTML-innehåll i ett HTMLControl-objekt (i 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.

Relaterade API-element

Anger om det här objektet inkluderas i tabbordningen. Om detta värde är inkluderat i tabbordningen är värdet true, i annat fall är det false. Som standard är värdet false utom i följande fall:

• För ett SimpleButton-objekt är värdet true.
• För ett TextField-objekt med typ = "input" är värdet true.
• För ett Sprite-objekt eller MovieClip-objekt med buttonMode = true är värdet true.

Anger tabbordningen för objekt i en SWF-fil. tabIndex-egenskapen är -1 som standard, vilket innebär att inget tabbindexvärde läggs upp för objektet.

Om ett objekt som visas i SWF-filen innehåller en tabIndex-egenskap inaktiveras automatisk tabbordning. I stället beräknas tabbordningen från tabIndex-egenskaperna för objekten i SWF-filen. Den anpassade tabbordningen omfattar bara objekt som har tabIndex-egenskaper.

Egenskapen tabIndex måste vara ett positivt heltal. Objekten ordnas efter deras tabIndex-egenskaper i stigande ordning. Ett objekt med ett tabIndex-värde på 1 föregår ett objekt med ett tabIndex-värde på 2. Använd inte samma tabIndex-värde för flera objekt.

Den anpassade tabbordning som tabIndex-egenskapen definierar är flat. Det innebär att de hierarkiska förhållandena mellan objekt i SWF-filen inte har någon betydelse. Alla objekt i SWF-filen med tabIndex-egenskaper placeras i tabbordningen, som bestäms av ordningen för tabIndex-värden.

Obs! Om du vill ställa in tabbordningen för TLFTextField-instanser, ska du byta underordnat visningsobjekt för TLFTextField till ett InteractiveObject och sedan ställa in egenskapen tabIndex. Till exempel:

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

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

Returnerar ett TextSnapshot-objekt för den här DisplayObjectContainer-instansen.

Ett booleskt värde som anger om den pekande handen (handpekaren) ska visas när pekaren passerar över en sprite, vars buttonMode-egenskap är true. Standardvärdet för useHandCursor-egenskapen är true. Om useHandCursor sätts till true visas den pekande handen som används för knappar när pekaren passerar över en knappsprite. Om useHandCursor är false används pilmarkören i stället.

Du kan ändra egenskapen useHandCursor när som helst. Den ändrade spriten får automatiskt det nya markörutseendet.

Obs! Om ditt sprite-objekt i Flex eller Flash Builder har underordnade sprite-objekt kan det vara lämpligt att ange egenskapen mouseChildren som false. Om du till exempel vill att en handpekare visas över en Flex <mx:Label>-kontroll, ställer du in useHandCursor- och buttonMode-egenskaperna till true och mouseChildren-egenskapen till 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.

Lägger till en underordnad DisplayObject-instans i den här DisplayObjectContainer-instansen. Den underordnade läggs till framför (över) alla andra underordnade i denna DisplayObjectContainer-instans. (För att lägga till en underordnad till en specifik indexposition använder man addChildAt()-metoden.)

Om du lägger till ett underordnat objekt som redan har en annan visningsobjektbehållare som överordnad tas objektet bort från det andra visningsobjektets lista med underordnade.

Obs! Kommandot stage.addChild() kan orsaka problem med en publicerad SWF-fil, bl.a. säkerhetsproblem och konflikter med andra inlästa SWF-filer. Det finns bara en scen i en Flash-miljöinstans, oavsett hur många SWF-filer som läses in till miljön. Objekt bör därför egentligen aldrig läggas till direkt på scenen. Det enda objekt som bör finnas på scenen är rotobjektet. Skapa ett DisplayObjectContainer-objekt som ska innehålla alla objekt i visningslistan. Om det behövs lägger du därefter till den DisplayObjectContainer-instansen på scenen.

Parametrar

Lägger till en underordnad DisplayObject-instans i den här DisplayObjectContainer-instansen. Den underordnade läggs till i den specificerade indexpositionen. Ett indexvärde på 0 står för visningslistans baksida (botten) för detta DisplayObjectContainer-objekt.

I följande exempel visas tre visningsobjekt, betecknade a, b och c, i indexpositionerna 0, 2 och 1:

Om du lägger till ett underordnat objekt som redan har en annan visningsobjektbehållare som överordnad tas objektet bort från det andra visningsobjektets lista med underordnade.

Parametrar

Anger om säkerhetsrestriktionerna kan göra att visningsobjekt utelämnas från listan som returneras när DisplayObjectContainer.getObjectsUnderPoint()-metoden anropas med den angivna point-punkten. Normalt kan innehåll från en domän inte komma åt objekt från en annan domän, om de inte får tillstånd att göra det via ett anrop till metoden Security.allowDomain(). Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center.

point-parametern återfinns i scenens koordinatområde, som kan skilja sig från visningsobjektbehållarens koordinatområde (om visningsobjektbehållaren inte är scenen). Du kan använda globalToLocal()- och localToGlobal()-metoderna för att konvertera punkter mellan dessa koordinatområden.

Parametrar

Avgör om det angivna visningsobjektet är underordnat DisplayObjectContainer-instansen eller själva instansen. Sökningen omfattar hela visningslistan, inklusive denna DisplayObjectContainer-instans. Indirekta underordnade, indirekt indirekt underordnade, och så vidare, returnerar alla true.

Parametrar

Returnerar den underordnade visningsobjektsinstansen som finns vid det angivna indexvärdet.

Parametrar

Returnerar det underordnade visningsobjektet som har ett visst namn. Om mer än ett underordnat objekt har det angivna namnet returnerar metoden det första objektet i listan med underordnade.

getChildAt()-metoden är snabbare än getChildByName()-metoden. getChildAt()-metoden hittar en underordnad i en cache-lagrad array, under det att getChildByName()-metoden måste gå igenom en länkad lista för att hitta en underordnad.

Parametrar

Returnerar indexpositionen för en child-DisplayObject-instans.

Parametrar

Returnerar en array med objekt som ligger under den angivna punkten och är underordnade (eller indirekt underordnade) den här DisplayObjectContainer-instansen. Eventuella underordnade objekt som inte går att nå av säkerhetsskäl är inte med i den returnerade arrayen. Anropa areInaccessibleObjectsUnderPoint()-metoden för att ta reda på om denna säkerhetsbegränsning påverkar den returnerade arrayen.

point-parametern återfinns i scenens koordinatområde, som kan skilja sig från visningsobjektbehållarens koordinatområde (om visningsobjektbehållaren inte är scenen). Du kan använda globalToLocal()- och localToGlobal()-metoderna för att konvertera punkter mellan dessa koordinatområden.

Parametrar

Tar bort den angivna child-DisplayObject-instansen från listan med underordnade för DisplayObjectContainer-instansen. Den borttagna underordnades parent-egenskap sätts till null och objektet skräpsamlas om det inte finns några andra referenser till den underordnade. Indexpositionerna för eventuella visningsobjekt över det det underordnade i DisplayObjectContainer stegas ner med 1.

Skräpinsamlaren allokerar om oanvänt minnesutrymme. När en variabel eller ett objekt inte längre aktivt refereras till, eller sparas någonstans, sveper skräpinsamlaren igenom och torkar bort det minnesutrymme som den/det förut använde, om det inte finns någon referens till den/det.

Parametrar

Tar bort ett underordnat DisplayObject från den angivna index-positionen i den underordnade listan i DisplayObjectContainer. Den borttagna underordnades parent-egenskap sätts till null och objektet skräpsamlas om det inte finns några andra referenser till den underordnade. Indexpositionerna för eventuella visningsobjekt över det det underordnade i DisplayObjectContainer stegas ner med 1.

Skräpinsamlaren allokerar om oanvänt minnesutrymme. När en variabel eller ett objekt inte längre aktivt refereras till, eller sparas någonstans, sveper skräpinsamlaren igenom och torkar bort det minnesutrymme som den/det förut använde, om det inte finns någon referens till den/det.

Parametrar

Ändrar positionen för ett befintligt underordnat objekt i behållaren för visningsobjekt. Detta påverkar skiktningen av underordnade objekt. I följande exempel visas tre visningsobjekt, betecknade a, b och c, i indexpositionerna 0, 1 och 2:

När du använder setChildIndex()-metoden och anger en index-position som redan är upptagen, är de enda positioner som kan ändras de som ligger mellan visningsobjektets tidigare och nya position. Alla andra förblir desamma. Om en underordnad flyttas till ett index som är LÄGRE än dess nuvarande index kommer alla underordnade emellan att ÖKA med 1 i sin indexreferens. Om en underordnad flyttas till ett index som är HÖGRE än dess nuvarande index kommer alla underordnade emellan att MINSKA med 1 i sin indexreferens. Om visningsobjektbehållaren i föregående exempel exempelvis har namnet container så kan du växla positionerna för de visningsobjekt som är betecknade a och b genom att anropa följande kod:

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

Denna kod leder till följande objektordning:

Parametrar

Gör att användaren kan dra angiven sprite. Spriten fortsätter att vara dragbar tills den uttryckligen stoppas genom ett anrop till Sprite.stopDrag()-metoden eller tills en annan sprite görs dragbar. Bara en sprite kan vara dragbar åt gången.

Tredimensionella visningsobjekt följer pekaren och Sprite.startDrag() flyttar objektet inuti det tredimensionella planet som definieras av visningsobjektet. Om visningsobjektet är ett tvådimensionellt objekt och dessutom är ett underordnat objekt till ett tredimensionellt objekt, flyttas det tvådimensionella objektet inuti det tredimensionella plan som definieras av det överordnade tredimensionella objektet.

Parametrar

Avslutar startDrag()-metoden. En sprite som gjorts dragbart med startDrag()-metoden förblir dragbart tills en stopDrag()-metod läggs till eller tills en annan sprite blir dragbar. Bara en sprite kan vara dragbar åt gången.

Byter z-ordningen (framifrån och bakåt-ordning) för de två underordnade objekten. Samtliga övriga underordnade objekt i visningsobjektbehållaren blir kvar i samma indexpositioner.

Parametrar

Byter z-ordningen (framifrån och bakåt-ordning) för underordnade objekt vid de två angivna indexpositionerna i listan med underordnade objekt. Samtliga övriga underordnade objekt i visningsobjektbehållaren blir kvar i samma indexpositioner.

Parametrar