Built-in Functions - Common Dialog

Utility functions to manage common dialogs.

Common dialogs can have various combinations of titles, buttons (OK/Yes/No), and button lengths, resulting in eight possible configurations.

---

hsCommonDialogIsOpened

bool hsCommonDialogIsOpened()

Checks if a common dialog is already open. Returns true if a dialog is open. Only one common dialog can be open at a time, so ensure that no other HeliScript code has opened a dialog before attempting to open a new one.

hsCommonDialogSetUseTitle

void hsCommonDialogSetUseTitle(bool Use)

Sets whether to use a title. Must be set before calling hsCommonDialogOpen.

hsCommonDialogSetUseYesNoButton

void hsCommonDialogSetUseYesNoButton(bool Use)

Sets whether to use Yes/No buttons. If not used, only the OK button will be available. Must be set before calling hsCommonDialogOpen.

hsCommonDialogSetUseLongButton

void hsCommonDialogSetUseLongButton(bool Use)

Sets whether to use long buttons. Must be set before calling hsCommonDialogOpen.

hsCommonDialogSetTitle

void hsCommonDialogSetTitle(string Text)

Sets the title text. Must be set before calling hsCommonDialogOpen.

hsCommonDialogSetText

void hsCommonDialogSetText(string Text)

Sets the main body text. To include line breaks, use \n within the string. Must be set before calling hsCommonDialogOpen.

hsCommonDialogSetTextAlignment

void hsCommonDialogSetTextAlignment(int Alignment)

Specifies the text alignment for the main body text. Use the values from the table below. Must be set before calling hsCommonDialogOpen.

Value	Alignment
HSAlignLT	Top Left
HSAlignCT	Top Center
HSAlignRT	Top Right
HSAlignLM	Middle Left
HSAlignCM	Middle Center
HSAlignRM	Middle Right
HSAlignLB	Bottom Left
HSAlignCB	Bottom Center
HSAlignRB	Bottom Right

hsCommonDialogSetTextOverflowWrap

void hsCommonDialogSetTextOverflowWrap(bool OverflowWrap)

Sets whether to automatically wrap text.

hsCommonDialogSetTextURLClickable

void hsCommonDialogSetTextURLClickable(bool URLClickable)

Sets whether URLs in the text are clickable.

hsCommonDialogSetOKButtonText

void hsCommonDialogSetOKButtonText(string Text)

Sets the text for the OK button. Must be set before calling hsCommonDialogOpen.

hsCommonDialogSetYesButtonText

void hsCommonDialogSetYesButtonText(string Text)

Sets the text for the Yes button. Must be set before calling hsCommonDialogOpen.

hsCommonDialogSetNoButtonText

void hsCommonDialogSetNoButtonText(string Text)

Sets the text for the No button. Must be set before calling hsCommonDialogOpen.

hsCommonDialogSetOKButtonDelegate

void hsCommonDialogSetOKButtonDelegate(hsDGCommonDialog dg)

Sets the delegate function for the OK button click event. The delegate type is void func(void). Must be set before calling hsCommonDialogOpen.

Example:

hsCommonDialogSetOKButtonDelegate(OnDialogOK);

public void OnDialogOK(void)
{
    hsSystemOutput("OnDialogOK callback\n");

    hsCommonDialogClose();
}

hsCommonDialogSetYesButtonDelegate

void hsCommonDialogSetYesButtonDelegate(hsDGCommonDialog dg)

Sets the delegate function for the Yes button click event. The delegate type is void func(void). Must be set before calling hsCommonDialogOpen.

hsCommonDialogSetNoButtonDelegate

void hsCommonDialogSetNoButtonDelegate(hsDGCommonDialog dg)

Sets the delegate function for the No button click event. The delegate type is void func(void). Must be set before calling hsCommonDialogOpen.

hsCommonDialogOpen

bool hsCommonDialogOpen()

Opens the common dialog. Returns false if an error occurs, such as if a dialog is already open.

hsCommonDialogClose

bool hsCommonDialogClose()

Closes the common dialog. Returns false if an error occurs, such as if the dialog is already closed.

---