Edit Box

Microchip Graphics Library

Microchip Graphics Library
Edit Box

Edit Box supports only Keyboard inputs, replying to their events with the following messages: 

1. EB_MSG_CHAR - when a character is to be inserted at the end of the current text. 

2. EB_MSG_DEL - when a character is to be removed from the current text. 

 

The Edit Box Object is rendered using the assigned style scheme. The following figure illustrates the color assignments. 

 

 

Functions
 
Name 
Description 
 
This function creates a EDITBOX object with the parameters given and initializes the default settings. It automatically attaches the new object into a global linked list of objects and returns the address of the object. 
 
This function renders the object on the screen using the current parameter settings. Location of the object is determined by the left, top, right and bottom parameters. The colors used are dependent on the state of the object. The font used is determined by the style scheme set.
When rendering objects of the same type, each object must be rendered completely before the rendering of the next object is started. This is to avoid incomplete object rendering. 
 
This function sets the text to be used for the object. 
 
This function inserts a character at the end of the text used by the object. 
 
This function removes a character at the end of the text used by the object. 
 
This function performs the actual state change based on the translated message given. The following state changes are supported:  
 
This function evaluates the message from a user if the message will affect the object or not. The table below enumerates the translated messages for each event of the touch screen and keyboard inputs.
 
Macros
Name 
Description 
This macro returns the address of the current text string used for the object. 
Structures
Name 
Description 
Defines the parameters required for a Edit Box Object. 
Topics
Name 
Description 
List of Edit Box bit states. 
Links
Microchip Graphics Library Version 3.06.02 - October 15, 2012
Copyright © 2012 Microchip Technology, Inc.  All rights reserved