Page History

...

Method

Description

Example

CoreInterface* m_pCore

A pointer to the core interface

virtual BOOL IsWantAllEvents()

Returns TRUE if the OnEvent function receives events from all objects; returns FALSE if the function receives events from its own object only.

If "CAM,GRABBER" is passed as a parameter, when settings of these objects are modified, the Axxon One PSIM Demo object receives the following messages:

Axxon One PSIM Demo|1|UPDATE_CAM|parameters of the camera

Axxon One PSIM Demo|1|UPDATE_GRABBER|parameters of the video capture card

virtual CString DescribeSubscribeObjectsList()

The method accepts a comma-separated list of objects. When an object from the list is modified, the current object is notified.

virtual CString GetObjectType()

Returns the object type

Code Block
virtual CString GetObjectType() { return "Axxon OnePSIM Demo"; }

virtual CString GetParentType()

Returns the parent object type

Code Block
virtual CString GetParentType() { return "SLAVE"; }

virtual int GetPos()

Returns the position of the object in the Axxon PSIMpsim.sec key file.

Attention! This parameter must be set in consultation with AxxonSoft.

Code Block
virtual int GetPos() { return -1; }

Note: If Axxon PSIM is run in the Axxon One PSIM Demo mode, the function returns -1

virtual CString GetPort()

Returns the number of the port used for communication between the object and the core.

Attention! This parameter must be set in consultation with AxxonSoft.

Code Block
virtual CString GetPort() { return "1100"; }

virtual CString GetProcessName()

Returns the process name. Used by the core to search for and automatically run the executable module on startup of the system and initialization of the module

Code Block
virtual CString GetProcessName() { return "Axxon OnePSIM Demo"; }

virtual CString GetDeviceType()

Determines the type of the object and its behavior.

ACD – objects of this type receive all events related to the creation, modification, and deletion of the following objects: Users, Time Zone, and Access Levels

ACD2 – a type similar to ACD, providing the additional (provided by the core) functionality of deleting temporary (fixed-term) cards

The ACR type means that the object is a reader

All objects of the ACR type are available in the Access Point drop-down list

virtual BOOL HasChild()

Returns TRUE if the object has child objects, FALSE otherwise.

Code Block
virtual BOOL HasChild() { return TRUE; }

virtual UINT HasSetupPanel()

Returns TRUE if the object has a setup panel, FALSE otherwise

Code Block
virtual UINT HasSetupPanel() { return TRUE; }

virtual void OnPanelInit(CWnd*)

Used when the object's setup panel is initialized. The parameter is a pointer to the setup panel's window.

virtual void OnPanelLoad(CWnd*,Msg&)

Used when the setup panel is loaded for setting the parameters of the object. The parameters are the setup panel's window and a message used to pass the parameters and fill in the relevant fields of the setup panel.

Code Block
virtual void OnPanelLoad(CWnd* pwnd,Msg& params) { CString s; s = arams.GetParam("port"); pwnd->GetDlgItem(IDC_PORT)-> SetWindowText(s); }

virtual void OnPanelSave(CWnd*,Msg&)

Used when the setup panel is saved for saving the parameters of the object. The parameters are a pointer to the setup panel's window and a reference to a message used to pass the parameters and save them in a database.

Code Block
virtual void OnPanelSave(CWnd* pwnd,Msg& params) { CString s; pwnd-> GetDlgItem(IDC_PORT)-> GetWindowText(s); params.SetParam("port",s); }

virtual void OnPanelExit(CWnd*)

Used when the object's setup panel is closed ("exited"). The parameter is a pointer to the setup panel's window.

virtual void OnPanelButtonPressed(CWnd*,UINT)

Used to handle clicks on the setup panel's buttons. The parameters are a pointer to the setup panel's window and a button ID.

Note: A button ID must be a number equal to or greater than 1151. For example, the Resource.h file defines the ID of the Test button as follows:

#define IDC_TEST 1151

Code Block
Virtual void OnPanelButtonPressed (CWnd* pwnd,UINT id) { if(id==IDC_TEST) { React react("Axxon OnePSIM Demo",Id,"TEST"); m_pCore->DoReact(react); } }

If a button click is to open your own dialog box created in the same MDL file, you must first use the code shown in the example below.

Code Block

HINSTANCE prev_hinst = AfxGetResourceHandle();

HMODULE hRes = GetModuleHandle("Axxon OnePSIM Demo.mdl");

If (hRes) AfxSetResourceHandle (hRes);

 

//Code for showing a dialog box: 

CXXXDialog dlg;

dlg.DoModal();

 

 

AfxSetResourceHandle(prev_hinst);

virtual BOOL IsRegionObject()

Shows whether the object supports Axxon PSIM's regions. Regions are used to group objects. They can also be used in the report system.

virtual BOOL IsProcessObject()

Shows whether the object supports starting and running multiple executable modules simultaneously. For example, this may be used for starting a separate module for each COM port.

Note: We recommend using one RUN file. This makes it easier to debug and modify the module.

virtual void OnCreate(Msg&)

Used when the object is created. The parameter is a reference to a message that contains object information. The method is also used to set default parameters.

Code Block
virtual void OnCreate (Msg& msg) { msg.SetParam ("port","COM1"); }

virtual void OnInit(Msg&)

Used when the object is initialized. The parameter is a reference to a message that contains object information.

Code Block
virtual void OnInit (Msg& msg) { OnChange (msg, msg); }

virtual void OnChange(Msg&,Msg&)

Used when the object is changed. The first and second parameters are references to messages that contain object information before and after the change, respectively.

Code Block
virtual void OnChange(Msg& msg, Msg& prev) { React react (msg.GetSourceType(), msg.GetSourceId(),"INIT"); react.SetParam("port",msg.GetParam("port")); m_pCore->DoReact(react); }

virtual void OnDelete(Msg&)

Used when the object is deleted. The parameter is a reference to a message that contains object information.

Code Block
virtual void OnDelete (Msg& msg) { React react (msg.GetSourceType(), msg.GetSourceId(),"EXIT"); m_pCore-> DoReact(react); }

virtual void OnEnable(Msg&)

Used to handle clicks on the Disable button of Axxon PSIM's panel when the object is enabled. The parameter is a reference to a message that contains object information.

virtual void OnDisable(Msg&)

Used to handle clicks on the Disable button of Axxon PSIM's panel when the object is disabled. The parameter is a reference to a message that contains object information.

virtual BOOL OnEvent(Event&)

Used to handle the events that are passed as the parameter.

Code Block

virtual BOOL 

OnEvent(Event& event)

{ 

If

 (event.GetAction() == "ACCESS_IN" ||

event.GetAction() == "ACCESS_OUT")

 

{

 Msg per = m_pCore-> FindPersonInfoByCard(event.GetParam("facility_code"),

event.GetParam("card"));

event.SetParam

("param0", !per.GetSourceId().IsEmpty() ?

per.GetParam("name") : event.GetParam("facility_code") + event.GetParam("card"));

event.SetParam("param1", per.GetSourceId() );

}

 

Else

 

If (event.GetAction() == "NOACCESS_CARD")

{

event.SetParam

("param0",event.GetParam("facility_code") + event.GetParam("card"));

}

 return TRUE;

}

virtual BOOL OnReact(React&)

Used to handle the reactions that are passed as the parameter.

...

Code Block

CNissObjectDLLExtArray* APIENTRY CreateNissObject(CoreInterface* core)
{
	CNissObjectDLLExtArray* ar = new CNissObjectDLLExtArray;
	ar->Add(new NissObjectAxxon OnePSIM Demo(core));
	ar->Add(new NissObjectDemoDevice(core));
	return ar;
}

...

All object setup panels are stored in resources as dialogs. Each dialog ID has the format IDD_object_SETUP, where object is the name of the corresponding object. For example, the ID of the Axxon One PSIM Demo object is IDD_DEMO_SETUP, and the ID of the DEMO_DEVICE object is IDD_DEMO_DEVICE _SETUP.

...

Page tree

Versions Compared

Old Version 2

New Version 3

Key