IUITextField  - AS3 Flex

Om inställningen är true och textfältet inte är i fokus markerar Flash Player markeringen i textfältet med grått. Om inställningen är false och textfältet inte är i fokus markerar Flash Player markeringen i textfältet med grått.

Den typ av kantutjämning som används för det här textfältet. Använd flash.text.AntiAliasType-konstanter för den här egenskapen. Du kan bara styra inställningen om teckensnittet är inbäddat (med egenskapen embedFonts inställd på true). Standardinställningen är flash.text.AntiAliasType.NORMAL.

Använd följande strängvärden när du ska ange värden för den här egenskapen:

Styr automatisk storleksinställning och justering av textfält. Tillåtna värden för TextFieldAutoSize-konstanter: TextFieldAutoSize.NONE (standard), TextFieldAutoSize.LEFT, TextFieldAutoSize.RIGHT och TextFieldAutoSize.CENTER.

Om autoSize är inställt på TextFieldAutoSize.NONE (standard) görs ingen storleksändring.

Om autoSize är inställd på TextFieldAutoSize.LEFT behandlas texten som vänsterjusterad text, vilket innebär att den vänstra sidan av textfältet förblir fast och eventuell storleksändring av en enstaka rad i textfältet sker på höger sida. Om texten innehåller en radbrytning (till exempel "\n" eller "\r") ändras storleken på den nedersta delen så att den passar med nästa textrad. Om wordWrap också är inställd på true ändras storleken bara för den nedersta delen av textfältet, medan högersidan förblir fast.

Om autoSize är inställd på TextFieldAutoSize.RIGHT behandlas texten som högerjusterad text, vilket innebär att den högra sidan av textfältet förblir fast och storleksändring av en enstaka rad i textfältet sker på vänster sida. Om texten innehåller en radbrytning (till exempel "\n" eller "\r") ändras storleken på den nedersta delen så att den passar med nästa textrad. Om wordWrap också är inställd på true ändras storleken bara för den nedersta delen av textfältet, medan vänstersidan förblir fast.

Om autoSize är inställd på TextFieldAutoSize.CENTER behandlas texten som centrerad text, vilket innebär att en storleksändring av en enstaka rad i textfältet distribueras jämnt på vänster och höger marginal. Om texten innehåller en radbrytning (till exempel "\n" eller "\r") ändras storleken på den nedersta delen så att den passar med nästa textrad. Om wordWrap också är inställd på true ändras storleken bara för den nedersta delen av textfältet, medan höger och vänster sida förblir fasta.

Anger om textfältet har en bakgrundsfyllning. Värdet true innebär att textfältet har en bakgrundsfyllning. Värdet false innebär att textfältet inte har någon bakgrundsfyllning. Använd egenskapen backgroundColor för att ställa in bakgrundsfärgen i ett textfält.

Färgen på textfältets bakgrund. Standardvärdet är 0xFFFFFF (vitt). Egenskapen kan hämtas eller ställas in, även om det inte finns någon bakgrund, men färgen är bara synlig om textfältet har egenskapen background inställd på true.

Anger om textfältet har en kantlinje. Värdet true innebär att textfältet har en kantlinje. Värdet false innebär att textfältet inte har en kantlinje. Använd egenskapen borderColor för att ställa in kantlinjefärgen.

Färgen på textfältets kantlinje. Standardvärdet är 0x000000 (svart). Egenskapen kan hämtas eller ställas in, även om det inte finns någon kantlinje, men färgen är bara synlig om textfältet har egenskapen border inställd på true.

Ett heltal (ett 1-baserat indexvärde) som visar den nedersta raden som är synlig i textfältet som anges. Se textfältet som ett fönster på ett textblock. Egenskapen scrollV är det ettbaserade indexvärdet i den översta synliga raden i fönstret.

All text mellan raderna som anges av scrollV och bottomScrollV är synliga i textfältet.

Indexvärdet för inmatningspunkten. Om ingen inmatningspunkt visas är värdet det läge inmatningspunkten skulle ha om du återställde fokus till fältet (vanligtvis på den plats inmatningspunkten senast var, eller noll om fältet inte haft något fokus).

Index för markeringsomfång är nollbaserade (den första positionen är 0, den andra är 1 och så vidare).

Ett booleskt värde som anger om extra tomrum (blanksteg, radbrytningar o.s.v.) i ett textfält med HTML-text tas bort. Standardvärdet är false. Egenskapen condenseWhite påverkar bara text som anges med egenskapen htmlText, inte med egenskapen text. Om du anger text med egenskapen text ignoreras condenseWhite.

Om du ställer in condenseWhite på true måste du använda standard-HTML-kommandon, till exempel <BR> och <P>, för att placera radbrytningar i textfältet.

Ställ in egenskapen condenseWhite innan du ställer in egenskapen htmlText.

Anger vilket format som ska användas för nyinfogad text, till exempel text som anges av en användare eller text som infogas med metoden replaceSelectedText().

Obs! När tecken som ska bytas ut markeras med setSelection() och replaceSelectedText(), används defaultTextFormat endast om texten har markerats upp till och med det sista tecknet. Exempel:

     var my_txt:TextField new TextField();
     my_txt.text = "Flash Macintosh version";
     var my_fmt:TextFormat = new TextFormat();
     my_fmt.color = 0xFF0000;
     my_txt.defaultTextFormat = my_fmt;
     my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied
     my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied
     my_txt.replaceSelectedText("Windows version");
     

När du kommer åt egenskapen defaultTextFormat definieras alla egenskaper för TextFormat-objektet som returneras. Ingen egenskap är null.

Obs! Du kan inte ange den här egenskapen om en formatmall används på textfältet.

Anger om textfältet har ett lösenord. Om värdet för egenskapen är true behandlas textfältet som ett password-textfält som döljer inmatningstecknen med asterisker i stället för de riktiga tecknen. Värdet false innebär att textfältet inte behandlas som ett password-textfält. När password-läget är aktiverat fungerar inte kommandona Klipp ut och Klistra in eller deras motsvarande kortkommandon. Den här säkerhetstekniken förebygger att obehöriga användare använder genvägar för att ta reda på ett lösenord på en dator som är obevakad.

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 om rendering ska göras med inbäddade teckensnittskonturer. Om det är false visar Flash Player textfältet med enhetens teckensnitt.

Om du ställer in egenskapen embedFonts på true för ett textfält måste du ange ett teckensnitt för den texten med hjälp av font-egenskapen i ett TextFormat-objekt som tillämpas på textfältet. Om det angivna teckensnittet inte är inbäddat i SWF-filen visas inte texten.

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.

Den typ av rutnätspassning som används för det här textfältet. Den här egenskapen gäller bara om textfältets flash.text.AntiAliasType-egenskap är inställd på flash.text.AntiAliasType.ADVANCED.

Den typ av rutnätspassning som används avgör om Flash Player tvingar tydliga vågräta och lodräta rader att passa till ett pixel- eller delpixelrutnät, eller inte alls.

För egenskapen flash.text.GridFitType kan du använda följande strängvärden:

Innehåller HTML-representationen av textfältets innehåll.

Flash Player stöder följande HTML-taggar:

Flash Player och AIR stöder följande HTML-entiteter:

I Flash Player och AIR stöds även explicita teckenkoder, t.ex. & (et-tecken, ASCII) och € (Unicode, €-symbol).

If true, the paddingLeft and paddingRight styles will not add space around the text of the component.

The beginning of this UITextField's chain of inheriting styles. The getStyle() method accesses inheritingStyles[styleName] to search the entire prototype-linked chain. This object is set up by the initProtoChain() method. You typically never need to access this property directly.

Antalet tecken i ett textfält. Ett tecken som tabb (\t) räknas som ett tecken.

Det maximala antal tecken som en användare kan skriva i textfältet. Ett skript kan infoga mer text än vad maxChars tillåter. Egenskapen maxChars visar bara hur mycket text som en användare kan ange. Om värdet för den här egenskapen är 0 finns det ingen gräns för hur mycket text som en användare kan ange.

Maxvärdet för scrollH.

Maxvärdet för scrollV.

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.

Ett booleskt värde som anger om Flash Player automatiskt ska rulla textfält med flera rader när användaren klickar i ett textfält och rullar på mushjulet. Standardvärdet är true. Egenskapen är användbar om du vill förhindra att mushjulet rullar textfält eller om du vill implementera egen rullning av textfält.

Anger om textfältet har flera rader. Om värdet är true har textfältet flera rader. Om värdet är false har textfältet en rad. I ett fält av typen TextFieldType.INPUT avgör värdet multiline om Enter-tangenten skapar en ny rad (om värdet är false ignoreras Enter-tangenten). Om du klistrar in text i TextField med ett multiline-värde som är false tas nya rader bort ur texten.

Depth of this object in the containment hierarchy. This number is used by the measurement and layout code. The value is 0 if this component is not on the DisplayList.

The beginning of this UITextField's chain of non-inheriting styles. The getStyle() method accesses nonInheritingStyles[styleName] method to search the entire prototype-linked chain. This object is set up by the initProtoChain() method. You typically never need to access this property directly.

Unlike textHeight, this returns a non-zero value even when the text is empty. In this case, it returns what the textHeight would be if the text weren't empty.

Definierar antalet textrader i ett textfält med flera rader. Om wordWrap-egenskapen är inställd på true ökar antalet rader när texten figursätts.

Anger den teckenuppsättning en användare kan använda för att skriva i textfältet. Om värdet för egenskapen restrict är null kan du skriva vilket tecken som helst. Om värdet för egenskapen restrict är en tom sträng kan du inte skriva vilket tecken som helst. Om värdet för restrict-egenskapen är en teckensträng kan du bara ange tecknen i strängen i textfältet. Strängen läses från vänster till höger. Du kan ange intervall med hjälp av bindestreck (-). Endast användarinteraktionen är begränsad; ett skript kan lägga in alla slags texter i textfältet. Egenskapen synkroniseras inte med alternativen Bädda in teckensnittskonturer i egenskapsinspektören.

Om strängen börjar med cirkumflexen (^) accepteras alla tecken utom de som anges i strängen. Om strängen inte börjar med cirkumflexen (^) accepteras bara de tecken som anges i strängen.

I följande exempel tillåts bara att stora bokstäver, mellanslag och siffror i ett textfält:

     my_txt.restrict = "A-Z 0-9";
     

I följande exempel tillåts alla tecken utom små bokstäver:

     my_txt.restrict = "^a-z";
     

Du kan använda omvänt snedstreck för att ange ett ^ eller - ordagrant. Sekvenserna med omvänt snedstreck är \-, \^ eller \\. Det omvända snedsträcket måste vara ett faktiskt tecken i strängen. Två omvända snedstreck måste användas i ActionScript. I följande kod finns bara strecket (-) och cirkumflexen (^):

     my_txt.restrict = "\\-\\^";
     

^ kan användas var som helst i strängen för att växla mellan att inkludera och exkludera tecken. I följande exempel tillåts bara stora bokstäver, men stora Q utesluts:

     my_txt.restrict = "A-Z^Q";
     

Du kan använda escape-sekvensen \u för att skapa restrict-strängar. I följande kod inkluderas bara tecknen från ASCII 32 (mellanslag) till ASCII 126 (tilde).

     my_txt.restrict = "\u0020-\u007E";
     

Den vågräta rullningspositionen. Om egenskapen scrollH är 0 rullas inte texten vågrätt. Egenskapsvärdet är ett heltal som representerar den vågräta positionen i pixlar.

Enheten för vågrät rullning är pixlar, medan enheten för lodrät rullning är rader. Vågrät rullning mäts i pixlar, eftersom de flesta teckensnitten som du använder har proportionella mellanrum. Det innebär att tecknen kan ha olika bredd. Flash Player utför lodrät rullning efter rad, eftersom användare vanligtvis vill se en hel textrad i stället för en ofullständig rad. Även om det finns flera teckensnitt på en rad anpassas radens höjd för att passa det största teckensnittet som används.

Obs! Egenskapen scrollH är nollbaserad, inte ettbaserad som den lodräta rullningsegenskapen scrollV.

Den lodräta positionen för texten i ett textfält. Egenskapen scrollV är användbar när användare vill hitta ett visst stycke i en lång text eller ska skapa rullningsbara textfält.

Enheten för lodrät rullning är rader, medan enheten för vågrät rullning är pixlar. Om den första visade raden är den första raden i textfältet ställs scrollV in på 1 (inte 0). Vågrät rullning mäts i pixlar, eftersom de flesta teckensnitten har proportionella mellanrum. Det innebär att tecknen kan ha olika bredd. Flash utför lodrät rullning efter rad, eftersom användare vanligtvis vill se en hel textrad i stället för en ofullständig rad. Även om det finns flera teckensnitt på en rad anpassas radens höjd för att passa det största teckensnittet som används.

Ett booleskt värde som anger om ett textfält är markeringsbart. Värdet true anger att texten är markeringsbar. Egenskapen selectable kontrollerar om ett textfält är markeringsbart, inte om det är redigeringsbart. Ett dynamiskt textfält kan vara markeringsbart även om det inte är redigeringsbart. Om ett dynamiskt textfält inte är markeringsbart går det inte att markera texten i det.

Om selectable är inställt på false svarar inte texten i textfältet på markeringskommandon från musen eller tangentbordet, och texten kan inte kopieras med hjälp av kommandot Kopiera. Om selectable är inställt på true kan texten i textfältet markeras med musen eller tangentbordet, och texten kan kopieras med hjälp av kommandot Kopiera. Du kan markera text på det här sättet även om textfältet är dynamiskt i stället för ett textinmatningsfält.

Det nollbaserade teckenindexvärdet för det första tecknet i den aktuella markeringen. Det första tecknet är 0, det andra 1 och så vidare. Om ingen text är markerad är värdet för den här egenskapen caretIndex.

Det nollbaserade teckenindexvärdet för det sista tecknet i den aktuella markeringen. Det första tecknet är 0, det andra 1 och så vidare. Om ingen text är markerad är värdet för den här egenskapen caretIndex.

Skärpan på specialtecknens kanter i det här textfältet. Den här egenskapen gäller bara om textfältets flash.text.AntiAliasType-egenskap är inställd på flash.text.AntiAliasType.ADVANCED. Intervallet för sharpness är ett tal från -400 till 400. Om du försöker ställa in sharpness på ett värde utanför det intervallet ställer Flash in egenskapen på det närmsta värdet som är i intervallet (antingen -400 eller 400).

Kopplar en formatmall till textfältet. Information om att skapa formatmallar finns i klassen StyleSheet och Utvecklarhandbok för Adobe ActionScript 3.0.

Du kan när som helst byta ut den formatmall som är kopplad till ett textfält. Om formatmallen byts ut ritas textfältet om med den nya formatmallen. Du kan ställa in formatmallen på null eller undefined om du vill ta bort formatmallen. Om formatmallen som används tas bort ritas textfältet om utan formatmall.

Obs! Om formatmallen tas bort ändras innehållet i både TextField.text och TextField.htmlText till att omfatta den formatering som tidigare använts i formatmallen. Om du vill bevara det ursprungliga TextField.htmlText-innehållet utan formateringen sparar du värdet i en variabel innan du tar bort formatmallen.

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;
	 

En sträng som utgör den nuvarande texten i textfältet. Rader avgränsas med vagnreturtecknet ('\r', ASCII 13). Den här egenskapen innehåller oformaterad text i textfältet utan HTML-taggar.

Om du vill hämta texten i HTML-format använder du egenskapen htmlText.

Obs! Om en formatmall används på textfältet tolkas innehållet i egenskapen text som HTML.

Färgen på texten i ett textfält, i hexadecimalt format. I det hexadecimala färgsystemet används sex siffror som representerar färgvärden. Varje siffra har 16 möjliga värden eller tecken. Teckenintervallet går från 0 till -9 och sedan från A till F. Svart är till exempel 0x000000 och vitt är 0xFFFFFF.

Textens höjd i pixlar.

Textens bredd i pixlar.

Tjockleken på specialtecknens kanter i det här textfältet. Den här egenskapen gäller bara när flash.text.AntiAliasType är inställd på flash.text.AntiAliasType.ADVANCED.

Intervallet för thickness är ett tal från -200 till 200. Om du försöker ställa in thickness på ett värde utanför det intervallet ställs egenskapen in på det närmsta värdet som är i intervallet (antingen -200 eller 200).

Textfältets typ. Någon av följande TextFieldType-konstanter: TextFieldType.DYNAMIC som anger ett dynamiskt textfält som användaren inte kan redigera, eller TextFieldType.INPUT som anger ett inmatningsfält som användaren kan redigera.

Anger om textformateringen ska kopieras och klistras in med texten. Om värdet är true kopierar och klistrar Flash Player in formatering (t.ex. justering, fetstil och kursiv stil) när du kopierar och klistrar in mellan textfält. För både original- och måltextfältet måste useRichTextClipboard vara inställt på true. Standardvärdet är false.

Ett booleskt värde som anger om textfältet har automatisk radbrytning. Om värdet för wordWrap är true innehåller textfältet automatisk radbrytning. Är värdet false innehåller textfältet inte automatisk radbrytning. Standardvärdet är false.

Lägger till strängen som angetts av parametern newText på en del av eller all text i ett textfält. Den här metoden är effektivare än additionstilldelning (+=) på en text-egenskap (t.ex. someTextField.text += moreText), särskilt för ett textfält med mycket innehåll.

Parametrar

Returnerar en rektangel som utgör tecknets begränsningsram.

Parametrar

Returnerar det nollbaserade indexvärdet för tecknet vid den punkt som anges av parametrarna x och y.

Parametrar

Returnerar ett givet teckenindexvärde för det första tecknet i samma stycke.

Parametrar

Returnerar en DisplayObject-referens för givet id för en bild eller SWF-fil som har lagts till i ett HTML-formaterat textfält med en <img>-tagg. Taggen <img> har följande format:

   <img src = 'filename.jpg' id = 'instanceName' >

Parametrar

Returnerar det nollbaserade indexvärdet för raden vid den punkt som anges av parametrarna x och y.

Parametrar

Returnerar det nollbaserade indexvärdet för raden som innehåller tecknet som anges av parametern charIndex.

Parametrar

Returnerar antalet tecken på en viss textrad.

Parametrar

Returnerar måttinformation om en viss textram.

Parametrar

Returnerar teckenindexvärdet för det första tecknet på raden som anges av parametern lineIndex.

Parametrar

Returnerar texten på raden som anges av parametern lineIndex.

Parametrar

Returnerar längden på det stycke som innehåller ett givet teckenindexvärde. Längden anges i förhållande till det första tecknet i stycket (som returneras av getFirstCharInParagraph()), inte i förhållande till det teckenindexvärde som skickats.

Parametrar

Gets a style property that has been set anywhere in this component's style lookup chain.

This same method is used to get any kind of style property, so the value returned can be a Boolean, String, Number, int, uint (for an RGB color), Class (for a skin), or any kind of object. Therefore the return type is simply specified as *.

If you are getting a particular style property, you know its type and often want to store the result in a variable of that type. No casting from * to that type is necessary.

var backgroundColor:uint = getStyle("backgroundColor");

If the style property has not been set anywhere in the style lookup chain, the value returned by getStyle() is undefined. Note that undefined is a special value that is not the same as false, "", NaN, 0, or null. No valid style value is ever undefined. You can use the method IStyleManager2.isValidStyleValue() to test whether the value was set.

Parametrar

Returnerar ett TextFormat-objekt som innehåller formateringsinformation för textintervallet som anges av parametrarna beginIndex och endIndex. Endast egenskaper som är gemensamma för hela den angivna texten ställs in i det resulterande TextFormat-objektet. Alla egenskaper som är mixed, vilket innebär att de har olika värden på olika ställen i texten, har värdet null.

Om du inte anger värden för de här parametrarna används metoden på hela texten i textfältet.

I följande tabell beskrivs tre möjliga användningar:

Parametrar

Returns a UITextFormat object that contains formatting information for this component. This method is similar to the getTextFormat() method of the flash.text.TextField class, but it returns a UITextFormat object instead of a TextFormat object.

The UITextFormat class extends the TextFormat class to add the text measurement methods measureText() and measureHTMLText().

Ersätter markeringen med innehållet i parametern value. Texten infogas i markeringens position med standardteckenformatet och standardstyckeformatet. Texten behandlas inte som HTML.

Du kan använda metoden replaceSelectedText() för att infoga och ta bort text utan att störa tecken- och styckeformateringen i resten av texten.

Obs!Metoden fungerar inte om en formatmall används på textfältet.

Parametrar

Ersätter teckenintervallet som anges av parametrarna beginIndex och endIndex med innehållet i parametern newText. Texten från beginIndex till endIndex-1 ersätts.

Obs!Metoden fungerar inte om en formatmall används på textfältet.

Parametrar

Sets the font color of the text.

Parametrar

Sets the focus to this component. The component can in turn pass focus to a subcomponent.

Note: Only the TextInput and TextArea controls show a highlight when this method sets the focus. All controls show a highlight when the user tabs to the control.

Anges som markerad text som definierats av indexvärdena för det första och sista tecknet, som anges med parametrarna beginIndex och endIndex. Om de två parametervärdena är desamma anger den här metoden en inmatningspunkt, precis som om egenskapen caretIndex anges.

Parametrar