Click or drag to resize

PropertyID.QuickSettingsPanelTiles Field

Administrative Settings: For devices managed by an organization, administrative policies might require to restrict the user from changing the configuration of Quick Settings tiles.

Namespace: Com.Datalogic.Device.Configuration
Assembly: datalogic-xamarin-sdk (in datalogic-xamarin-sdk.dll) Version: 1.0.0.0 (1.0.0.0)
Syntax
C#
VB
public const Int32 QuickSettingsPanelTiles = "value"

Field Value

Type: Int32
Remarks
Administrative Settings: For devices managed by an organization, administrative policies might require to restrict the user from changing the configuration of Quick Settings tiles.

Tiles are interactive icons that appear in the Notification Quick Settings panel of the device. They provide users with quick access to commonly used device settings without the need to navigate through the full settings menu.

This parameter allows to create a custom configuration of Quick Settings tiles by defining the tiles which should be shown to the user. Configuring the tiles can prevent users from accessing to certain features. This is done to restrict and limit the users' capability to enhance security, device management, and prevent unauthorized or unintended changes.

The class of the property is TextProperty. This property is a string structured as a comma-separated list containing the tile names to be shown. If the list contains an invalid tile name, that tile will be ignored, while the others will be displayed in the UI. Since it's not possible to remove all the tiles from the UI, an empty string will not be accepted, therefore at least one valid tile name must be included in the list. Otherwise, the configuration will be discarded.

Examples:

  • "airplane,internet,battery" sets airplane mode, internet, and battery saver;
  • "airplane,foo,bar,internet" sets only airplane and internet, while 'foo' and 'bar' are discarded because they are not valid tile names;
  • "" is not allowed, therefore this configuration will be rejected;
  • "foo" is discarded because it is not a valid tile name. Since no valid tile names are in the list, this configuration will be rejected;
  • "default" resets tiles to the default list. It's a special value managed by Android;


Android offers two types of tiles in the Quick Settings panel: System and App tiles.
System tiles are built into the Android operating system and provide essential device functionalities. In contrast, App or Custom tiles offer quick access to functionalities provided by applications, such as Google Mobile Services (GMS). Therefore, they can be customized and added by installing third-party applications that provide this capability.

The list below shows the tiles available in Android 13. Please note that not all tiles in this list are supported by Datalogic devices, as this varies by model. Use the APIs QuickSettingsTiles.getAvailableSystemTiles(Context) and QuickSettingsTiles.getAvailableCustomTiles(Context) to retrieve the lists of system and custom tiles available at runtime on a Datalogic device.

Note on Tile Visibility and Interaction:

The Quick Settings panel includes two categories for tiles:

  • Visible Tiles: Tiles accessible to the user by scrolling down the notification panel.
  • Additional Tiles: Tiles not visible by default but can be dragged to the visible list by the user for quick access.

When tiles are disabled, they are removed from both the visible and additional tiles lists. Users cannot interact with disabled tiles, nor can they trigger actions or drag them into the visible list. When a disabled tile is enabled again, it is added to the additional tiles list, but not automatically to the visible tiles list. The user can configure that tile to be visible by dragging it from the additional tiles list to the visible tiles list using the pen icon in the bottom right corner of the Quick Settings panel. Alternatively, this can be done programmatically by configuring the visible tiles through the Visible Tiles property.

System tiles:

  • Internet: 'internet'
  • Bluetooth: 'bt'
  • Flashlight: 'flashlight'
  • Do Not Disturb: 'dnd'
  • Alarm: 'alarm'
  • Airplane: 'airplane'
  • Device Controls: 'controls'
  • Wallet: 'wallet'
  • Auto-rotate: 'rotation'
  • Battery Save: 'battery'
  • Screen Cast: 'cast'
  • Screen Record: 'screenrecord'
  • Mic Access: 'mictoggle'
  • Camera Access: 'cameratoggle'
  • Stylus/Glove Touch: 'touch_stylus'
  • Location: 'location'
  • Hotspot: 'hotspot'
  • Color Inversion: 'inversion'
  • Data Saver: 'saver'
  • Dark Theme: 'dark'
  • Work Apps: 'work'
  • Night Light: 'night'
  • Extra Dim: 'reduce_brightness'
  • QR Code Scanner: 'qr_code_scanner'
  • One Handed: 'onehanded'
  • Color Correction: 'color_correction'
  • Screen Saver: 'dream'
  • Font Size: 'font_scaling'

Google custom tiles:
  • Nearby Share: 'custom(com.google.android.gms/.nearby.sharing.SharingTileService)'
  • Storage: 'custom(com.google.android.apps.nbu.files/.quicksettings.StorageAssistantTileService)'
  • Focus Mode: 'custom(com.google.android.apps.wellbeing/.focusmode.quicksettings.FocusModeTileService)'
  • Bedtime mode: 'custom(com.google.android.apps.wellbeing/.screen.ui.GrayscaleTileService)'
  • Calculator: 'custom(com.google.android.calculator/com.android.calculator2.CalculatorTileService)'

Other tiles:
  • Memory Usage: 'custom(com.android.permissioncontroller/.permission.service.SafetyCenterQsTileService)'

[Android Documentation]

See Also