ArcPad Scripting Object Model
AddLayerFromFile Method
See Also  Example  Send comments on this topic.
Required. A string that represents the complete file path to the layer.
Map Object : AddLayerFromFile Method

Glossary Item Box


Loads an existing layer into the current map and returns a reference to the layer.


Set variable = object.AddLayerFromFile ( FileName )


Required. A string that represents the complete file path to the layer.

Return Type


  • FilePath is a string representing the complete file path to the layer. If a map file (.apm) is specified, all layers in the map file will be added to the existing map, but none of the properties defined in the map file will be applied.


  • If the specified layer is not successfully added to the map, AddLayerFromFile will return the keyword Nothing. You can check for this return value with the Is operator. For example:

           Dim pLyr
           Set pLyr = Map.AddLayerFromFile("C:\nonexistantlayer.shp")
           If pLyr Is Nothing Then
               'Add layer failed
               'Add layer succeeded
           End If


  • The file path for loading an AXF layer is slightly different.

    For example, to add the Poles layer in the Riverside sample date to a map:



Gets an ArcPad map or layer file (via Open dialog box) and adds it to the current map.
ShowOpen Example (VBScript)Copy Code
Sub AddLayerExample
  Dim strDefExt, strFileFilter, strTitle, lngFlags, varResult
  'Set the arguments of the Open dialog box
  strDefExt = "apl"
  strFileFilter = "ArcPad Maps|*.apm|ArcPad Layers|*.jpg;*.shp;*.sid"
  strTitle = "Select ArcPad Data"
  lngFlags = &H1000   'only allow existing files to be specified
  'Show the Open dialog box and get the result
  varResult = CommonDialog.ShowOpen(strDefExt,strFileFilter,strTitle,lngFlags)
  'If a file is selected, add it to the map and refresh the map  
  If Not IsEmpty (varResult) Then  
    Application.Map.AddLayerFromFile (varResult)  
  End If
End Sub

See Also

© 2013 All Rights Reserved.