Skip to main content
Open topic with navigation CAPL Functions » ISO11783 » Virtual Terminal Interaction Layer (VT IL) » VTIL_RemoveKeyGroup

VTIL_RemoveKeyGroup

Valid for: CANoe DE • CANoe4SW DE

Function Syntax

  • VTIL_RemoveKeyGroup(dword maskIndex, dword position); // form 1
  • VTIL_RemoveKeyGroup(dbNode vt, dword maskIndex, dword position); // form 2

Description

Removes a Key Group from a User-Layout Soft Key Mask of the Virtual Terminal.

Parameters

  • maskIndex: Index of the User-Layout Mask, 0..10. Value of maskIndex must be smaller than the number of User-Layout Masks (which can be configured with VTIL_SetNodeProperty).
  • position: Removes the Key Group at this position in the User-Layout Soft Key Mask, 0..64. Position must be smaller than the number of User-Layout Soft Keys (which can be configured with VTIL_SetNodeProperty).
  • vt: VT simulation node to apply the function.

Return Values

  • 0: Key Group is successfully removed.
  • < 0: An error has occurred, see IL Error Code.

Example

See VTIL_AddKeyGroup Further Functions for VT – Handling (User-Layout Mask)