--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/ui/bmi/mmiBookUtils.h	Fri Oct 16 06:33:10 2020 +0000
@@ -0,0 +1,205 @@
+#ifndef _MMIBOOKUTILS_H_
+#define _MMIBO0KUTILS_H_ 1
+
+/*******************************************************************************
+
+					CONDAT (UK)
+
+********************************************************************************                                                                              
+
+ This software product is the property of Condat (UK) Ltd and may not be
+ disclosed to any third party without the express permission of the owner.                                 
+                                                                              
+********************************************************************************
+
+ $Project name:	Basic MMI                                                      
+ $Project code:	BMI (6349)                                                           
+ $Module:		PhoneBook
+ $File:		    MmiBookUtils.h
+ $Revision:		1.0                                                       
+                                                                              
+ $Author:		Condat(UK)                                                         
+ $Date:		    25/10/00                                                      
+                                                                               
+********************************************************************************
+                                                                              
+ Description:
+ 
+    This module provides utility functions for the phone book.
+
+                        
+********************************************************************************
+
+ $History: MmiBookUtils.h
+
+	25/10/00			Original Condat(UK) BMI version.	
+	   
+ $End
+
+*******************************************************************************/
+
+
+/* Include the phonebook types package, it will probably be
+   required to get the basic types which are shared by the
+   phonebook modules.
+*/
+#include "MmiBookShared.h"
+#include "mfw_phb.h"
+/* SPR#1428 - SH - New Editor changes */
+#ifndef NEW_EDITOR
+#include "MmiEditor.h" //for editor size definitions
+#endif
+/* bookCurrentWindow
+
+   This returns the window handle associated with the current
+   MFW element
+*/
+tBookMfwHnd bookCurrentWindow( void );
+
+
+/* bookDefaultCallBack
+
+   This is a simple call back function which is invoked when
+   a not implemented dialog is displayed. We don't want anyone
+   outside of this module using it so define it as static,
+   this will still be callable from the info dialogs as it
+   will use the reference we set up.
+*/
+static tBookStatus bookDefaultCallBack( tBookMfwHnd win, UBYTE identifier, UBYTE reason );
+
+
+/* bookWindowData
+
+   This routine is designed to be invoked from within a menu
+   handler or call back function and will return a pointer to
+   the user data associated with the current MFW element.
+
+   The return value is a pointer to void, therefore the caller
+   is responsible for casting this to the correct type prior
+   to use.
+*/
+void *bookWindowData( void );
+
+
+/* bookMenuSelectedNumber
+
+   This will return the currently selected entry in the phone
+   book, when the routine is being called from a menu handler
+*/
+char *bookMenuSelectedNumber( void );
+
+
+/* bookNotImplemented
+
+   This will present an information dialog indicating the current
+   feature is still under development. This routine will use the
+   current MFW element to detect the handle of the parent window
+   if the incoming window handle is NULL.
+*/
+tBookStatus bookNotImplemented( tBookMfwHnd ParentWindowHandle );
+tBookStatus bookMenuNotImplemented( tBookMfwMenu *Menu, tBookMfwMenuItem *Item );
+
+
+
+
+/* Utility function to determine if the phone book is
+   still in the loading state
+*/
+int bookPhoneBookLoading( void );
+
+
+
+/* Utility functions just to throw a string onto the screen
+   primarily for debug purposes, the modal version will wait
+   for a user input before removing the message, the non-modal
+   will clear after three seconds
+*/
+tBookStatus bookInfoDialog( char *String1, char *String2 );
+tBookStatus bookInfoDialogModal( char *String, char *String2 );
+
+
+/* SPR#1428 - SH - New Editor: No longer required */
+#ifndef NEW_EDITOR
+/* Set editing attributes
+   This constructs a edit attribute block from the provided
+   parameters
+*/
+// GW - Changed colour from 8 bits (foreground) to 2x32bits fgd and bgd
+void bookSetEditAttributes(
+    int editZone,
+	U32  colindex,
+	U8  font,  U8  mode,  U8  *controls,
+	char *text,   U16 size,
+	MfwEdtAttr*   attr);
+#endif
+    
+/* Memory allocation and freeing functions
+
+   These routines provided guarded access to the malloc and free
+   routines used in the MMI application. The wrapper functions
+   provided here allow debugging and tracking information to be
+   easily derived, it also allows the memory allocation and
+   deallocation to be changed if required.
+
+   Note that the free routine takes a pointer to the pointer
+   to the memory being freed. This allows the actual pointer
+   value to be set to NULL as part of the free operation, this
+   helps protect against reusing the pointer after the memory
+   has been deallocated.
+
+   Sample usage:
+
+		tStructure *ptr;
+
+        if ( ( ptr = (tStructure *) bookMemAlloc( sizeof(tStructure) ) ) != NULL )
+		{
+			// use the allocated memory
+			//
+			...
+
+			// free the memory
+			//
+			bookMemFree( &ptr );
+		}
+*/
+void *bookMemAlloc( long int NumBytes );
+void bookMemFree( void **Pointer );
+
+
+
+/* Name handling utility functions
+*/
+UBYTE bookFindName(   UBYTE number, tMmiPhbData *current );
+//UBYTE changeName( UBYTE book,   T_MFW_PHB_ENTRY *entry, T_MFW_PHB_STATUS *currentStatus );
+//UBYTE deleteName( UBYTE book,   UBYTE index,            T_MFW_PHB_STATUS *currentStatus );
+//UBYTE addName(    UBYTE book,   T_MFW_PHB_ENTRY *entry, T_MFW_PHB_STATUS *currentStatus );
+
+/* File handling functions
+*/
+void changeInFile(   T_phbk *phbk );
+void deleteFromFile( T_phbk *phbk, UBYTE book );
+void storeInFile(    T_phbk *phbk );
+
+/* SPR#1112 - SH - Internal phonebook use */
+#ifdef INT_PHONEBOOK
+void bookChangePB(T_MFW_HND win, UBYTE identifier, UBYTE reason);
+UBYTE bookCopy( T_MFW_PHB_ENTRY *entry, T_MFW_PHB_STATUS	*destStatus, T_MFW_PHB_STATUS	*srcStatus, UBYTE move);
+void bookCopySingle(T_MFW_HND win, UBYTE identifier, UBYTE reason);
+void bookCopyMultiple(T_MFW_HND win, UBYTE move, UBYTE reason);
+#endif
+
+UBYTE bookGetCurrentStatus( T_MFW_PHB_STATUS *currentStatus );
+int bookEvent( MfwEvt e, void *para );
+
+/* Copy name in phonebook structure
+*/
+void bookCopyPhbName( T_MFW_PHB_ENTRY* destEntry, T_MFW_PHB_ENTRY* srcEntry, int maxLen );
+
+
+/*******************************************************************************
+                                                                              
+                                End of File
+                                                                              
+*******************************************************************************/
+
+#endif