Skip to main content

MdispMFC

This example shows how to use AIL in an MFC project. It integrates MFC menus, menu bars, user-created child windows, etc. with AIL displays, buffers, timers and a digitizer.

Language: C++

Functions used: MbufClear, MappAlloc, MappControl, MappFree, MappHookFunction, MbufAllocColor, MbufFree, MdigAlloc, MdigFree, MdigInquire, MdispAlloc, MdispControl, MdispFree, MdispSelect, MsysAlloc, MsysFree, MsysInquire

Categories: Overview, General, Industries, Applications, Modules, Buffer, Display, Digitizer, What's New, AIL 10.0 SP5, Older

///////////////////////////////////////////////////////////////////////////////
// Aurora Imaging Library
// Filename:    MdispMFC.cpp
//
// Description: Defines the class behaviors for the application.
//
// (C) 1992-2026 Zebra Technologies Corp. and/or its affiliates
// All Rights Reserved
///////////////////////////////////////////////////////////////////////////////

#include "stdafx.h"
#include "MdispMFC.h"

#include "MainFrm.h"
#include "ChildFrm.h"
#include "MdispMFCDoc.h"
#include "MdispMFCView.h"

#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif

/////////////////////////////////////////////////////////////////////////////
// CMdispMFCApp

BEGIN_MESSAGE_MAP(CMdispMFCApp, CWinApp)
   //{{AFX_MSG_MAP(CMdispMFCApp)
   ON_COMMAND(ID_APP_ABOUT, OnAppAbout)
      // NOTE - the ClassWizard will add and remove mapping macros here.
      //    DO NOT EDIT what you see in these blocks of generated code!
   //}}AFX_MSG_MAP
   // Standard file-based document commands
   ON_COMMAND(ID_FILE_NEW, CWinApp::OnFileNew)
   ON_COMMAND(ID_FILE_OPEN, CWinApp::OnFileOpen)
   // Standard print setup command
   ON_COMMAND(ID_FILE_PRINT_SETUP, CWinApp::OnFilePrintSetup)
END_MESSAGE_MAP()

/////////////////////////////////////////////////////////////////////////////
// CMdispMFCApp construction

CMdispMFCApp::CMdispMFCApp()
{
   // TODO: add construction code here
   m_isCurrentlyHookedOnErrors = false;
   // Place all significant initialization in InitInstance
}

/////////////////////////////////////////////////////////////////////////////
// The one and only CMdispMFCApp object

CMdispMFCApp theApp;

/////////////////////////////////////////////////////////////////////////////
// CMdispMFCApp initialization

BOOL CMdispMFCApp::InitInstance()
{

   LoadStdProfileSettings();  // Load standard INI file options (including MRU)


   /////////////////////////////////////////////////////////////////////////
   // Aurora Imaging Library: Write your one-time initialization code here 
   /////////////////////////////////////////////////////////////////////////   

   // Allocate an application and a system [CALL TO Aurora Imaging Library]
   MappAllocDefault(M_DEFAULT,&m_AilApplication, &m_AilSystem, M_NULL, M_NULL, M_NULL);
   
   // Hook error on function DisplayError() [CALL TO Aurora Imaging Library]
   MappHookFunction(M_DEFAULT, M_ERROR_CURRENT,DisplayErrorExt,this);

   m_isCurrentlyHookedOnErrors = true;
   
   // Disable the typical error message display [CALL TO Aurora Imaging Library]
   MappControl(M_DEFAULT, M_ERROR,M_PRINT_DISABLE);
      
   // Inquire the number of digitizers available on the system [CALL TO Aurora Imaging Library]
   MsysInquire(m_AilSystem,M_DIGITIZER_NUM,&m_numberOfDigitizer);
   
   // Digitizer is available
   if (m_numberOfDigitizer)   
   {
      // Allocate a digitizer [CALL TO Aurora Imaging Library]
      MdigAlloc(m_AilSystem,M_DEFAULT,AIL_TEXT("M_DEFAULT"),M_DEFAULT,&m_AilDigitizer);

      // Inquire digitizer information [CALL TO Aurora Imaging Library]
      MdigInquire(m_AilDigitizer,M_SIZE_X,&m_digitizerSizeX);
      MdigInquire(m_AilDigitizer,M_SIZE_Y,&m_digitizerSizeY);     
      MdigInquire(m_AilDigitizer,M_SIZE_BAND,&m_digitizerNbBands);
   }

   // Initialize the state of the grab
   m_isGrabStarted = FALSE;
   
   /////////////////////////////////////////////////////////////////////////
   // Aurora Imaging Library: Write your one-time initialization code here 
   /////////////////////////////////////////////////////////////////////////
    
    
   // Register the application's document templates.  Document templates
   // serve as the connection between documents, frame windows and views.

   CMultiDocTemplate* pDocTemplate;
   pDocTemplate = new CMultiDocTemplate(
      IDR_MDISPTYPE,
      RUNTIME_CLASS(CMdispMFCDoc),
      RUNTIME_CLASS(CChildFrame), // custom MDI child frame
      RUNTIME_CLASS(CMdispMFCView));
   AddDocTemplate(pDocTemplate);

   // Create main MDI Frame window
   CMainFrame* pMainFrame = new CMainFrame;
   if (!pMainFrame->LoadFrame(IDR_MAINFRAME))
      return FALSE;
   m_pMainWnd = pMainFrame;

   // Parse command line for standard shell commands, DDE, file open
   CCommandLineInfo cmdInfo;
   ParseCommandLine(cmdInfo);

   // Dispatch commands specified on the command line
   if (!ProcessShellCommand(cmdInfo))
      return FALSE;
    
    // Show and update the initialized main window.
   pMainFrame->ShowWindow(m_nCmdShow);
   pMainFrame->UpdateWindow();

   return TRUE;
}

/////////////////////////////////////////////////////////////////////////////
// CAboutDlg dialog used for App About

class CAboutDlg : public CDialog
{
public:
   CAboutDlg();

// Dialog Data
   //{{AFX_DATA(CAboutDlg)
   enum { IDD = IDD_ABOUTBOX };
   //}}AFX_DATA

   // ClassWizard generated virtual function overrides
   //{{AFX_VIRTUAL(CAboutDlg)
   protected:
   virtual void DoDataExchange(CDataExchange* pDX);    // DDX/DDV support
   //}}AFX_VIRTUAL

// Implementation
protected:
   HICON m_hIcon;
   //{{AFX_MSG(CAboutDlg)
   virtual BOOL OnInitDialog();
   //}}AFX_MSG
   DECLARE_MESSAGE_MAP()
};

CAboutDlg::CAboutDlg() : CDialog(CAboutDlg::IDD)
{
   //{{AFX_DATA_INIT(CAboutDlg)
   //}}AFX_DATA_INIT
   m_hIcon = AfxGetApp()->LoadIcon(IDI_IMAGING);

}

void CAboutDlg::DoDataExchange(CDataExchange* pDX)
{
   CDialog::DoDataExchange(pDX);
   //{{AFX_DATA_MAP(CAboutDlg)
   //}}AFX_DATA_MAP
}

BEGIN_MESSAGE_MAP(CAboutDlg, CDialog)
   //{{AFX_MSG_MAP(CAboutDlg)
   //}}AFX_MSG_MAP
END_MESSAGE_MAP()

BOOL CAboutDlg::OnInitDialog() 
{
   CDialog::OnInitDialog();
   
   SetIcon(m_hIcon, TRUE);       // Set big icon
   SetIcon(m_hIcon, FALSE);     // Set small icon
   
   return TRUE;  // return TRUE unless you set the focus to a control
                 // EXCEPTION: OCX Property Pages should return FALSE
}

// App command to run the dialog
void CMdispMFCApp::OnAppAbout()
{
   CAboutDlg aboutDlg;
   aboutDlg.DoModal();
}

/////////////////////////////////////////////////////////////////////////////
// CMdispMFCApp commands

int CMdispMFCApp::ExitInstance() 
   {
   /////////////////////////////////////////////////////////////////////////
   // Aurora Imaging Library: Write your code that will be executed on application exit
   /////////////////////////////////////////////////////////////////////////   
   
   //Free the digitizer [CALL TO Aurora Imaging Library]
   if(m_AilDigitizer)    
      MdigFree (m_AilDigitizer);   
   
   //Free the system [CALL TO Aurora Imaging Library]
   if(m_AilSystem)       
      MsysFree (m_AilSystem);   
   
   if(m_AilApplication)  
      {
      // Enable the typical error message display[CALL TO Aurora Imaging Library]
      MappControl(M_DEFAULT, M_ERROR,M_PRINT_ENABLE);
      
      // Unhook error on function DisplayError() [CALL TO Aurora Imaging Library]
      if(m_isCurrentlyHookedOnErrors)
         {
         MappHookFunction(M_DEFAULT, M_ERROR_CURRENT+M_UNHOOK,DisplayErrorExt,this);
         m_isCurrentlyHookedOnErrors = false;
         }
      
      // Free the application [CALL TO Aurora Imaging Library]
      MappFree(m_AilApplication);
      }
   
   /////////////////////////////////////////////////////////////////////////
   // Aurora Imaging Library: Write your code that will be executed on application exit
   /////////////////////////////////////////////////////////////////////////
   
   return CWinApp::ExitInstance();
   }

/////////////////////////////////////////////////////////////////////////
// Aurora Imaging Library: Hook-handler function: DisplayError()
/////////////////////////////////////////////////////////////////////////

AIL_INT MFTYPE DisplayErrorExt(AIL_INT HookType, AIL_ID EventId, void* UserDataPtr)
{
   //If user clicks NO on error message, unhook to errors.
   if(((CMdispMFCApp*) AfxGetApp())->DisplayError(HookType, EventId, 
                              (CWinApp*) UserDataPtr) == M_NO)
      {
      MappHookFunction(M_DEFAULT, M_ERROR_CURRENT+M_UNHOOK,DisplayErrorExt,UserDataPtr);
      ((CMdispMFCApp*) AfxGetApp())->HookedOnErrors(false);
      }

   return M_NULL;
}


long MFTYPE CMdispMFCApp::DisplayError(AIL_INT HookType,
                                       AIL_ID EventId,
                                       void* UserDataPtr)
{
   AIL_STRING ErrorMessageFunction;
   AIL_STRING ErrorMessage;
   AIL_STRING ErrorSubMessage1;
   AIL_STRING ErrorSubMessage2;
   AIL_STRING ErrorSubMessage3;
   AIL_INT NbSubCode;
   CString   CErrorMessage;

   //Retrieve error message [CALL TO Aurora Imaging Library]
   MappGetHookInfo(M_DEFAULT, EventId,M_MESSAGE+M_CURRENT_OPCODE,ErrorMessageFunction);
   MappGetHookInfo(M_DEFAULT, EventId,M_MESSAGE+M_CURRENT,ErrorMessage);
   MappGetHookInfo(M_DEFAULT, EventId,M_CURRENT_SUB_NB,&NbSubCode);   
   
   if (NbSubCode > 2)
      MappGetHookInfo(M_DEFAULT, EventId,M_MESSAGE+M_CURRENT_SUB_3,ErrorSubMessage3);
   if (NbSubCode > 1)   
      MappGetHookInfo(M_DEFAULT, EventId,M_MESSAGE+M_CURRENT_SUB_2,ErrorSubMessage2);
   if (NbSubCode > 0)
      MappGetHookInfo(M_DEFAULT, EventId,M_MESSAGE+M_CURRENT_SUB_1,ErrorSubMessage1);

   CErrorMessage = ErrorMessageFunction.c_str();
   CErrorMessage = CErrorMessage + "\n";
   CErrorMessage = CErrorMessage + ErrorMessage.c_str();
   
   if(NbSubCode > 0)
   {
      CErrorMessage = CErrorMessage + "\n";
      CErrorMessage = CErrorMessage + ErrorSubMessage1.c_str();
   }
   
   if(NbSubCode > 1)
   {
      CErrorMessage = CErrorMessage + "\n";
      CErrorMessage = CErrorMessage + ErrorSubMessage2.c_str();
   }
   
   if(NbSubCode > 2)
   {
      CErrorMessage = CErrorMessage + "\n";
      CErrorMessage = CErrorMessage + ErrorSubMessage3.c_str();
   }
   
   CErrorMessage = CErrorMessage + "\n\n";
   CErrorMessage = CErrorMessage + "Do you want to continue error print?";
   
   return (AfxMessageBox(CErrorMessage,MB_YESNO,0) == IDYES)?M_YES:M_NO;
}

/////////////////////////////////////////////////////////////////////////
// Aurora Imaging Library: Hook-handler function: DisplayError()
/////////////////////////////////////////////////////////////////////////



Copyright © 2026 Zebra Technologies.