topic Re: GRC scripting language in Archicad C++ API

GRC scripting language

Emkave — Thu, 25 Jul 2024 06:51:04 GMT

Good day everyone. I need a help with understanding the GRC nature in order to properly define modal dialogs and other appereances.
I wonder if there is a documentation like cppreference but for GRC so I could understand this scripting language better?

I am trying to define the modal dialog, however, I get stucked with some errors sometimes when trying to add styles or else.

For example:
Here I made a wrote a simple grc for this modal dialogue...

How can I get rid of that question mark thing?

ChatGPT gave me this solution:

'GDLG' 32525 Modal 10 10 300 200 "Modal" {
Style NoResizing, NoHelpButton // Add this line
/* [ 1] */ Button 130 160 30 30 LargePlain "OK"
}

However, this solution seems not being properly built when I press "Build" button to build the final project in Visual Studio.
Now I am completely lost how the syntax is organized in GRC. I need help please.

Thank you in advance!

Operating system used: Windows 10

Re: GRC scripting language

Hiromichi Shinkawa — Tue, 30 Jul 2024 02:04:45 GMT

Hi, I'd suggest you to check the help file (DialogManager.chm) which you can find in API kit. Also, there is a sample code (DG_Test) in API Examples code which shows you how to create UI in your addon.

HTH.

Re: GRC scripting language

Claudiu Serban — Mon, 03 Nov 2025 21:21:30 GMT

Sorry to revive this, but i'm going through the same problem (trying to understand GRC language) and can't find the help files you are mentioning. Downloaded all API Kits, there are no chm files inside, just the Support and the Examples folder.

Re: GRC scripting language

BerndSchwarzenbacher — Tue, 04 Nov 2025 07:51:53 GMT

Hi Claudiu,

I think these help files are no longer included in AC29 DevKits. You have to download AC28 or older DevKits and make sure to tick the corresponding box in the installer to install help files as well. I usually only install the HTML version. .chm files are just a different format for windows help files I think but the content is the same.

Hope that helps,
Bernd

Re: GRC scripting language

Claudiu Serban — Tue, 04 Nov 2025 10:00:15 GMT

Thats the first thing I did. I even went back to the last available version on the API website (v24), they weren't there. Maybe they never were there in mac packages? Will try to install on a windows computer then.

Re: GRC scripting language

BerndSchwarzenbacher — Wed, 05 Nov 2025 17:10:55 GMT

Yeah that could be. I think some time ago I've noticed as well that it didn't come with the mac package and also just used the windows documentation anyway.

Re: GRC scripting language

Ralph Wessel — Wed, 05 Nov 2025 21:23:25 GMT

You can download the latest documentation here

Re: GRC scripting language

BerndSchwarzenbacher — Thu, 06 Nov 2025 13:47:08 GMT

This is the same as on https://graphisoft.github.io/archicad-api-devkit/ right? I think it doesn't include much description about the format of .grc files. At least I cannot find the same information there as I can find in the AC26 Documentation.

Re: GRC scripting language

Claudiu Serban — Thu, 06 Nov 2025 16:16:59 GMT

Yes, Ralph's link is just the web version we can find online. And yes, the chms are there only in the windows SDK version, installed it just now on a windows machine. Don't know why those bits didn't make it to the online docs, some good info here, even if it's 10+ years old. (the dialog items types i was interested in is from 2011 :D)