GXDGW class

class geosoft.gx.GXDGW

Provides access to dialog boxes for user I/O. You can
use this class to store to, or retrieve information from
the current workspace parameter block via dialog boxes

Note:

Setting Fonts in GX dialogs.

By default, "new look" GX dialogs uses the "Tahoma" font. This font can be
overridden by updating the application settings. This can be done programmatically
using the geosoft.gx.GXSYS.global_set() function using the following parameters:

MONTAJ.GX_FONT="Font_name"

This sets the default font to "Font_name". It applies to text in all
components of the dialog.

Additional customization of individual components can be accomplished
using the following parameters:

MONTAJ.GX_CAPTION_FONT="Caption_Font": Font for the field captions (labels)
MONTAJ.GX_BUTTON_FONT="Button_Font"  : Font for buttons, including the "Browse"
                                button
MONTAJ.GX_TITLE_FONT="Title_Font"    : Font for special titles (see geosoft.gx.GXDGW.set_title()).

The font used for the text in edit windows remains the default, or the
value specified using MONTAJ.GX_FONT.

Note that the "OK" button, and the Title, use "Bold" versions of the
specified font. If the bolded version does not exist as a normal font,
then the operating system may provide its own alternative which may not
appear the same as you expect.

Before version 6.2. there used to be a parameter, MONTAJ.GX_CHARSET, that
affected characters above ASCII 127. 6.2. introduced Unicode in the core
montaj engine that eliminated the need for such a setting. All strings
on the GX API level are encoded in UTF8 during runtime which makes it possible
to represent all possible characters without using character sets.

is_null() → bool

Check if the instance of geosoft.gx.GXDGW is null (undefined)

Returns:True if this is a null instance of geosoft.gx.GXDGW, False otherwise. Return type:bool`

static null() → GXDGW

A null (undefined) instance of geosoft.gx.GXDGW

Returns:A null geosoft.gx.GXDGW Return type:geosoft.gx.GXDGW

DGW_OBJECT constants

Dialog object defines
\ `*`\  Labels cannot be made larger. They can only
be the size of the original label.
INFO TYPE   EDIT   FEDIT  LEDIT  CEDIT  EBUT
=========   =====  =====  =====  =====  =====
LABEL\ `*`\       RW     RW     RW     RW     RW          R - can use GetInfo_DGW
TEXT        RW     RW     RW     RW     .           W - can use \ :func:`geosoft.gx.GXDGW.set_info`\
PATH        .      RW     .      .      .
FILEPATH    .      RW     .      .      .
LISTVAL     .      .      R      .      .
LISTALIAS   .      .      RW     .      .

gx.DGW_LABEL = 0

The text label tied to each dialogue component.

gx.DGW_TEXT = 1

The edit field text.

gx.DGW_PATH = 2

The file edit path.

gx.DGW_FILEPATH = 3

The complete file name, path included.

gx.DGW_LISTVAL = 4

The alias value associated with the list entry.

gx.DGW_LISTALIAS = 5

The text value associated with the list entry.

gx.DGW_EXT = 7

The extension associated with a filename entry.

gx.DGW_HIDE = 8

Hide the button or entry and its label, if string is not "0"