topic Re: Capture the change (addition/deletion/rename) of Story Settings in Archicad C++ API

Capture the change (addition/deletion/rename) of Story Settings

dushyant — Sat, 09 Oct 2021 06:32:37 GMT

Is there any notification of the change in Story settings that can be captured by an add-on?

I tried:

ACAPI_Notify_CatchProjectEvent (API_AllProjectNotificationMask, NotificationHandler);

and tried capturing the notification ID "APINotify_ChangeFloor" but that doesn't trigger upon adding or removing a story in the project from 'Story settings'.

How can I capture the addition/deletion/rename of stories in the project?

Thanks.

Re: Capture the change (addition/deletion/rename) of Story Settings

BerndSchwarzenbacher — Mon, 11 Oct 2021 09:45:06 GMT

I haven't tried it myself, but I saw something in the Documentation of APIProjectEventHandlerProc. It seems like you can catch "APINotify_ChangeProjectDB" and if the "param" parameter of your handler callback has value 1 it means that the floors changed.

Re: Capture the change (addition/deletion/rename) of Story Settings

dushyant — Mon, 11 Oct 2021 12:40:01 GMT

I tried that, but adding/deleting floors does not pass notifID as "APINotify_ChangeProjectDB".

Re: Capture the change (addition/deletion/rename) of Story Settings

BerndSchwarzenbacher — Tue, 12 Oct 2021 09:35:27 GMT

Hm.. that's weird. I tried it now also and it seems to work for me.

Here are the relevant code sections I used:

static GSErrCode __ACENV_CALL ProjectEventHandlerProc (API_NotifyEventID notifID, Int32 param) { switch (notifID) { case APINotify_ChangeProjectDB: { DG::InformationAlert ("Change project DB", "param: " + GS::ValueToUniString (param), "OK"); break; } default: break; } return NoError; } GSErrCode __ACENV_CALL Initialize (void) { GSErrCode err = NoError; err = ACAPI_Notify_CatchProjectEvent (APINotify_ChangeProjectDB, ProjectEventHandlerProc); return err; }

All three actions: Remove/Add/Rename Floor trigger the "APINotify_ChangeProjectDB" with "param = 1" for me.

Re: Capture the change (addition/deletion/rename) of Story Settings

dushyant — Tue, 12 Oct 2021 11:01:32 GMT

~~Where is ProjectEventHandlerProc being called from?~~

EDIT: Sorry, I didn't scroll your code 🙂

So this is what's happening:

I was passing API_AllProjectNotificationMask to the callback, assuming that it would capture _all_ the events, as I needed to capture another event, like so:

ACAPI_Notify_CatchProjectEvent (API_AllProjectNotificationMask, NotificationHandler);

But it seems it does not.

I tried passing APINotify_ChangeProjectDB directly and it worked!

That's strange because the example on https://archicadapi.graphisoft.com/documentation/apiprojecteventhandlerproc shows the case for APINotify_ChangeProjectDB ... Don't know what I'm missing here.

Anyway, now I have created separate calls for each event.

Thanks Bernd!

Re: Capture the change (addition/deletion/rename) of Story Settings

BerndSchwarzenbacher — Tue, 12 Oct 2021 11:25:03 GMT

Glad it works now for you too 🙂

Yes "API_AllProjectNotificationMask" doesn't include "APINotify_ChangeProjectDB". You can check the values of the mask in the AC API header "APIdefs_Callback.h". Here's the relevant part:

#define API_AllProjectNotificationMask 0x00000FFF // APINotify_New..APINotify_ConvertGuid #define API_AllTeamWorkNotificationMask 0x00018000 // APINotify_Share..APINotify_ChangeWorkspace #define API_AllChangeNotificationMask 0x033C0000 // APINotify_ChangeProjectDB..APINotify_ChangeFloor #define API_AllNotificationMask 0xFFFFFFFF

The example you linked probably uses "API_AllNotificationMask". You can also select multiple notifications by combining them with "OR" like this:

APINotify_ChangeProjectDB | APINotify_SomeOtherMask | ....

Re: Capture the change (addition/deletion/rename) of Story Settings

dushyant — Tue, 12 Oct 2021 11:49:14 GMT

I gave a different ref. link last time, which doesn't have the function call. Check out the example here: https://archicadapi.graphisoft.com/documentation/acapi_notify_catchprojectevent?s=ACAPI_Notify_CatchProjectEvent

It passes API_AllProjectNotificationMask , and shows the case for APINotify_ChangeProjectDB.

@BerndSchwarzenbacher wrote:
You can also select multiple notifications by combining them with "OR"

That's interesting. Thanks! 👍

Re: Capture the change (addition/deletion/rename) of Story Settings

BerndSchwarzenbacher — Tue, 12 Oct 2021 14:03:11 GMT

You are right. That example is very misleading!