QtTaskTree Namespace

Typ Dokumentation

[alias] BarrierKickerGetter

Typ-Alias für die Funktion, die eine QStoredBarrier annimmt und ExecutableItem zurückgibt, d.h. std::function<ExecutableItem(const QStoredBarrier &)>, zur Verwendung im When Konstruktor.

enum class QtTaskTree::CallDoneFlag
flags QtTaskTree::CallDone

Diese Aufzählung ist ein optionales Argument für das onGroupDone() Element oder den Konstruktor einer benutzerdefinierten Aufgabe. Es weist den TaskTree an, wann der done-Handler der Gruppe oder Aufgabe aufgerufen werden soll.

Der Typ CallDone ist ein Typedef für QFlags<CallDoneFlag>. Er speichert eine ODER-Kombination von CallDoneFlag-Werten.

enum class QtTaskTree::DoneResult

Diese Aufzählung wird optional von der done-Handler-Funktion der Gruppe oder Aufgabe zurückgegeben. Wenn der done-Handler keinen Wert zurückgibt, d.h. sein Rückgabetyp void ist, wird sein endgültiger Rückgabewert automatisch vom laufenden Task-Baum abgeleitet und an die übergeordnete Gruppe gemeldet.

Wenn der done-Handler das DoneResult zurückgibt, können Sie den endgültigen Rückgabewert innerhalb des Handlers ändern.

Wenn das DoneResult vom Done-Handler der Gruppe zurückgegeben wird, wird die Workflow-Richtlinie der Gruppe ignoriert.

Dieses Enum wird auch innerhalb des Signals TaskInterface::done() verwendet und zeigt an, ob die Aufgabe erfolgreich oder mit einem Fehler beendet wurde.

enum class QtTaskTree::DoneWith

Diese Aufzählung ist ein optionales Argument für den done-Handler der Gruppe oder Aufgabe. Es zeigt an, ob die Gruppe oder Aufgabe mit Erfolg oder einem Fehler beendet oder abgebrochen wurde.

Es wird auch als Argument innerhalb des QTaskTree::done()-Signals verwendet und gibt das Endergebnis der Ausführung von QTaskTree an.

[alias] QtTaskTree::GroupItems

Geben Sie den Alias für QList<GroupItem> ein.

[alias] QBarrierTask

Typ-Alias für die QCustomTask<QBarrier>, der in Rezepten verwendet werden kann.

[alias] QNetworkReplyWrapperTask

Typ-Alias für die QCustomTask<QNetworkReplyWrapper>, der in Rezepten verwendet werden kann.

[alias] QProcessTask

Geben Sie einen Alias für QCustomTask<QProcess> unter Verwendung von QProcessTaskDeleter ein, der in Rezepten verwendet werden kann.

[alias] QStoredBarrier

Typ-Alias für die QtTaskTree::Storage<QStartedBarrier>, der in Rezepten verwendet werden kann.

[alias] QTaskTreeTask

Typ-Alias für die QCustomTask<QTaskTree>, der in Rezepten verwendet werden kann.

[alias] QTcpSocketWrapperTask

Typ-Alias für die QCustomTask<QTcpSocketWrapper>, der in Rezepten verwendet werden kann.

[alias] template <typename ResultType> QThreadFunctionTask

Typ-Alias für die QCustomTask<QThreadFunction<ResultType>>, die innerhalb von Rezepten verwendet werden kann.

[alias] QTimeoutTask

Geben Sie einen Alias für QCustomTask<std::chrono::milliseconds> ein, der in Rezepten verwendet werden soll. Die std::chrono::milliseconds wird verwendet, um die Timeout-Dauer festzulegen. Der Standard-Timeout ist std::chrono::milliseconds::zero(), d.h. der QTimeoutTask wird beendet, sobald die Steuerung zur laufenden Ereignisschleife zurückkehrt.

Beispiel für die Verwendung:

using namespace std::chrono;
using namespace std::chrono_literals;

const auto onSetup = [](milliseconds &timeout) { timeout = 1000ms; }
const auto onDone = [] { qDebug() << "Timed out."; }

const Group root {
    QTimeoutTask(onSetup, onDone)
};

Siehe auch timeoutTask().

enum class QtTaskTree::SetupResult

Diese Aufzählung wird optional von der Setup-Handler-Funktion der Gruppe oder Aufgabe zurückgegeben. Sie weist den laufenden Aufgabenbaum an, wie er nach Beendigung der Ausführung des Setup-Handlers fortfahren soll.

[alias] QtTaskTree::TreeDoneHandler

Typ-Alias für std::function<void(const QTaskTree &, QtTaskTree::DoneWith)>.

TreeDoneHandler ist ein optionales Argument für die Funktionen des Aufgabenbaum-Läufers, die die Ausführung des Aufgabenbaums planen. Die Funktion wird aufgerufen, wenn das Rezept des Task-Tree-Läufers die Ausführung beendet hat. Der Zugriff auf QTaskTree und das Ergebnis des Rezepts erfolgt über die übergebenen Argumente.

Die Task-Tree-Runner akzeptieren auch Handler in einer verkürzten Form von std::function<void(const QTaskTree &)>, std::function<void(QtTaskTree::DoneWith)> oder std::function<void(void)>.

[alias] QtTaskTree::TreeSetupHandler

Typ-Alias für std::function<void(QTaskTree &)>.

TreeSetupHandler ist ein optionales Argument für die Funktionen des Aufgabenbaum-Läufers, die die Ausführung des Aufgabenbaums planen. Die Funktion wird aufgerufen, wenn der Task-Tree-Runner im Begriff ist, sein Rezept auszuführen. Der Zugriff auf QTaskTree erfolgt über das übergebene Argument.

Die Task-Tree-Runner akzeptieren auch Handler in einer verkürzten Form von std::function<void(void)>.

enum class QtTaskTree::WorkflowPolicy

Diese Aufzählung beschreibt das mögliche Verhalten des Gruppenelements, wenn eine untergeordnete Aufgabe einer Gruppe ihre Ausführung beendet. Sie wird auch verwendet, wenn die laufende Gruppe abgebrochen wird.

Wenn das Ergebnis einer untergeordneten Aufgabe die Gruppe zum Anhalten veranlasst, d. h. im Falle der Richtlinien StopOnError, StopOnSuccess oder StopOnSuccessOrError, bricht die Gruppe die anderen laufenden untergeordneten Aufgaben ab (falls vorhanden - z. B. im parallelen Modus) und überspringt die Ausführung von Aufgaben, die sie noch nicht gestartet hat (z. B. im sequenziellen Modus - diejenigen, die nach der fehlgeschlagenen Aufgabe platziert sind). Sowohl das Abbrechen als auch das Überspringen von untergeordneten Aufgaben kann passieren, wenn ParallelLimit verwendet wird.

In der folgenden Tabelle sind die Unterschiede zwischen den verschiedenen Workflow-Policies zusammengefasst:

Wenn ein Kind einer Gruppe ebenfalls eine Gruppe ist, führt die Kindgruppe ihre Aufgaben gemäß ihrer eigenen Workflow-Richtlinie aus. Wenn eine übergeordnete Gruppe die laufende untergeordnete Gruppe aufgrund der Workflow-Richtlinie der übergeordneten Gruppe anhält, d. h. wenn die Richtlinie StopOnError, StopOnSuccess oder StopOnSuccessOrError für die übergeordnete Gruppe verwendet wurde, wird das Ergebnis der untergeordneten Gruppe in der Spalte Ergebnis und in der Zeile der Workflow-Richtlinie der untergeordneten Gruppe in der obigen Tabelle angegeben.