ConvertibleSlateHint

Note   Starting with Windows 10, version 1703, this setting can no longer be used in provisioning packages. For more information on changes to the Windows Provisioning Framework, see Windows Provisioning Framework. This setting may have a Configuration Service Provider (CSP) equivalent that can be used instead. To determine if a CSP for this setting exists, see the description below.

 

ConvertibleSlateHint specifies whether the device has a physical keyboard. Windows uses this setting when determining whether to show an on-screen keyboard. For example, when the user receives a prompt that can accept keyboard input on a tablet, the on-screen keyboard appears.

This setting is related to ConvertibleSlateModePromptPreference, which determines whether to prompt the user to show or hide the keyboard whenever the device changes modes, for example, when the keyboards is attached/detached or rotated to be accessible/inaccessible.

For tablets or other devices that don’t have a keyboard, set ConvertibleSlateMode to 0.

For laptops or other devices that always have an accessible keyboard, set ConvertibleSlateMode to 1.

For convertible or detachable devices that sometimes have an accessible keyboard:

  • Set ConvertibleSlateMode to 0.
  • Set ConvertibleSlateModePromptPreference to 1.
  • Set up a GPIO pin and a GPIO Injection Driver to detect the mode. When the mode changes, the driver should update the registry value of HKLM/System/CurrentControlSet/Control/PriorityControl/ConvertibleSlateMode.
  • For devices that can use Windows 10 Continuum feature, also see the topic: Continuum.

For devices without a touchscreen, this setting does nothing. Even if you set this setting, Windows assumes a physical keyboard is present and will not show the on-screen keyboard.

Values

1

Laptop mode: Specifies that the device has a physical keyboard accessible to the user.

When a system is specified to have a laptop form factor, it has the following behavior:

  • The touch keyboard doesn’t automatically display when the user taps an edit field.
  • The screen auto-rotation is disabled.
  • The rotation lock button, found on the charms menu, is disabled.

0

Tablet mode: Specifies that the device does not have a physical keyboard accessible to the user.

When a system is specified to have a tablet form factor, it has the following behavior:

  • The touch keyboard automatically displays when the user taps an edit field.
  • The screen auto-rotation is enabled.
  • The rotation lock button, found on the charms menu, is enabled.

This is the default value.

 

Valid configuration passes

specialize

offlineServicing

Applies to

Windows edition x86-based devices x64-based devices
Windows 10 for desktop editions (Home, Pro, Enterprise, and Education) x86 amd64, wow64

 

 

 

Send comments about this topic to Microsoft