ArcGIS Runtime SDK for .NET Samples

Change sublayer visibility

Change sublayer visibility


// Copyright 2016 Esri.
// Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
// You may obtain a copy of the License at:
// Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an 
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific 
// language governing permissions and limitations under the License.

using Android.App;
using Android.OS;
using Android.Views;
using Android.Widget;
using Esri.ArcGISRuntime.Mapping;
using Esri.ArcGISRuntime.UI.Controls;
using System;
using System.Linq;

namespace ArcGISRuntime.Samples.ChangeSublayerVisibility
        "Change sublayer visibility",
        "This sample demonstrates how to show or hide sublayers of a map image layer.",
    public class ChangeSublayerVisibility : Activity
        // Create and hold reference to the used MapView
        private MapView _myMapView = new MapView();

        // Hold reference to image layer for easier access to sublayers 
        private ArcGISMapImageLayer _imageLayer;

        protected override void OnCreate(Bundle bundle)

            Title = "Change sublayer visibility";
            // Create the UI, setup the control references and execute initialization 

        private void Initialize()
            // Create new Map
            Map myMap = new Map();

            // Create uri to the map image layer
            var serviceUri = new Uri(

            // Create new image layer from the url
            _imageLayer = new ArcGISMapImageLayer(serviceUri)
                Name = "World Cities Population"

            // Add created layer to the basemaps collection

            // Assign the map to the MapView
            _myMapView.Map = myMap;

        private async void OnSublayersClicked(object sender, EventArgs e)
            // Make sure that layer and it's sublayers are loaded
            // If layer is already loaded, this returns directly
            await _imageLayer.LoadAsync();

            var sublayersButton = sender as Button;

            // Create menu to change sublayer visibility
            var sublayersMenu = new PopupMenu(this, sublayersButton);
            sublayersMenu.MenuItemClick += OnSublayersMenuItemClicked;

            // Create menu options
            foreach (ArcGISSublayer sublayer in _imageLayer.Sublayers)

            // Set values to the menu items
            for (int i = 0; i < sublayersMenu.Menu.Size(); i++)
                var menuItem = sublayersMenu.Menu.GetItem(i);

                // Set menu item to contain checkbox
                // Set default value

            // Show menu in the view

        private void OnSublayersMenuItemClicked(object sender, PopupMenu.MenuItemClickEventArgs e)
            // Change the checked value

            // Get title from the selected item
            var selectedSublayerTitle = e.Item.TitleCondensedFormatted.ToString();

            // Get index that is used to get the selected url
            var sublayer = _imageLayer.Sublayers.First(x => x.Name == selectedSublayerTitle);
            sublayer.IsVisible = e.Item.IsChecked;

        private void CreateLayout()
            // Create a new vertical layout for the app
            var layout = new LinearLayout(this) { Orientation = Orientation.Vertical };

            // Create button to show possible map options
            var mapsButton = new Button(this);
            mapsButton.Text = "Sublayers";
            mapsButton.Click += OnSublayersClicked;

            // Add maps button to the layout

            // Add the map view to the layout

            // Show the layout in the app

In this topic
  1. Code