View source for Documentation/Widget testing

[[Documentation|Back to CTK Documentation]]

= Overview =

Testing of both CTK widgets and application built on top of CTK could leverage the capabilities offered by the [http://www.paraview.org/Wiki/Testing_design QtTesting library] developed by [http://www.paraview.org Paraview] folks.


If the option '''CTK_USE_QTTESTING''' is enabled, the build system will:
* Download external project QtTesting
* Include the event translator and player required for custom CTK widgets. (Located in the same folder as their associated widget sources)
* Include the class ''ctkEventTranslaterPlayerWidget'' into CTKWidgets library
* If '''BUILD_TESTING''' is enabled: CTK widgets EventTranslatorTests will be compiled. These tests will use ''ctkEventTranslaterPlayerWidget'' and ensure that events associated with CTK widgets can be properly recorded and played.


{{note}} Option '''CTK_USE_QTTESTING''' will be automatically enabled if '''BUILD_TESTING''' is ON

= Milestones =

# Integration: What and where. {{Done}}
# Integrate QtTesting has an external projects {{Done}}
# Implement ''ctkEventTranslaterPlayerWidget'' {{Doing}}
# Create custom translator/player if needed {{Doing}}
# Implement widgets EventTranslatorTests {{Doing}}

= Player/Translators Widget Testing =

CTKWidgets

----

{| class="wikitable" style="text-align:left; width:40%;"
|-
! scope=col | Widgets
! scope=col | State
! scope=col | Priority
! scope=col | Notes
|-
|ctkActionsWidget
|{{Done}}
|'''+++'''
|
|-
|ctkAddRemoveComboBox
|{{Done}}
|
|
|-
|ctkAxesWidget
|{{Done}}
|'''+++'''
|
|-
|ctkBasePopupWidget
|{{Not Done}}
|
|
|-
|ctkButtonGroup 
|{{Not Done}}
|
|
|-
|ctkCheckableComboBox
|{{Not Done}}
|
|
|-
|ctkCheckableHeaderView
|{{Not Done}}
|
|
|-
|ctkCheckBoxPixmaps
|{{Not Done}}
|
|
|-
|ctkCheckablePushButton
|{{Not Done}}
|
|
|-
|ctkComboBox
|{{Done}}
|
|
|-
|ctkCompleter
|{{Not Done}}
|
|
|-
|ctkCollapsibleButton
|{{Not Done}}
|
|
|-
|ctkCollapsibleGroupBox
|{{Not Done}}
|
|
|-
|ctkColorDialog
|{{Not Done}}
|
|
|-
|ctkColorPickerButton
|{{Not Done}}
|
|
|-
|ctkConsole
|{{Done}}{{Doing}}
|
|
|-
|ctkConfirmExitDialog
|{{Not Done}}
|
|
|-
|ctkCoordinatesWidget
|{{Done}}{{Doing}}
|
|''Problem with the QSpinBox''
|-
|ctkCrosshairLabel
|{{Not Done}}
|
|
|-
|ctkDateRangeWidget
|{{Doing}}
|
|''Problem with QDateTimer'' 
|-
|ctkDirectoryButton
|{{Done}}{{Doing}}
|
|''Value OK but no dialog''
|-
|ctkDoubleRangeSlider
|{{Done}}
|
|
|-
|ctkDoubleSlider
|{{Done}}
|
|
|-
|ctkDynamicSpacer
|{{Not Done}}
|
|
|-
|ctkErrorLogStatusMessageHandler
|{{Not Done}}
|
|
|-
|ctkErrorLogWidget
|{{Not Done}}
|'''---'''
|
|-
|ctkExpandButton
|{{Done}}
|'''++'''
|
|-
|ctkFileDialog
|{{Doing}}
|
|
|-
|ctkFittedTextBrowser
|{{Not Done}}
|
|
|-
|ctkFlowLayout
|{{Not Done}}
|
|
|-
|ctkFontButton
|{{Done}}{{Doing}}
|
|''QComboBox doesn't change the font''
|-
|ctkIconEnginePlugin
|{{Not Done}}
|
|
|-
|ctkLayoutManager
|{{Not Done}}
|
|
|-
|ctkMaterialPropertyPreviewLabel
|{{Not Done}}
|'''+++'''
|
|-
|ctkMaterialPropertyWidget
|{{Done}}{{Doing}}
|'''+++'''
|''QSpin issue''
|-
|ctkMatrixWidget
|{{Done}}{{Doing}}
|'''+++'''
|''QSpin issue + Name QSpin issue : EventTranslator ?''
|-
|ctkMenuButton
|{{Done}}
|'''++'''
|
|-
|ctkMenuComboBox
|{{Doing}}{{Not Done}}
|'''+++'''
|''Implemented Event Translator/Player ''
|-
|ctkModalityWidget
|{{Not Done}}
|
|
|-
|ctkPathLineEdit
|{{Not Done}}
|
|
|-
|ctkPixmapIconEngine
|{{Not Done}}
|
|
|-
|ctkPopupWidget
|{{Not Done}}
|
|
|-
|ctkQImageView
|{{Not Done}}
|
|
|-
|ctkRangeSlider
|{{Done}}
|'''++'''
|
|-
|ctkRangeWidget
|{{Doing}}
|'''++'''
|
|-
|ctkScreenshotDialog
|{{Not Done}}
|
|
|-
|ctkSearchBox
|{{Not Done}}
|'''++'''
|
|-
|ctkSettings
|{{Not Done}}
|'''++'''
|
|-
|ctkSettingsDialog
|{{Not Done}}
|'''++'''
|
|-
|ctkSettingsPanel
|{{Not Done}}
|
|
|-
|ctkSignalMapper
|{{Not Done}}
|
|
|-
|ctkSimpleLayoutManager
|{{Not Done}}
|
|
|-
|ctkSliderWidget
|{{Not Done}}
|
|
|-
|ctkTestApplication
|{{Not Done}}
|
|
|-
|ctkThumbnailListWidget
|{{Not Done}}
|
|
|-
|ctkThumbnailWidget
|{{Not Done}}
|
|
|-
|ctkToolTipTrapper
|{{Not Done}}
|
|
|-
|ctkTransferFunctionBarsItem
|{{Not Done}}
|
|
|-
|ctkTransferFunctionControlPointsItem
|{{Not Done}}
|
|
|-
|ctkTransferFunctionGradientItem
|{{Not Done}}
|
|
|-
|ctkTransferFunctionItem
|{{Not Done}}
|
|
|-
|ctkTransferFunctionScene
|{{Not Done}}
|
|
|-
|ctkTransferFunctionView
|{{Not Done}}
|
|
|-
|ctkTreeComboBox
|{{Not Done}}
|
|
|-
|ctkWidgetsUtils
|{{Not Done}}
|
|
|-
|ctkWorkflowAbstractPagedWidget
|{{Not Done}}
|
|
|-
|ctkWorkflowButtonBoxWidget
|{{Not Done}}
|
|
|-
|ctkWorkflowGroupBox
|{{Not Done}}
|
|
|-
|ctkWorkflowStackedWidget
|{{Not Done}}
|
|
|-
|ctkWorkflowTabWidget
|{{Not Done}}
|
|
|-
|ctkWorkflowWidget
|{{Not Done}}
|
|
|-
|ctkWorkflowWidgetStep
|{{Not Done}}
|
|
|}

= Screenshots =
<gallery widths=300 px heights=200px perrow=3>
Image:CtkQtTestingScreenShot.png|Simple application with recording / playing Qt testing capabilities
Image:CtkEventTranslatorPlayerWidget.png|Little exemple of the widget testing 
</gallery>