topic Re: Fixed named optional parameters in Libraries & objects

Fixed named optional parameters

rocorona — Sun, 14 Dec 2008 10:19:02 GMT

We know that the GLOBAL variables are still improved, but for many uses the "new way" is the use of optional parameters wit fixed names.
THIS PAGE gives us a full list of the recognized variable names.
Or not? The GDL manual (AC12 page 188) says "If these buttons are pushed, the gs_ui_current_page parameter of the library part is set to the index of the page to show - if there's a parameter with this name."
But this is not in the list. The list only contains parameters starting with "ac_". Is there another page for "gs_" parameters?

Re: Fixed named optional parameters

Karl Ottenstein — Sun, 14 Dec 2008 19:01:51 GMT

rocorona wrote:
... the gs_ui_current_page parameter ...

But this is not in the list. The list only contains parameters starting with "ac_". Is there another page for "gs_" parameters?

Good catch, Roberto. The Library Developer kit documents 100's of gs_ parameters for particular object subtypes... but within the page for each subtype (e.g., windows). I do not see a 'master' listing anywhere.

Also, searching for gs_ui_current_page only turns up the quote that you gave, and library parts that contain the parameter. No documentation.

The AC 10 online standards (and downloadable 12) include references to this parameter:
http://www.graphisoft.com/ftp/techsupport/documentation/developer_docs/BasicLibraryDoc/10/LibDevGuide/TechnicalStandards.html

If you want to use the Previous and Next buttons, too, you should add a integer parameter to your object, gs_ui_current_page. The execution environment (i.e. ArchiCAD) will set this parameter's value when the classic Previous or Next button is pushed.

Example showing the whole mechanism:

Oddly, the online file link calls these the "GDL Technical Standards 2.0" (for version 10). The downloadable document in the 12 lib kit simply calls them the "GDL Technical Standards".

Karl

Re: Fixed named optional parameters

rocorona — Mon, 15 Dec 2008 08:55:58 GMT

If I'm correct, that ones (or 100's...) are those you get when assigning a subtype to an object.
Then, as you get them automatically, you don't really need to know about them. But gs_ui_current_page is one of general use, you have to create in any type of object, if it uses pages in it's UI.