UnrealEngineUWP/Engine/Source/Developer/AutomationWindow/Private/SAutomationGraphicalResultBox.h

// Copyright 1998-2014 Epic Games, Inc. All Rights Reserved.

/*=============================================================================
	SAutomationGraphicalResultBox.h: Declares the SAutomationGraphicalResultBox class.
=============================================================================*/

#pragma once

/**
 * The different supported items we can display on the test item
 */
namespace EAutomationGrapicalDisplayType
{
	enum Type
	{
		DisplayName,
		DisplayTime
	};
}

/**
 * Implements the automation graphical results box widget.
 */
class SAutomationGraphicalResultBox
	: public SCompoundWidget
{
public:

	SLATE_BEGIN_ARGS(SAutomationGraphicalResultBox) { }

	SLATE_ARGUMENT(FString, Text)

	SLATE_END_ARGS()

public:

	/**
	 * Construct this widget
	 *
	 * @param InArgs - The declaration data for this widget.
	 * @param InAutomationController - Reference to the automation controller
	 */
	void Construct( const FArguments& InArgs, const IAutomationControllerManagerRef& InAutomationController);

	/**
	 * Clears the current results and any widgets that were created
	 */
	void ClearResults();

	/**
	 * Returns if there are any results available to display
	 */
	bool HasResults() const;

	/**
	 * Returns the current display type
	 */
	EAutomationGrapicalDisplayType::Type GetDisplayType() const;

	/**
	 * Sets the current display type
	 */
	void SetDisplayType(EAutomationGrapicalDisplayType::Type NewDisplayType);
private:

	/** Holds information on a single test result */
	class FTestResults
	{
	public:
		/** Constructor */
		FTestResults(const FString& InName)
		{
			TestName = InName;
			Duration = 0.f;
			TestState = EAutomationState::NotRun;
			bHasWarnings = false;
		}

		/** Name of the test */
		FString TestName;

		/** Duration of the test */
		float Duration;

		/** State of the test */
		EAutomationState::Type TestState;

		/** If the test had any warnings */
		bool bHasWarnings;
	};

	/** Holds all the test results for a single device */
	class FDeviceResults
	{
	public:
		/** Constructor */
		FDeviceResults(const FString& InName)
		{
			InstanceName = InName;
			TotalTime = 0.f;
			TotalTestSuccesses = 0;
		}

		/** Name of the device instance */
		FString InstanceName;

		/** Total time of all the tests */
		float TotalTime;

		/** How many of the tests were successful */
		uint32 TotalTestSuccesses;

		/** The list of tests */
		TArray<FTestResults> Tests;
	};

	/** Holds all the results for a single cluster */
	class FClusterResults
	{
	public:
		/** Constructor */
		FClusterResults(const FString& InName)
		{
			ClusterName = InName;
			TotalTime = 0.f;
			ParallelTime = 0.f;
			TotalNumTests = 0;
			TotalTestSuccesses = 0;
		}

		/** Name of the Cluster */
		FString ClusterName;

		/** Total number of tests */
		uint32 TotalNumTests;

		/** How many of the tests were successful */
		uint32 TotalTestSuccesses;

		/** Total time of all the tests */
		float TotalTime;

		/** Longest time a device took to finish its tests */
		float ParallelTime;

		/** The list of devices in this cluster */
		TArray <FDeviceResults> Devices;
	};

	/**
	 * Returns if there are any results available to display
	 *
	 * @param InReport - The report to recursively check for enabled tests.
	 * @param OutReports - The list of enabled test reports
	 */
	void GetEnabledReports(TSharedPtr<IAutomationReport> InReport, TArray< TSharedPtr< IAutomationReport > >& OutReports);

	/**
	 * Populates the ClusterResults with test data pulled from the automation controller
	 */
	void PopulateData();

	/**
	 * Creates all the slate widgets to display the test results
	 */
	void CreateWidgets();

	/**
	 * This is called when the tests are complete so we can update the widget
	 */
	void OnFillResults();

	/**
	 * Gets the color for a test based off the test state and if it has any warnings
	 *
	 * @param - TestState - The test state from the automation report (Success, Fail, NotRun, etc.)
	 * @param - bHasWarnings - If the test had any warning logs.
	 */
	FSlateColor GetColorForTestState(const EAutomationState::Type TestState, const bool bHasWarnings) const;

	/**
	 * Gets the text to display for this test item based off the current DisplayType
	 *
	 * @param - TestName - The name of the test
	 * @param - TestTime - The duration of the test
	 */
	FText GetTestDisplayText(const FString TestName, const float TestTime) const;

	/** Stores what information should be displayed on the test widgets */
	EAutomationGrapicalDisplayType::Type DisplayType;

	/** The test results grouped by cluster */
	TArray<FClusterResults> ClusterResults;

	/** The time of the longest cluster */
	float TotalTestDuration;

	/** Pointer to the root widget that contains all the reslut widgets */
	TSharedPtr< SVerticalBox > RootBox;

	/** Pointer to the automation controller so we can get the test results */
	IAutomationControllerManagerPtr AutomationController;
};