A key unit is a group of phone keys of the same type, for example: Context-Sensitive Keys, Dedicated Keys, Line Keys etc.

Depending on the type, a phone can have a different number of key units.

To see the key units and keys for your phone, open the phone settings by pressing the button, then click on Preferences → Function Keys .


Example 1:  max_pkey_units,  pkey_unit_name and max_pkeys

This example illustrates the usage of callbacks max_pkey_units,  pkey_unit_name and max_pkeys.

The pkey_unit_name value is translated.

<?xml version="1.0" encoding="UTF-8"?>
<SnomIPPhoneMenu>
	<Repeat values="$(enum:$(max_pkey_units))" token="|__UNIT__|">
		<MenuItem name="Unit '$(pkey_unit_name:__UNIT__)': $(max_pkeys:__UNIT__) Keys"></MenuItem>
	</Repeat>
</SnomIPPhoneMenu>


Results:


Example 2:  key_icon_type, key_setting, is_context_sensitive_key and is_dkey

This example extends the first example, but adds a sub-menu which prints some details about each key.

<?xml version="1.0" encoding="UTF-8"?>
<SnomIPPhoneMenu>
     <Repeat values="$(enum:$(max_pkey_units))" token="|__UNIT__|">
	<Menu name="Unit '$(pkey_unit_name:__UNIT__)': $(max_pkeys:__UNIT__) Keys">
		<IconSize>XXS</IconSize>
		<Repeat values="$(enum:$(max_pkeys:__UNIT__))" token="|__KEY__|">
			<MenuItem name="$(set:$(key_setting:__UNIT__:__KEY__))" id="fdp__KEY__">
				<IconType>$(key_icon_type:__UNIT__:__KEY__)</IconType>
				<If condition="$(is_context_sensitive_key:__UNIT__)">				
					<SubText>Context sensitive key</SubText>
				</If>
				<Elif condition="$(is_dkey:__UNIT__)">
					<SubText>Dedicated key</SubText>
				</Elif>				
			</MenuItem>
		</Repeat>
	</Menu>
    </Repeat>
</SnomIPPhoneMenu>


Result on D735:


Further Information


Related articles