Amazon Lumberyard UI Extensions Guide Version 1.28 Amazon Lumberyard UI Extensions Guide Amazon Lumberyard: UI Extensions Guide Copyright © 2020 Amazon Web Services, Inc. and/or its affiliates. All rights reserved. Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by Amazon. Amazon Lumberyard UI Extensions Guide Table of Contents ....................................................................................................................................................... vi Introduction to Lumberyard UI development ......................................................................................... 1 Control gallery tool ............................................................................................................................ 2 How to use the Amazon Qt control gallery ................................................................................... 2 Component development guidelines ..................................................................................................... 4 Style sheets and StyleManager .................................................................................................... 4 Get started with UI component development ................................................................................ 4 UI development best practices ..................................................................................................... 5 Frequently asked questions ......................................................................................................... 5 UI component library ......................................................................................................................... 7 Breadcrumbs ............................................................................................................................. 7 Anatomy of the breadcrumbs widget .................................................................................. 10 Basic breadcrumb ............................................................................................................. 10 Breadcrumb with path navigation and browse ...................................................................... 11 C++ API reference ............................................................................................................ 12 Browse edit ............................................................................................................................. 12 Anatomy of the browse edit widget .................................................................................... 12 Basic browse edit ............................................................................................................. 13 Browse edit with custom icon and placeholder text .............................................................. 14 Browse edit with tooltips and validator ............................................................................... 15 Disabled browse edit ........................................................................................................ 15 C++ API reference ............................................................................................................ 16 Related links .................................................................................................................... 16 Button styles ........................................................................................................................... 16 Usage guidelines .............................................................................................................. 16 Applying styles ................................................................................................................ 17 C++ API reference ............................................................................................................ 18 Card ........................................................................................................................................ 18 Anatomy of the card widget .............................................................................................. 19 Basic card ........................................................................................................................ 20 Card with context menu and help icon ................................................................................ 21 Card with secondary content ............................................................................................. 21 Card with modified content ............................................................................................... 22 Disabled card ................................................................................................................... 22 Mock disabled card ........................................................................................................... 22 Card with warning state .................................................................................................... 23 Card with notification ....................................................................................................... 23 C++ API reference ............................................................................................................ 24 Related links .................................................................................................................... 24 Checkbox ................................................................................................................................. 24 Usage guidelines .............................................................................................................. 25 Basic checkbox ................................................................................................................. 26 C++ API reference ............................................................................................................ 26 Related links .................................................................................................................... 26 Combobox ............................................................................................................................... 27 Usage guidelines .............................................................................................................. 27 Basic combobox ............................................................................................................... 28 Combobox with validator .................................................................................................. 29 C++ API reference ............................................................................................................ 29 Context menu .......................................................................................................................... 29 Usage guidelines .............................................................................................................. 30 Basic context menu .......................................................................................................... 31 C++ API reference ............................................................................................................ 32 Filtered search ......................................................................................................................... 32 Version 1.28 iii Amazon Lumberyard UI Extensions Guide Anatomy of the filtered search widget ................................................................................ 32 Basic filtered search .......................................................................................................... 33 Filtered search with filter type icons ................................................................................... 34 Limiting the width of the search field ................................................................................. 35 C++ API reference ............................................................................................................ 35 Line edit .................................................................................................................................. 35 Anatomy of the line edit widget ........................................................................................ 35 Basic line edit .................................................................................................................. 36 Line edit with search ........................................................................................................ 37 Listening for line edit changes ........................................................................................... 37 Line edit as a drop target .................................................................................................. 37 Line edit with validator ..................................................................................................... 38 Disabled line edit ............................................................................................................. 38 C++ API reference ...........................................................................................................