Windows

Home | Classes | Methods | Properties | Members

** Location:**Utilities & System Windows

Namespace: AlibreScript.API | Kind: Class

The Windows class provides functionality for managing Windows forms, dialogs, and user interface operations within the Alibre Design environment.

Quick Navigation

Methods

CloseForm

Close all currently open forms for a specific session

def CloseForm(session_identifier):
"""
Close all currently open forms for a specific session
 
Args:
session_identifier (str): Identifier for session
 
"""

DisableInput

Disables an input

def DisableInput(index):
"""
Disables an input
 
Args:
index (int): Index of the input
 
"""

EnableInput

Enables an input

def EnableInput(index):
"""
Enables an input
 
Args:
index (int): Index of the input
 
"""

ErrorDialog

Shows an error window

def ErrorDialog(message, title):
"""
Shows an error window
 
Args:
message (str): Error message
title (str): Title of window
 
"""

GetDisplayedForm

Gets the currently displayed form for a specific session

def GetDisplayedForm(session_identifier):
"""
Gets the currently displayed form for a specific session
 
Args:
session_identifier (str): Identifier of session
 
Returns:
Displayed form or null for none
 
"""

GetInputValue

Gets the current value of an input

def GetInputValue(index):
"""
Gets the current value of an input
 
Args:
index (int): Index of the input
 
Returns:
Current value
 
"""

InfoDialog

Shows an information window

def InfoDialog(message, title):
"""
Shows an information window
 
Args:
message (str): Message to show
title (str): Title of window
 
"""

OpenFileDialog

Prompts user to select a file

def OpenFileDialog(title, filter, default_extension):
"""
Prompts user to select a file
 
Args:
title (str): Title of dialog window
filter (str): File filter, example filter: 'Part Files|*.AD_PRT'
default_extension (str): Default file extension, e.g. '.AD_PRT'
 
Returns:
Path and name of selected file or empty string if canceled
 
"""

OptionsDialog

Shows a dialog prompting the user to enter values

Overload 1:

def OptionsDialog(title, inputs, input_area_width):
"""
Shows a dialog prompting the user to enter values
 
Args:
title (str): Title of dialog window
inputs (list): List of input definitions [[Name, Type, DefaultValue], [...]]
input_area_width (int): Width of input area, optional
 
Returns:
List of entered values
 
"""

Overload 2:

def OptionsDialog(title, inputs, input_area_width, input_changed_callback, update_user_interface_callback):
"""
Shows a dialog prompting the user to enter values
 
Args:
title (str): Title of dialog window
inputs (list): List of input definitions\n [[Name, Type, DefaultValue, OptionalSettings], [...]]\n Example: ['Image', WindowsInputTypes.Image, 'Logo.png']
input_area_width (int): Width of input area
input_changed_callback (object): Function called when an input is changed
update_user_interface_callback (object): Function called after dialog is created to update the state of the dialog
 
Returns:
List of entered values
 
"""

QuestionDialog

Shows a question window

def QuestionDialog(question, title):
"""
Shows a question window
 
Args:
question (str): Question to show
title (str): Title of window
 
Returns:
true if 'yes' was clicked, false if 'no' was clicked
 
"""

SaveFileDialog

Prompts user to save a file

def SaveFileDialog(title, filter, default_extension):
"""
Prompts user to save a file
 
Args:
title (str): Title of dialog window
filter (str): File filter, example filter: 'Part Files|*.AD_PRT'
default_extension (str): Default file extension, e.g. '.AD_PRT'
 
Returns:
Path and name of selected file or empty string if canceled
 
"""

SelectFolderDialog

Prompts the user to select a folder

def SelectFolderDialog(current_folder, description):
"""
Prompts the user to select a folder
 
Args:
current_folder (str): The current folder, if any
description (str): Description of what is being chosen, shown to user
 
Returns:
Path of selected folder or empty if canceled
 
"""

SetInputValue

Sets the current value for an input

def SetInputValue(index, value):
"""
Sets the current value for an input
 
Args:
index (int): Index of the input
value (object): Value to show
 
"""

SetStringList

Updates the list of strings for a stringlist input

def SetStringList(index, strings):
"""
Updates the list of strings for a stringlist input
 
Args:
index (int): Index of the stringlist input
strings (object): New list of strings to show
 
"""

UtilityDialog

Shows a dialog prompting the user to enter values The dialog remains open until the user clicks on the close button A callback function is called to give the input values to the script

Overload 1:

def UtilityDialog(title, action_button_text, action_button_callback, input_changed_callback, inputs, input_area_width):
"""
Shows a dialog prompting the user to enter values The dialog remains open until the user clicks on the close button A callback function is called to give the input values to the script
 
Args:
title (str): Title of dialog window
action_button_text (str): Text for action button
action_button_callback (object): Function called when the action button is clicked
input_changed_callback (object): Function called when an input is changed
inputs (list): List of input definitions [[Name, Type, DefaultValue, OptionalSettings], [...]]
input_area_width (int): Width of dialog input area, optional
 
"""

Overload 2:

def UtilityDialog(title, action_button_text, action_button_callback, input_changed_callback, inputs, input_area_width, update_user_interface_callback):
"""
Shows a dialog prompting the user to enter values The dialog remains open until the user clicks on the close button A callback function is called to give the input values to the script
 
Args:
title (str): Title of dialog window
action_button_text (str): Text for action button
action_button_callback (object): Function called when the action button is clicked
input_changed_callback (object): Function called when an input is changed
inputs (list): List of input definitions\n [[Name, Type, DefaultValue, OptionalSettings], [...]]\n Example: ['Image', WindowsInputTypes.Image, 'Logo.png']
input_area_width (int): Width of dialog input area
update_user_interface_callback (object): Function called after dialog is created to update the state of the dialog
 
"""

⬆ Back to Top