/** @file\r
Private structure, MACRO and function definitions for User Interface related functionalities.\r
\r
-Copyright (c) 2004 - 2007, Intel Corporation\r
+Copyright (c) 2004 - 2010, Intel Corporation\r
All rights reserved. This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution. The full text of the license may be found at\r
#ifndef _UI_H_\r
#define _UI_H_\r
\r
-#include "Setup.h"\r
-\r
//\r
// Globals\r
//\r
\r
#define SUBTITLE_INDENT 2\r
\r
+\r
+//\r
+// It take 23 characters including the NULL to print a 64 bits number with "[" and "]".\r
+// pow(2, 64) = [18446744073709551616]\r
+//\r
+#define MAX_NUMERIC_INPUT_WIDTH 23\r
+\r
typedef enum {\r
UiNoOperation,\r
UiDefault,\r
CfPrepareToReadKey,\r
CfReadKey,\r
CfScreenOperation,\r
- CfUiPrevious,\r
CfUiSelect,\r
CfUiReset,\r
CfUiLeft,\r
FORM_BROWSER_FORMSET *FormSet;\r
FORM_BROWSER_FORM *Form;\r
FORM_BROWSER_STATEMENT *Statement;\r
+\r
+ //\r
+ // Whether the Form is editable\r
+ //\r
+ BOOLEAN FormEditable;\r
} UI_MENU_SELECTION;\r
\r
-#define UI_MENU_OPTION_SIGNATURE EFI_SIGNATURE_32 ('u', 'i', 'm', 'm')\r
-#define UI_MENU_LIST_SIGNATURE EFI_SIGNATURE_32 ('u', 'i', 'm', 'l')\r
+#define UI_MENU_OPTION_SIGNATURE SIGNATURE_32 ('u', 'i', 'm', 'm')\r
+#define UI_MENU_LIST_SIGNATURE SIGNATURE_32 ('u', 'i', 'm', 'l')\r
\r
typedef struct {\r
UINTN Signature;\r
\r
BOOLEAN GrayOut;\r
BOOLEAN ReadOnly;\r
+\r
+ //\r
+ // Whether user could change value of this item\r
+ //\r
+ BOOLEAN IsQuestion;\r
} UI_MENU_OPTION;\r
\r
#define MENU_OPTION_FROM_LINK(a) CR (a, UI_MENU_OPTION, Link, UI_MENU_OPTION_SIGNATURE)\r
\r
-typedef struct {\r
+typedef struct _UI_MENU_LIST UI_MENU_LIST;\r
+\r
+struct _UI_MENU_LIST {\r
UINTN Signature;\r
- LIST_ENTRY MenuLink;\r
+ LIST_ENTRY Link;\r
\r
+ EFI_GUID FormSetGuid;\r
UINT16 FormId;\r
UINT16 QuestionId;\r
-} UI_MENU_LIST;\r
\r
-typedef struct _MENU_REFRESH_ENTRY {\r
- struct _MENU_REFRESH_ENTRY *Next;\r
+ UI_MENU_LIST *Parent;\r
+ LIST_ENTRY ChildListHead;\r
+};\r
+\r
+#define UI_MENU_LIST_FROM_LINK(a) CR (a, UI_MENU_LIST, Link, UI_MENU_LIST_SIGNATURE)\r
+\r
+typedef struct _MENU_REFRESH_ENTRY MENU_REFRESH_ENTRY;\r
+struct _MENU_REFRESH_ENTRY {\r
+ MENU_REFRESH_ENTRY *Next;\r
UI_MENU_OPTION *MenuOption; // Describes the entry needing an update\r
UI_MENU_SELECTION *Selection;\r
UINTN CurrentColumn;\r
UINTN CurrentRow;\r
UINTN CurrentAttribute;\r
-} MENU_REFRESH_ENTRY;\r
+};\r
\r
typedef struct {\r
UINT16 ScanCode;\r
} SCREEN_OPERATION_T0_CONTROL_FLAG;\r
\r
\r
-extern LIST_ENTRY gMenuList;\r
+extern LIST_ENTRY gMenuOption;\r
extern MENU_REFRESH_ENTRY *gMenuRefreshHead;\r
extern UI_MENU_SELECTION *gCurrentSelection;\r
+extern BOOLEAN mHiiPackageListUpdated;\r
\r
//\r
// Global Functions\r
);\r
\r
/**\r
- Remove a Menu in list, and return FormId/QuestionId for previous Menu.\r
-\r
- @param Selection Menu selection.\r
+ Free Menu option linked list.\r
\r
**/\r
VOID\r
-UiRemoveMenuListEntry (\r
- OUT UI_MENU_SELECTION *Selection\r
+UiFreeMenu (\r
+ VOID\r
);\r
\r
/**\r
- Free Menu option linked list.\r
+ Create a menu with specified formset GUID and form ID, and add it as a child\r
+ of the given parent menu.\r
+\r
+ @param Parent The parent of menu to be added.\r
+ @param FormSetGuid The Formset Guid of menu to be added.\r
+ @param FormId The Form ID of menu to be added.\r
+\r
+ @return A pointer to the newly added menu or NULL if memory is insufficient.\r
\r
**/\r
-VOID\r
-UiFreeMenuList (\r
- VOID\r
+UI_MENU_LIST *\r
+UiAddMenuList (\r
+ IN OUT UI_MENU_LIST *Parent,\r
+ IN EFI_GUID *FormSetGuid,\r
+ IN UINT16 FormId\r
);\r
\r
/**\r
- Add one menu entry to the linked lst\r
+ Search Menu with given FormId in the parent menu and all its child menus.\r
\r
- @param Selection Menu selection.\r
+ @param Parent The parent of menu to search.\r
+ @param FormId The Form ID of menu to search.\r
+\r
+ @return A pointer to menu found or NULL if not found.\r
\r
**/\r
-VOID\r
-UiAddMenuListEntry (\r
- IN UI_MENU_SELECTION *Selection\r
+UI_MENU_LIST *\r
+UiFindChildMenuList (\r
+ IN UI_MENU_LIST *Parent,\r
+ IN UINT16 FormId\r
+ );\r
+\r
+/**\r
+ Search Menu with given FormSetGuid and FormId in all cached menu list.\r
+\r
+ @param FormSetGuid The Formset GUID of the menu to search.\r
+ @param FormId The Form ID of menu to search.\r
+\r
+ @return A pointer to menu found or NULL if not found.\r
+\r
+**/\r
+UI_MENU_LIST *\r
+UiFindMenuList (\r
+ IN EFI_GUID *FormSetGuid,\r
+ IN UINT16 FormId\r
);\r
\r
/**\r
\r
**/\r
VOID\r
-UiFreeMenu (\r
+UiFreeRefreshList (\r
VOID\r
);\r
\r
@param NumberOfLines Display lines for this Menu Option.\r
@param MenuItemCount The index for this Option in the Menu.\r
\r
+ @retval Pointer Pointer to the added Menu Option.\r
+\r
**/\r
-VOID\r
+UI_MENU_OPTION *\r
UiAddMenuOption (\r
IN CHAR16 *String,\r
IN EFI_HII_HANDLE Handle,\r
IN OUT UI_MENU_SELECTION *Selection\r
);\r
\r
-/**\r
- VSPrint worker function that prints a Value as a decimal number in Buffer.\r
-\r
- @param Buffer Location to place ascii decimal number string of Value.\r
- @param Flags Flags to use in printing decimal string, see file header for\r
- details.\r
- @param Value Decimal value to convert to a string in Buffer.\r
-\r
- @return Number of characters printed.\r
-\r
-**/\r
-VOID\r
-ValueToString (\r
- IN CHAR16 *Buffer,\r
- IN BOOLEAN Flags,\r
- IN INT64 Value\r
- );\r
-\r
/**\r
Set Buffer to Value for Size bytes.\r
\r
Draw a pop up windows based on the dimension, number of lines and\r
strings specified.\r
\r
- @param RequestedWidth The width of the pop-up.\r
+ @param ScreenWidth The width of the pop-up.\r
@param NumberOfLines The number of lines.\r
@param ... A series of text strings that displayed in the pop-up.\r
\r
**/\r
VOID\r
-CreatePopUp (\r
+CreateMultiStringPopUp (\r
IN UINTN ScreenWidth,\r
IN UINTN NumberOfLines,\r
...\r
IN EFI_HII_VALUE *OptionValue\r
);\r
\r
+/**\r
+ Return data element in an Array by its Index.\r
+\r
+ @param Array The data array.\r
+ @param Type Type of the data in this array.\r
+ @param Index Zero based index for data in this array.\r
+\r
+ @retval Value The data to be returned\r
+\r
+**/\r
+UINT64\r
+GetArrayData (\r
+ IN VOID *Array,\r
+ IN UINT8 Type,\r
+ IN UINTN Index\r
+ );\r
+\r
+/**\r
+ Set value of a data element in an Array by its Index.\r
+\r
+ @param Array The data array.\r
+ @param Type Type of the data in this array.\r
+ @param Index Zero based index for data in this array.\r
+ @param Value The value to be set.\r
+\r
+**/\r
+VOID\r
+SetArrayData (\r
+ IN VOID *Array,\r
+ IN UINT8 Type,\r
+ IN UINTN Index,\r
+ IN UINT64 Value\r
+ );\r
+\r
/**\r
Process a Question's Option (whether selected or un-selected).\r
\r
/**\r
Update key's help imformation.\r
\r
+ @param Selection Tell setup browser the information about the Selection\r
@param MenuOption The Menu option\r
@param Selected Whether or not a tag be selected\r
\r
**/\r
VOID\r
UpdateKeyHelp (\r
+ IN UI_MENU_SELECTION *Selection,\r
IN UI_MENU_OPTION *MenuOption,\r
IN BOOLEAN Selected\r
);\r
**/\r
VOID\r
ClearLines (\r
- UINTN LeftColumn,\r
- UINTN RightColumn,\r
- UINTN TopRow,\r
- UINTN BottomRow,\r
- UINTN TextAttribute\r
+ IN UINTN LeftColumn,\r
+ IN UINTN RightColumn,\r
+ IN UINTN TopRow,\r
+ IN UINTN BottomRow,\r
+ IN UINTN TextAttribute\r
);\r
\r
/**\r
\r
This function handles the Unicode string with NARROW_CHAR\r
and WIDE_CHAR control characters. NARROW_HCAR and WIDE_CHAR\r
- does not count in the resultant output. If a WIDE_CHAR is \r
+ does not count in the resultant output. If a WIDE_CHAR is\r
hit, then 2 Unicode character will consume an output storage\r
space with size of CHAR16 till a NARROW_CHAR is hit.\r
\r
**/\r
UINTN\r
GetStringWidth (\r
- CHAR16 *String\r
+ IN CHAR16 *String\r
);\r
\r
/**\r
**/\r
VOID\r
NewStrCat (\r
- CHAR16 *Destination,\r
- CHAR16 *Source\r
+ IN OUT CHAR16 *Destination,\r
+ IN CHAR16 *Source\r
);\r
\r
/**\r
/**\r
Evaluate the result of a HII expression\r
\r
+ If Expression is NULL, then ASSERT.\r
+\r
@param FormSet FormSet associated with this expression.\r
@param Form Form associated with this expression.\r
@param Expression Expression to be evaluated.\r