Using IPv4AddressInput in Flex 3

In Getting Started, we looked at the usage of IPv4AddressInput with simple String values. Now, let's look more closely at the com.yahoo.astra.net.IPv4Address class. We'll start by adding a series of controls to our application in MXML.

<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" xmlns:yahoo="com.yahoo.astra.mx.controls.*" layout="vertical"> <mx:Panel title="Enter an IP Address" width="230" height="250" horizontalAlign="center" verticalAlign="middle"> <yahoo:IPv4AddressInput id="ipAddress" valueCommit="updateRawView()"/> <mx:Label text="IPv4Address" fontWeight="bold" paddingTop="10"/> <mx:Form width="100%" paddingTop="0"> <mx:FormItem label="toString()" width="100%"> <mx:Label id="ipv4String"/> </mx:FormItem> <mx:FormItem label="Byte 0" width="100%"> <mx:Label id="byte0"/> </mx:FormItem> <mx:FormItem label="Byte 1" width="100%"> <mx:Label id="byte1"/> </mx:FormItem> <mx:FormItem label="Byte 2" width="100%"> <mx:Label id="byte2"/> </mx:FormItem> <mx:FormItem label="Byte 3" width="100%"> <mx:Label id="byte3"/> </mx:FormItem> </mx:Form> </mx:Panel> </mx:Application>

This displays an IPv4AddressInput in a Panel container. Under the input is a form containing several labels that will present a readable view of the IPv4Address object.

You'll notice that on the valueCommit event, we call a function named updateRawView(). Let's add this function to our application in a <mx:Script> block.

private function updateRawView():void { //the value property is typed as Object because it accepts Strings and //ByteArrays, so we should cast it as IPv4Address var address:IPv4Address = ipAddress.value as IPv4Address; //simple toString conversion this.ipv4String.text = address.toString(); //raw bytes are available too this.byte0.text = address.bytes[0].toString(); this.byte1.text = address.bytes[1].toString(); this.byte2.text = address.bytes[2].toString(); this.byte3.text = address.bytes[3].toString(); }

Accessing the toString() method on the IPv4Address instance gives us the familiar ###.###.###.### IP address format as a String. Additionally, the IPv4Address class exposes a property named bytes which is a ByteArray instance of length 4 that holds that raw numeric bytes for the IP address. We display each byte individually in the form.

Download the MXML example file.

For additional information, please take a look at the Examples section for functional demonstrations and the ActionScript 3.0 Class Reference for full details on every property, method, and style available to the IPv4AddressInput component.