System/Benutzerschnittstelle (UI)

Dialogfeld „Verzeichnis durchsuchen“

Öffnet ein Dialogfeld zum Durchsuchen eines Verzeichnisses. Im --noUI-Modus können Sie hier einfach einen Pfad eingeben.

# Import the .NET class System.Environment from mscorlib.dll first
# Otherwise the Environment.SpecialFolder Enumeration is not available
from System import Environment
import os
 
# Set the necessary fields
dialog_message = "Select Python Example Directory"
preselected_path =  r"c:\Python"
 
# Store the selected path
selected_path = system.ui.browse_directory_dialog(dialog_message, preselected_path, Environment.SpecialFolder.Desktop, True)
 
# Remember to check if the user canceled the dialog
if(selected_path != None):
    # List files in the specified directory
    print(os.listdir(selected_path))

Sie besteht aus vier Parametern:

oEine Zeichenfolge, die die Meldung enthält

oEine Zeichenfolge, die den Pfad enthält, der vorausgewählt ist, wenn sich das Dialogfeld öffnet

oDer Environment.SpecialFolder enthält das Stammverzeichnis für das Dialogfeld „Durchsuchen“.

oEin boolescher Parameter: Wenn True, wird eine Schaltfläche im Dialogfeld angezeigt, über die Sie neue Verzeichnisse erstellen können.

Die Methode gibt den ausgewählten Pfad zurück. Wenn Sie das Dialogfeld abbrechen, wird nichts zurückgegeben.

Auswählen

Diese Methode erlaubt Ihnen, eines der aufgelisteten Elemente auszuwählen.

# Set the necessary fields
option_list = ["TM221C16R", "TM241C24R", "TM258LF66DT4L"]
 
dialog_message = "Select the controller which should be added to the project:"
 
# A python tuple will be returned with the index of the selected item or -1 if canceled
selected_item = system.ui.choose(dialog_message, option_list, True)
 
# Remember to check if the user canceled the dialog
if(selected_item[0] != -1):
    print(option_list[selected_item[0]] + " will be added to the project.")

Sie besteht aus drei Parametern:

oEine Zeichenfolge, die die Meldung enthält

oEine Liste mit Optionen wird angezeigt: Die Objekte werden in eine Zeichenfolge konvertiert, um sie anzuzeigen.

oEin boolescher Parameter: Wenn True, wird eine Schaltfläche im Dialogfeld angezeigt, über die Sie neue Verzeichnisse erstellen können.

Diese Methode gibt ein Python-Tupel zurück, das zwei Elemente enthält:

oDen Index des ausgewählten Elements oder

-1 wenn aufhebbar auf True gesetzt wurde und Sie das Dialogfeld abgebrochen haben

odas ausgewählte Element oder None

Fehlererkennung

Diese Methode zeigt eine Meldung bei einer Fehlererkennung an. Sie blockiert alle weiteren Aktionen, bis die Meldung bestätigt wurde.

system.ui.error("Error")

Info

Diese Methode zeigt eine Informationsmeldung an. Sie blockiert alle weiteren Aktionen, bis die Meldung bestätigt wurde.

# Set the necessary fields
dialog_message = "Project update has been completed successfully"
 
# This method is used to display a simple message to the user
system.ui.info(dialog_message)

Dialogfeld Datei öffnen

Diese Methode zeigt das Dialogfeld Datei öffnen an. Im --noUI-Modus können Sie hier einfach einen Pfad eingeben.

# Set the necessary fields
dialog_title = "Select a Project"
dialog_filename = None
initial_directory = None
file_filter = "(*.project)|*.project"
 
# Open a select file dialog which only accepts *.project files
selected_file = system.ui.open_file_dialog(dialog_title, dialog_filename, initial_directory, file_filter)
 
# Remember to check if the user canceled the dialog
if(selected_file != None):
    # Open the specified project
    if projects.primary:
        projects.primary.close()
    projects.open(selected_file)

Abfrage-Zeichenkette

Diese Methode fragt den Eingang oder die Bearbeitung einer Text-Zeichenfolge ab.

# Set the necessary fields
dialog_message = "Please enter a filename for your project:"
dialog_prefilled_text = "c:\Python\QueryStringExample.project"
 
# This functions queries a string from the user
project_name = system.ui.query_string(dialog_message, dialog_prefilled_text)
 
# If a project is opened, the project will be saved under the new nameif(projects.primary):
    projects.primary.save_as(project_name)

Sie gibt eine Zeichenfolge mit dem eingegebenen Text zurück.

Dialogfeld „Datei speichern“

Diese Methode zeigt das Dialogfeld Datei speichern an. Im --noUI-Modus können Sie hier einfach einen Pfad eingeben.

import os
 
# Set the necessary fields
dialog_title = "Select a Filename"
initial_directory, dialog_filename = os.path.split(projects.primary.path)
file_filter = "(*.project)|*.project"
 
# Open a select file dialog which only accepts *.project files
selected_file = system.ui.save_file_dialog(dialog_title, dialog_filename, initial_directory, file_filter)
 
# Remember to check if the user canceled the dialog
if(selected_file != None):
    # File was saved under the specified name, lets close the project
    projects.primary.close()

Warnung

Diese Methode zeigt eine Warnmeldung an. Sie blockiert alle weiteren Aktionen, bis die Meldung bestätigt wurde.

# Set the necessary fields
dialog_message = "Project update failed. Please check the log for detailed errors."
 
# This method is used to display a simple warning to the user
system.ui.warning(dialog_message)