2 Utility functions for UI presentation.
4 Copyright (c) 2004 - 2012, Intel Corporation. All rights reserved.<BR>
5 This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
17 BOOLEAN mHiiPackageListUpdated
;
18 UI_MENU_SELECTION
*gCurrentSelection
;
19 EFI_HII_HANDLE mCurrentHiiHandle
= NULL
;
20 EFI_GUID mCurrentFormSetGuid
= {0, 0, 0, {0, 0, 0, 0, 0, 0, 0, 0}};
21 UINT16 mCurrentFormId
= 0;
24 Clear retangle with specified text attribute.
26 @param LeftColumn Left column of retangle.
27 @param RightColumn Right column of retangle.
28 @param TopRow Start row of retangle.
29 @param BottomRow End row of retangle.
30 @param TextAttribute The character foreground and background.
39 IN UINTN TextAttribute
46 // For now, allocate an arbitrarily long buffer
48 Buffer
= AllocateZeroPool (0x10000);
49 ASSERT (Buffer
!= NULL
);
52 // Set foreground and background as defined
54 gST
->ConOut
->SetAttribute (gST
->ConOut
, TextAttribute
);
57 // Much faster to buffer the long string instead of print it a character at a time
59 SetUnicodeMem (Buffer
, RightColumn
- LeftColumn
, L
' ');
62 // Clear the desired area with the appropriate foreground/background
64 for (Row
= TopRow
; Row
<= BottomRow
; Row
++) {
65 PrintStringAt (LeftColumn
, Row
, Buffer
);
68 gST
->ConOut
->SetCursorPosition (gST
->ConOut
, LeftColumn
, TopRow
);
75 Concatenate a narrow string to another string.
77 @param Destination The destination string.
78 @param Source The source string. The string to be concatenated.
79 to the end of Destination.
84 IN OUT CHAR16
*Destination
,
90 for (Length
= 0; Destination
[Length
] != 0; Length
++)
94 // We now have the length of the original string
95 // We can safely assume for now that we are concatenating a narrow value to this string.
96 // For instance, the string is "XYZ" and cat'ing ">"
97 // If this assumption changes, we need to make this routine a bit more complex
99 Destination
[Length
] = NARROW_CHAR
;
102 StrCpy (Destination
+ Length
, Source
);
106 Count the storage space of a Unicode string.
108 This function handles the Unicode string with NARROW_CHAR
109 and WIDE_CHAR control characters. NARROW_HCAR and WIDE_CHAR
110 does not count in the resultant output. If a WIDE_CHAR is
111 hit, then 2 Unicode character will consume an output storage
112 space with size of CHAR16 till a NARROW_CHAR is hit.
114 If String is NULL, then ASSERT ().
116 @param String The input string to be counted.
118 @return Storage space for the input string.
128 UINTN IncrementValue
;
130 ASSERT (String
!= NULL
);
131 if (String
== NULL
) {
141 // Advance to the null-terminator or to the first width directive
144 (String
[Index
] != NARROW_CHAR
) && (String
[Index
] != WIDE_CHAR
) && (String
[Index
] != 0);
145 Index
++, Count
= Count
+ IncrementValue
150 // We hit the null-terminator, we now have a count
152 if (String
[Index
] == 0) {
156 // We encountered a narrow directive - strip it from the size calculation since it doesn't get printed
157 // and also set the flag that determines what we increment by.(if narrow, increment by 1, if wide increment by 2)
159 if (String
[Index
] == NARROW_CHAR
) {
161 // Skip to the next character
167 // Skip to the next character
172 } while (String
[Index
] != 0);
175 // Increment by one to include the null-terminator in the size
179 return Count
* sizeof (CHAR16
);
183 This function displays the page frame.
185 @param Selection Selection contains the information about
186 the Selection, form and formset to be displayed.
187 Selection action may be updated in retrieve callback.
191 IN UI_MENU_SELECTION
*Selection
199 CHAR16
*StrFrontPageBanner
;
201 EFI_SCREEN_DESCRIPTOR LocalScreen
;
205 ZeroMem (&LocalScreen
, sizeof (EFI_SCREEN_DESCRIPTOR
));
206 gST
->ConOut
->QueryMode (gST
->ConOut
, gST
->ConOut
->Mode
->Mode
, &LocalScreen
.RightColumn
, &LocalScreen
.BottomRow
);
207 ClearLines (0, LocalScreen
.RightColumn
, 0, LocalScreen
.BottomRow
, KEYHELP_BACKGROUND
);
209 if (Selection
->Form
->ModalForm
) {
213 CopyMem (&LocalScreen
, &gScreenDimensions
, sizeof (EFI_SCREEN_DESCRIPTOR
));
216 // For now, allocate an arbitrarily long buffer
218 Buffer
= AllocateZeroPool (0x10000);
219 ASSERT (Buffer
!= NULL
);
221 Character
= BOXDRAW_HORIZONTAL
;
223 for (Index
= 0; Index
+ 2 < (LocalScreen
.RightColumn
- LocalScreen
.LeftColumn
); Index
++) {
224 Buffer
[Index
] = Character
;
227 if ((gClassOfVfr
& FORMSET_CLASS_FRONT_PAGE
) == FORMSET_CLASS_FRONT_PAGE
) {
229 // ClearLines(0, LocalScreen.RightColumn, 0, BANNER_HEIGHT-1, BANNER_TEXT | BANNER_BACKGROUND);
232 LocalScreen
.LeftColumn
,
233 LocalScreen
.RightColumn
,
235 FRONT_PAGE_HEADER_HEIGHT
- 1 + LocalScreen
.TopRow
,
236 BANNER_TEXT
| BANNER_BACKGROUND
239 // for (Line = 0; Line < BANNER_HEIGHT; Line++) {
241 for (Line
= (UINT8
) LocalScreen
.TopRow
; Line
< BANNER_HEIGHT
+ (UINT8
) LocalScreen
.TopRow
; Line
++) {
243 // for (Alignment = 0; Alignment < BANNER_COLUMNS; Alignment++) {
245 for (Alignment
= (UINT8
) LocalScreen
.LeftColumn
;
246 Alignment
< BANNER_COLUMNS
+ (UINT8
) LocalScreen
.LeftColumn
;
249 RowIdx
= (UINT8
) (Line
- (UINT8
) LocalScreen
.TopRow
);
250 ColumnIdx
= (UINT8
) (Alignment
- (UINT8
) LocalScreen
.LeftColumn
);
252 ASSERT (RowIdx
< BANNER_HEIGHT
);
253 ASSERT (ColumnIdx
< BANNER_COLUMNS
);
255 if (gBannerData
->Banner
[RowIdx
][ColumnIdx
] != 0x0000) {
256 StrFrontPageBanner
= GetToken (
257 gBannerData
->Banner
[RowIdx
][ColumnIdx
],
264 switch (Alignment
- LocalScreen
.LeftColumn
) {
267 // Handle left column
269 PrintStringAt (LocalScreen
.LeftColumn
+ BANNER_LEFT_COLUMN_INDENT
, Line
, StrFrontPageBanner
);
274 // Handle center column
277 LocalScreen
.LeftColumn
+ (LocalScreen
.RightColumn
- LocalScreen
.LeftColumn
) / 3,
285 // Handle right column
288 LocalScreen
.LeftColumn
+ (LocalScreen
.RightColumn
- LocalScreen
.LeftColumn
) * 2 / 3,
295 FreePool (StrFrontPageBanner
);
301 LocalScreen
.LeftColumn
,
302 LocalScreen
.RightColumn
,
303 LocalScreen
.BottomRow
- STATUS_BAR_HEIGHT
- gFooterHeight
,
304 LocalScreen
.BottomRow
- STATUS_BAR_HEIGHT
- 1,
305 KEYHELP_TEXT
| KEYHELP_BACKGROUND
308 if ((gClassOfVfr
& FORMSET_CLASS_FRONT_PAGE
) != FORMSET_CLASS_FRONT_PAGE
) {
310 LocalScreen
.LeftColumn
,
311 LocalScreen
.RightColumn
,
313 LocalScreen
.TopRow
+ NONE_FRONT_PAGE_HEADER_HEIGHT
- 1,
314 TITLE_TEXT
| TITLE_BACKGROUND
317 // Print Top border line
318 // +------------------------------------------------------------------------------+
320 // +------------------------------------------------------------------------------+
322 Character
= BOXDRAW_DOWN_RIGHT
;
324 PrintChar (Character
);
325 PrintString (Buffer
);
327 Character
= BOXDRAW_DOWN_LEFT
;
328 PrintChar (Character
);
330 Character
= BOXDRAW_VERTICAL
;
331 for (Row
= LocalScreen
.TopRow
+ 1; Row
<= LocalScreen
.TopRow
+ NONE_FRONT_PAGE_HEADER_HEIGHT
- 2; Row
++) {
332 PrintCharAt (LocalScreen
.LeftColumn
, Row
, Character
);
333 PrintCharAt (LocalScreen
.RightColumn
- 1, Row
, Character
);
336 Character
= BOXDRAW_UP_RIGHT
;
337 PrintCharAt (LocalScreen
.LeftColumn
, LocalScreen
.TopRow
+ NONE_FRONT_PAGE_HEADER_HEIGHT
- 1, Character
);
338 PrintString (Buffer
);
340 Character
= BOXDRAW_UP_LEFT
;
341 PrintChar (Character
);
343 if ((gClassOfVfr
& FORMSET_CLASS_PLATFORM_SETUP
) == FORMSET_CLASS_PLATFORM_SETUP
) {
345 // Print Bottom border line
346 // +------------------------------------------------------------------------------+
348 // +------------------------------------------------------------------------------+
350 Character
= BOXDRAW_DOWN_RIGHT
;
351 PrintCharAt (LocalScreen
.LeftColumn
, LocalScreen
.BottomRow
- STATUS_BAR_HEIGHT
- gFooterHeight
, Character
);
353 PrintString (Buffer
);
355 Character
= BOXDRAW_DOWN_LEFT
;
356 PrintChar (Character
);
357 Character
= BOXDRAW_VERTICAL
;
358 for (Row
= LocalScreen
.BottomRow
- STATUS_BAR_HEIGHT
- gFooterHeight
+ 1;
359 Row
<= LocalScreen
.BottomRow
- STATUS_BAR_HEIGHT
- 2;
362 PrintCharAt (LocalScreen
.LeftColumn
, Row
, Character
);
363 PrintCharAt (LocalScreen
.RightColumn
- 1, Row
, Character
);
366 Character
= BOXDRAW_UP_RIGHT
;
367 PrintCharAt (LocalScreen
.LeftColumn
, LocalScreen
.BottomRow
- STATUS_BAR_HEIGHT
- 1, Character
);
369 PrintString (Buffer
);
371 Character
= BOXDRAW_UP_LEFT
;
372 PrintChar (Character
);
382 Evaluate all expressions in a Form.
384 @param FormSet FormSet this Form belongs to.
385 @param Form The Form.
387 @retval EFI_SUCCESS The expression evaluated successfuly
391 EvaluateFormExpressions (
392 IN FORM_BROWSER_FORMSET
*FormSet
,
393 IN FORM_BROWSER_FORM
*Form
398 FORM_EXPRESSION
*Expression
;
400 Link
= GetFirstNode (&Form
->ExpressionListHead
);
401 while (!IsNull (&Form
->ExpressionListHead
, Link
)) {
402 Expression
= FORM_EXPRESSION_FROM_LINK (Link
);
403 Link
= GetNextNode (&Form
->ExpressionListHead
, Link
);
405 if (Expression
->Type
== EFI_HII_EXPRESSION_INCONSISTENT_IF
||
406 Expression
->Type
== EFI_HII_EXPRESSION_NO_SUBMIT_IF
||
407 Expression
->Type
== EFI_HII_EXPRESSION_WRITE
||
408 (Expression
->Type
== EFI_HII_EXPRESSION_READ
&& Form
->FormType
!= STANDARD_MAP_FORM_TYPE
)) {
410 // Postpone Form validation to Question editing or Form submitting or Question Write or Question Read for nonstandard form.
415 Status
= EvaluateExpression (FormSet
, Form
, Expression
);
416 if (EFI_ERROR (Status
)) {
425 +------------------------------------------------------------------------------+
427 +------------------------------------------------------------------------------+
445 +------------------------------------------------------------------------------+
446 ?F1=Scroll Help F9=Reset to Defaults F10=Save and Exit ?
447 | ^"=Move Highlight <Spacebar> Toggles Checkbox Esc=Discard Changes |
448 +------------------------------------------------------------------------------+
454 Display form and wait for user to select one menu option, then return it.
456 @param Selection On input, Selection tell setup browser the information
457 about the Selection, form and formset to be displayed.
458 On output, Selection return the screen item that is selected
460 @retval EFI_SUCESSS This function always return successfully for now.
465 IN OUT UI_MENU_SELECTION
*Selection
469 UINT16 MenuItemCount
;
470 EFI_HII_HANDLE Handle
;
471 EFI_SCREEN_DESCRIPTOR LocalScreen
;
474 CHAR16
*OutputString
;
476 FORM_BROWSER_STATEMENT
*Statement
;
477 UINT16 NumberOfLines
;
479 UI_MENU_OPTION
*MenuOption
;
481 Handle
= Selection
->Handle
;
488 CopyMem (&LocalScreen
, &gScreenDimensions
, sizeof (EFI_SCREEN_DESCRIPTOR
));
490 StringPtr
= GetToken (Selection
->Form
->FormTitle
, Handle
);
492 if ((gClassOfVfr
& FORMSET_CLASS_FRONT_PAGE
) != FORMSET_CLASS_FRONT_PAGE
) {
493 if (Selection
->Form
->ModalForm
) {
494 gST
->ConOut
->SetAttribute (gST
->ConOut
, TITLE_TEXT
| EFI_BACKGROUND_BLACK
);
496 gST
->ConOut
->SetAttribute (gST
->ConOut
, TITLE_TEXT
| TITLE_BACKGROUND
);
499 (LocalScreen
.RightColumn
+ LocalScreen
.LeftColumn
- GetStringWidth (StringPtr
) / 2) / 2,
500 LocalScreen
.TopRow
+ 1,
506 // Remove Buffer allocated for StringPtr after it has been used.
508 FreePool (StringPtr
);
511 // Evaluate all the Expressions in this Form
513 Status
= EvaluateFormExpressions (Selection
->FormSet
, Selection
->Form
);
514 if (EFI_ERROR (Status
)) {
518 Selection
->FormEditable
= FALSE
;
519 Link
= GetFirstNode (&Selection
->Form
->StatementListHead
);
520 while (!IsNull (&Selection
->Form
->StatementListHead
, Link
)) {
521 Statement
= FORM_BROWSER_STATEMENT_FROM_LINK (Link
);
523 if (EvaluateExpressionList(Statement
->Expression
, FALSE
, NULL
, NULL
) <= ExpressGrayOut
) {
524 StringPtr
= GetToken (Statement
->Prompt
, Handle
);
525 ASSERT (StringPtr
!= NULL
);
527 Width
= GetWidth (Statement
, Handle
);
531 for (; GetLineByWidth (StringPtr
, Width
, &ArrayEntry
, &OutputString
) != 0x0000;) {
533 // If there is more string to process print on the next row and increment the Skip value
535 if (StrLen (&StringPtr
[ArrayEntry
]) != 0) {
539 FreePool (OutputString
);
543 // We are NOT!! removing this StringPtr buffer via FreePool since it is being used in the menuoptions, we will do
546 MenuOption
= UiAddMenuOption (StringPtr
, Selection
->Handle
, Selection
->Form
, Statement
, NumberOfLines
, MenuItemCount
);
549 if (MenuOption
->IsQuestion
&& !MenuOption
->ReadOnly
) {
551 // At least one item is not readonly, this Form is considered as editable
553 Selection
->FormEditable
= TRUE
;
557 Link
= GetNextNode (&Selection
->Form
->StatementListHead
, Link
);
560 Status
= UiDisplayMenu (Selection
);
568 Initialize the HII String Token to the correct values.
572 InitializeBrowserStrings (
576 gEnterString
= GetToken (STRING_TOKEN (ENTER_STRING
), gHiiHandle
);
577 gEnterCommitString
= GetToken (STRING_TOKEN (ENTER_COMMIT_STRING
), gHiiHandle
);
578 gEnterEscapeString
= GetToken (STRING_TOKEN (ENTER_ESCAPE_STRING
), gHiiHandle
);
579 gEscapeString
= GetToken (STRING_TOKEN (ESCAPE_STRING
), gHiiHandle
);
580 gMoveHighlight
= GetToken (STRING_TOKEN (MOVE_HIGHLIGHT
), gHiiHandle
);
581 gMakeSelection
= GetToken (STRING_TOKEN (MAKE_SELECTION
), gHiiHandle
);
582 gDecNumericInput
= GetToken (STRING_TOKEN (DEC_NUMERIC_INPUT
), gHiiHandle
);
583 gHexNumericInput
= GetToken (STRING_TOKEN (HEX_NUMERIC_INPUT
), gHiiHandle
);
584 gToggleCheckBox
= GetToken (STRING_TOKEN (TOGGLE_CHECK_BOX
), gHiiHandle
);
585 gPromptForData
= GetToken (STRING_TOKEN (PROMPT_FOR_DATA
), gHiiHandle
);
586 gPromptForPassword
= GetToken (STRING_TOKEN (PROMPT_FOR_PASSWORD
), gHiiHandle
);
587 gPromptForNewPassword
= GetToken (STRING_TOKEN (PROMPT_FOR_NEW_PASSWORD
), gHiiHandle
);
588 gConfirmPassword
= GetToken (STRING_TOKEN (CONFIRM_PASSWORD
), gHiiHandle
);
589 gConfirmError
= GetToken (STRING_TOKEN (CONFIRM_ERROR
), gHiiHandle
);
590 gPassowordInvalid
= GetToken (STRING_TOKEN (PASSWORD_INVALID
), gHiiHandle
);
591 gPressEnter
= GetToken (STRING_TOKEN (PRESS_ENTER
), gHiiHandle
);
592 gEmptyString
= GetToken (STRING_TOKEN (EMPTY_STRING
), gHiiHandle
);
593 gAreYouSure
= GetToken (STRING_TOKEN (ARE_YOU_SURE
), gHiiHandle
);
594 gYesResponse
= GetToken (STRING_TOKEN (ARE_YOU_SURE_YES
), gHiiHandle
);
595 gNoResponse
= GetToken (STRING_TOKEN (ARE_YOU_SURE_NO
), gHiiHandle
);
596 gMiniString
= GetToken (STRING_TOKEN (MINI_STRING
), gHiiHandle
);
597 gPlusString
= GetToken (STRING_TOKEN (PLUS_STRING
), gHiiHandle
);
598 gMinusString
= GetToken (STRING_TOKEN (MINUS_STRING
), gHiiHandle
);
599 gAdjustNumber
= GetToken (STRING_TOKEN (ADJUST_NUMBER
), gHiiHandle
);
600 gSaveChanges
= GetToken (STRING_TOKEN (SAVE_CHANGES
), gHiiHandle
);
601 gOptionMismatch
= GetToken (STRING_TOKEN (OPTION_MISMATCH
), gHiiHandle
);
602 gFormSuppress
= GetToken (STRING_TOKEN (FORM_SUPPRESSED
), gHiiHandle
);
607 Free up the resource allocated for all strings required
616 FreePool (gEnterString
);
617 FreePool (gEnterCommitString
);
618 FreePool (gEnterEscapeString
);
619 FreePool (gEscapeString
);
620 FreePool (gMoveHighlight
);
621 FreePool (gMakeSelection
);
622 FreePool (gDecNumericInput
);
623 FreePool (gHexNumericInput
);
624 FreePool (gToggleCheckBox
);
625 FreePool (gPromptForData
);
626 FreePool (gPromptForPassword
);
627 FreePool (gPromptForNewPassword
);
628 FreePool (gConfirmPassword
);
629 FreePool (gPassowordInvalid
);
630 FreePool (gConfirmError
);
631 FreePool (gPressEnter
);
632 FreePool (gEmptyString
);
633 FreePool (gAreYouSure
);
634 FreePool (gYesResponse
);
635 FreePool (gNoResponse
);
636 FreePool (gMiniString
);
637 FreePool (gPlusString
);
638 FreePool (gMinusString
);
639 FreePool (gAdjustNumber
);
640 FreePool (gSaveChanges
);
641 FreePool (gOptionMismatch
);
642 FreePool (gFormSuppress
);
647 Show all registered HotKey help strings on bottom Rows.
651 PrintHotKeyHelpString (
657 UINTN BottomRowOfHotKeyHelp
;
660 EFI_SCREEN_DESCRIPTOR LocalScreen
;
662 BROWSER_HOT_KEY
*HotKey
;
664 CopyMem (&LocalScreen
, &gScreenDimensions
, sizeof (EFI_SCREEN_DESCRIPTOR
));
665 ColumnWidth
= (LocalScreen
.RightColumn
- LocalScreen
.LeftColumn
) / 3;
666 BottomRowOfHotKeyHelp
= LocalScreen
.BottomRow
- STATUS_BAR_HEIGHT
- 3;
669 // Calculate total number of Register HotKeys.
672 Link
= GetFirstNode (&gBrowserHotKeyList
);
673 while (!IsNull (&gBrowserHotKeyList
, Link
)) {
674 HotKey
= BROWSER_HOT_KEY_FROM_LINK (Link
);
676 // Help string can't exceed ColumnWidth. One Row will show three Help information.
678 if (StrLen (HotKey
->HelpString
) > ColumnWidth
) {
679 HotKey
->HelpString
[ColumnWidth
] = L
'\0';
682 // Calculate help information Column and Row.
684 if ((Index
% 3) != 2) {
685 CurrentCol
= LocalScreen
.LeftColumn
+ (2 - Index
% 3) * ColumnWidth
;
687 CurrentCol
= LocalScreen
.LeftColumn
+ 2;
689 CurrentRow
= BottomRowOfHotKeyHelp
- Index
/ 3;
691 // Print HotKey help string on bottom Row.
693 PrintStringAt (CurrentCol
, CurrentRow
, HotKey
->HelpString
);
698 Link
= GetNextNode (&gBrowserHotKeyList
, Link
);
706 Update key's help imformation.
708 @param Selection Tell setup browser the information about the Selection
709 @param MenuOption The Menu option
710 @param Selected Whether or not a tag be selected
715 IN UI_MENU_SELECTION
*Selection
,
716 IN UI_MENU_OPTION
*MenuOption
,
722 UINTN LeftColumnOfHelp
;
723 UINTN RightColumnOfHelp
;
725 UINTN BottomRowOfHelp
;
726 UINTN StartColumnOfHelp
;
727 EFI_SCREEN_DESCRIPTOR LocalScreen
;
728 FORM_BROWSER_STATEMENT
*Statement
;
730 gST
->ConOut
->SetAttribute (gST
->ConOut
, KEYHELP_TEXT
| KEYHELP_BACKGROUND
);
732 if (Selection
->Form
->ModalForm
) {
736 CopyMem (&LocalScreen
, &gScreenDimensions
, sizeof (EFI_SCREEN_DESCRIPTOR
));
738 SecCol
= LocalScreen
.LeftColumn
+ (LocalScreen
.RightColumn
- LocalScreen
.LeftColumn
) / 3;
739 ThdCol
= LocalScreen
.LeftColumn
+ (LocalScreen
.RightColumn
- LocalScreen
.LeftColumn
) / 3 * 2;
741 StartColumnOfHelp
= LocalScreen
.LeftColumn
+ 2;
742 LeftColumnOfHelp
= LocalScreen
.LeftColumn
+ 1;
743 RightColumnOfHelp
= LocalScreen
.RightColumn
- 2;
744 TopRowOfHelp
= LocalScreen
.BottomRow
- STATUS_BAR_HEIGHT
- gFooterHeight
+ 1;
745 BottomRowOfHelp
= LocalScreen
.BottomRow
- STATUS_BAR_HEIGHT
- 2;
747 Statement
= MenuOption
->ThisTag
;
748 switch (Statement
->Operand
) {
749 case EFI_IFR_ORDERED_LIST_OP
:
750 case EFI_IFR_ONE_OF_OP
:
751 case EFI_IFR_NUMERIC_OP
:
752 case EFI_IFR_TIME_OP
:
753 case EFI_IFR_DATE_OP
:
754 ClearLines (LeftColumnOfHelp
, RightColumnOfHelp
, TopRowOfHelp
, BottomRowOfHelp
, KEYHELP_TEXT
| KEYHELP_BACKGROUND
);
758 // On system setting, HotKey will show on every form.
760 if (gBrowserSettingScope
== SystemLevel
||
761 (Selection
->FormEditable
&& gFunctionKeySetting
!= NONE_FUNCTION_KEY_SETTING
)) {
762 PrintHotKeyHelpString ();
765 if ((gClassOfVfr
& FORMSET_CLASS_PLATFORM_SETUP
) == FORMSET_CLASS_PLATFORM_SETUP
) {
766 PrintStringAt (ThdCol
, BottomRowOfHelp
, gEscapeString
);
769 if ((Statement
->Operand
== EFI_IFR_DATE_OP
) ||
770 (Statement
->Operand
== EFI_IFR_TIME_OP
)) {
781 PrintStringAt (SecCol
, BottomRowOfHelp
, gEnterString
);
782 PrintStringAt (StartColumnOfHelp
, TopRowOfHelp
, gAdjustNumber
);
784 PrintAt (StartColumnOfHelp
, BottomRowOfHelp
, L
"%c%c%s", ARROW_UP
, ARROW_DOWN
, gMoveHighlight
);
785 if (Statement
->Operand
== EFI_IFR_NUMERIC_OP
&& Statement
->Step
!= 0) {
786 PrintStringAt (StartColumnOfHelp
, TopRowOfHelp
, gAdjustNumber
);
788 PrintStringAt (SecCol
, BottomRowOfHelp
, gEnterString
);
791 PrintStringAt (SecCol
, BottomRowOfHelp
, gEnterCommitString
);
794 // If it is a selected numeric with manual input, display different message
796 if ((Statement
->Operand
== EFI_IFR_NUMERIC_OP
) ||
797 (Statement
->Operand
== EFI_IFR_DATE_OP
) ||
798 (Statement
->Operand
== EFI_IFR_TIME_OP
)) {
802 ((Statement
->Flags
& EFI_IFR_DISPLAY_UINT_HEX
) == EFI_IFR_DISPLAY_UINT_HEX
) ? gHexNumericInput
: gDecNumericInput
804 } else if (Statement
->Operand
!= EFI_IFR_ORDERED_LIST_OP
) {
805 PrintAt (StartColumnOfHelp
, BottomRowOfHelp
, L
"%c%c%s", ARROW_UP
, ARROW_DOWN
, gMoveHighlight
);
808 if (Statement
->Operand
== EFI_IFR_ORDERED_LIST_OP
) {
809 PrintStringAt (StartColumnOfHelp
, TopRowOfHelp
, gPlusString
);
810 PrintStringAt (ThdCol
, TopRowOfHelp
, gMinusString
);
813 PrintStringAt (ThdCol
, BottomRowOfHelp
, gEnterEscapeString
);
817 case EFI_IFR_CHECKBOX_OP
:
818 ClearLines (LeftColumnOfHelp
, RightColumnOfHelp
, TopRowOfHelp
, BottomRowOfHelp
, KEYHELP_TEXT
| KEYHELP_BACKGROUND
);
821 // On system setting, HotKey will show on every form.
823 if (gBrowserSettingScope
== SystemLevel
||
824 (Selection
->FormEditable
&& gFunctionKeySetting
!= NONE_FUNCTION_KEY_SETTING
)) {
825 PrintHotKeyHelpString ();
827 if ((gClassOfVfr
& FORMSET_CLASS_PLATFORM_SETUP
) == FORMSET_CLASS_PLATFORM_SETUP
) {
828 PrintStringAt (ThdCol
, BottomRowOfHelp
, gEscapeString
);
831 PrintAt (StartColumnOfHelp
, BottomRowOfHelp
, L
"%c%c%s", ARROW_UP
, ARROW_DOWN
, gMoveHighlight
);
832 PrintStringAt (SecCol
, BottomRowOfHelp
, gToggleCheckBox
);
836 case EFI_IFR_PASSWORD_OP
:
837 case EFI_IFR_STRING_OP
:
838 case EFI_IFR_TEXT_OP
:
839 case EFI_IFR_ACTION_OP
:
840 case EFI_IFR_RESET_BUTTON_OP
:
841 case EFI_IFR_SUBTITLE_OP
:
842 ClearLines (LeftColumnOfHelp
, RightColumnOfHelp
, TopRowOfHelp
, BottomRowOfHelp
, KEYHELP_TEXT
| KEYHELP_BACKGROUND
);
846 // On system setting, HotKey will show on every form.
848 if (gBrowserSettingScope
== SystemLevel
||
849 (Selection
->FormEditable
&& gFunctionKeySetting
!= NONE_FUNCTION_KEY_SETTING
)) {
850 PrintHotKeyHelpString ();
852 if ((gClassOfVfr
& FORMSET_CLASS_PLATFORM_SETUP
) == FORMSET_CLASS_PLATFORM_SETUP
) {
853 PrintStringAt (ThdCol
, BottomRowOfHelp
, gEscapeString
);
856 PrintAt (StartColumnOfHelp
, BottomRowOfHelp
, L
"%c%c%s", ARROW_UP
, ARROW_DOWN
, gMoveHighlight
);
857 if (Statement
->Operand
!= EFI_IFR_TEXT_OP
&& Statement
->Operand
!= EFI_IFR_SUBTITLE_OP
) {
858 PrintStringAt (SecCol
, BottomRowOfHelp
, gEnterString
);
861 if (Statement
->Operand
!= EFI_IFR_REF_OP
) {
863 (LocalScreen
.RightColumn
- GetStringWidth (gEnterCommitString
) / 2) / 2,
867 PrintStringAt (ThdCol
, BottomRowOfHelp
, gEnterEscapeString
);
878 Functions which are registered to receive notification of
879 database events have this prototype. The actual event is encoded
880 in NotifyType. The following table describes how PackageType,
881 PackageGuid, Handle, and Package are used for each of the
884 @param PackageType Package type of the notification.
886 @param PackageGuid If PackageType is
887 EFI_HII_PACKAGE_TYPE_GUID, then this is
888 the pointer to the GUID from the Guid
889 field of EFI_HII_PACKAGE_GUID_HEADER.
890 Otherwise, it must be NULL.
892 @param Package Points to the package referred to by the
893 notification Handle The handle of the package
894 list which contains the specified package.
896 @param Handle The HII handle.
898 @param NotifyType The type of change concerning the
900 EFI_HII_DATABASE_NOTIFY_TYPE.
906 IN UINT8 PackageType
,
907 IN CONST EFI_GUID
*PackageGuid
,
908 IN CONST EFI_HII_PACKAGE_HEADER
*Package
,
909 IN EFI_HII_HANDLE Handle
,
910 IN EFI_HII_DATABASE_NOTIFY_TYPE NotifyType
913 mHiiPackageListUpdated
= TRUE
;
919 check whether the formset need to update the NV.
921 @param FormSet FormSet data structure.
923 @retval TRUE Need to update the NV.
924 @retval FALSE No need to update the NV.
928 IN FORM_BROWSER_FORMSET
*FormSet
932 FORM_BROWSER_FORM
*Form
;
934 Link
= GetFirstNode (&FormSet
->FormListHead
);
935 while (!IsNull (&FormSet
->FormListHead
, Link
)) {
936 Form
= FORM_BROWSER_FORM_FROM_LINK (Link
);
938 if (Form
->NvUpdateRequired
) {
942 Link
= GetNextNode (&FormSet
->FormListHead
, Link
);
949 check whether the formset need to update the NV.
951 @param FormSet FormSet data structure.
952 @param SetValue Whether set new value or clear old value.
957 IN FORM_BROWSER_FORMSET
*FormSet
,
962 FORM_BROWSER_FORM
*Form
;
964 Link
= GetFirstNode (&FormSet
->FormListHead
);
965 while (!IsNull (&FormSet
->FormListHead
, Link
)) {
966 Form
= FORM_BROWSER_FORM_FROM_LINK (Link
);
968 Form
->NvUpdateRequired
= SetValue
;
970 Link
= GetNextNode (&FormSet
->FormListHead
, Link
);
974 Find menu which will show next time.
976 @param Selection On input, Selection tell setup browser the information
977 about the Selection, form and formset to be displayed.
978 On output, Selection return the screen item that is selected
980 @param Repaint Whether need to repaint the menu.
981 @param NewLine Whether need to show at new line.
983 @retval TRUE Need return.
984 @retval FALSE No need to return.
988 IN OUT UI_MENU_SELECTION
*Selection
,
993 UI_MENU_LIST
*CurrentMenu
;
997 BROWSER_SETTING_SCOPE Scope
;
999 CurrentMenu
= Selection
->CurrentMenu
;
1001 if (CurrentMenu
!= NULL
&& CurrentMenu
->Parent
!= NULL
) {
1003 // we have a parent, so go to the parent menu
1005 if (CompareGuid (&CurrentMenu
->FormSetGuid
, &CurrentMenu
->Parent
->FormSetGuid
)) {
1007 // The parent menu and current menu are in the same formset
1009 Selection
->Action
= UI_ACTION_REFRESH_FORM
;
1012 Selection
->Action
= UI_ACTION_REFRESH_FORMSET
;
1013 CopyMem (&Selection
->FormSetGuid
, &CurrentMenu
->Parent
->FormSetGuid
, sizeof (EFI_GUID
));
1014 Selection
->Handle
= CurrentMenu
->Parent
->HiiHandle
;
1015 Scope
= FormSetLevel
;
1019 // Form Level Check whether the data is changed.
1021 if ((gBrowserSettingScope
== FormLevel
&& Selection
->Form
->NvUpdateRequired
) ||
1022 (gBrowserSettingScope
== FormSetLevel
&& IsNvUpdateRequired(Selection
->FormSet
) && Scope
== FormSetLevel
)) {
1023 gST
->ConIn
->ReadKeyStroke (gST
->ConIn
, &Key
);
1025 YesResponse
= gYesResponse
[0];
1026 NoResponse
= gNoResponse
[0];
1029 // If NV flag is up, prompt user
1032 CreateDialog (4, TRUE
, 0, NULL
, &Key
, gEmptyString
, gSaveChanges
, gAreYouSure
, gEmptyString
);
1035 (Key
.ScanCode
!= SCAN_ESC
) &&
1036 ((Key
.UnicodeChar
| UPPER_LOWER_CASE_OFFSET
) != (NoResponse
| UPPER_LOWER_CASE_OFFSET
)) &&
1037 ((Key
.UnicodeChar
| UPPER_LOWER_CASE_OFFSET
) != (YesResponse
| UPPER_LOWER_CASE_OFFSET
))
1040 if (Key
.ScanCode
== SCAN_ESC
) {
1042 // User hits the ESC key, Ingore.
1044 if (Repaint
!= NULL
) {
1047 if (NewLine
!= NULL
) {
1051 Selection
->Action
= UI_ACTION_NONE
;
1055 if ((Key
.UnicodeChar
| UPPER_LOWER_CASE_OFFSET
) == (YesResponse
| UPPER_LOWER_CASE_OFFSET
)) {
1057 // If the user hits the YesResponse key
1059 SubmitForm (Selection
->FormSet
, Selection
->Form
, Scope
);
1062 // If the user hits the NoResponse key
1064 DiscardForm (Selection
->FormSet
, Selection
->Form
, Scope
);
1068 Selection
->Statement
= NULL
;
1070 Selection
->FormId
= CurrentMenu
->Parent
->FormId
;
1071 Selection
->QuestionId
= CurrentMenu
->Parent
->QuestionId
;
1074 // Clear highlight record for this menu
1076 CurrentMenu
->QuestionId
= 0;
1080 if ((gClassOfVfr
& FORMSET_CLASS_FRONT_PAGE
) == FORMSET_CLASS_FRONT_PAGE
) {
1082 // We never exit FrontPage, so skip the ESC
1084 Selection
->Action
= UI_ACTION_NONE
;
1089 // We are going to leave current FormSet, so check uncommited data in this FormSet
1091 if (gBrowserSettingScope
!= SystemLevel
&& IsNvUpdateRequired(Selection
->FormSet
)) {
1092 gST
->ConIn
->ReadKeyStroke (gST
->ConIn
, &Key
);
1094 YesResponse
= gYesResponse
[0];
1095 NoResponse
= gNoResponse
[0];
1098 // If NV flag is up, prompt user
1101 CreateDialog (4, TRUE
, 0, NULL
, &Key
, gEmptyString
, gSaveChanges
, gAreYouSure
, gEmptyString
);
1104 (Key
.ScanCode
!= SCAN_ESC
) &&
1105 ((Key
.UnicodeChar
| UPPER_LOWER_CASE_OFFSET
) != (NoResponse
| UPPER_LOWER_CASE_OFFSET
)) &&
1106 ((Key
.UnicodeChar
| UPPER_LOWER_CASE_OFFSET
) != (YesResponse
| UPPER_LOWER_CASE_OFFSET
))
1109 if (Key
.ScanCode
== SCAN_ESC
) {
1111 // User hits the ESC key
1113 if (Repaint
!= NULL
) {
1117 if (NewLine
!= NULL
) {
1121 Selection
->Action
= UI_ACTION_NONE
;
1125 if ((Key
.UnicodeChar
| UPPER_LOWER_CASE_OFFSET
) == (YesResponse
| UPPER_LOWER_CASE_OFFSET
)) {
1127 // If the user hits the YesResponse key
1129 SubmitForm (Selection
->FormSet
, Selection
->Form
, FormSetLevel
);
1132 // If the user hits the NoResponse key
1134 DiscardForm (Selection
->FormSet
, Selection
->Form
, FormSetLevel
);
1138 Selection
->Statement
= NULL
;
1139 if (CurrentMenu
!= NULL
) {
1140 CurrentMenu
->QuestionId
= 0;
1143 Selection
->Action
= UI_ACTION_EXIT
;
1148 Call the call back function for the question and process the return action.
1150 @param Selection On input, Selection tell setup browser the information
1151 about the Selection, form and formset to be displayed.
1152 On output, Selection return the screen item that is selected
1154 @param Question The Question which need to call.
1155 @param Action The action request.
1156 @param SkipSaveOrDiscard Whether skip save or discard action.
1158 @retval EFI_SUCCESS The call back function excutes successfully.
1159 @return Other value if the call back function failed to excute.
1162 ProcessCallBackFunction (
1163 IN OUT UI_MENU_SELECTION
*Selection
,
1164 IN FORM_BROWSER_STATEMENT
*Question
,
1165 IN EFI_BROWSER_ACTION Action
,
1166 IN BOOLEAN SkipSaveOrDiscard
1170 EFI_BROWSER_ACTION_REQUEST ActionRequest
;
1171 EFI_HII_CONFIG_ACCESS_PROTOCOL
*ConfigAccess
;
1172 EFI_HII_VALUE
*HiiValue
;
1173 EFI_IFR_TYPE_VALUE
*TypeValue
;
1174 FORM_BROWSER_STATEMENT
*Statement
;
1175 BOOLEAN SubmitFormIsRequired
;
1176 BOOLEAN DiscardFormIsRequired
;
1179 BROWSER_SETTING_SCOPE SettingLevel
;
1181 ConfigAccess
= Selection
->FormSet
->ConfigAccess
;
1182 SubmitFormIsRequired
= FALSE
;
1183 SettingLevel
= FormSetLevel
;
1184 DiscardFormIsRequired
= FALSE
;
1186 Status
= EFI_SUCCESS
;
1187 ActionRequest
= EFI_BROWSER_ACTION_REQUEST_NONE
;
1189 if (ConfigAccess
== NULL
) {
1193 Link
= GetFirstNode (&Selection
->Form
->StatementListHead
);
1194 while (!IsNull (&Selection
->Form
->StatementListHead
, Link
)) {
1195 Statement
= FORM_BROWSER_STATEMENT_FROM_LINK (Link
);
1196 Link
= GetNextNode (&Selection
->Form
->StatementListHead
, Link
);
1199 // if Question != NULL, only process the question. Else, process all question in this form.
1201 if ((Question
!= NULL
) && (Statement
!= Question
)) {
1205 if ((Statement
->QuestionFlags
& EFI_IFR_FLAG_CALLBACK
) != EFI_IFR_FLAG_CALLBACK
) {
1210 // Check whether Statement is disabled.
1212 if (Statement
->Expression
!= NULL
) {
1213 if (EvaluateExpressionList(Statement
->Expression
, TRUE
, Selection
->FormSet
, Selection
->Form
) == ExpressDisable
) {
1218 HiiValue
= &Statement
->HiiValue
;
1219 TypeValue
= &HiiValue
->Value
;
1220 if (HiiValue
->Type
== EFI_IFR_TYPE_BUFFER
) {
1222 // For OrderedList, passing in the value buffer to Callback()
1224 TypeValue
= (EFI_IFR_TYPE_VALUE
*) Statement
->BufferValue
;
1227 ActionRequest
= EFI_BROWSER_ACTION_REQUEST_NONE
;
1228 Status
= ConfigAccess
->Callback (
1231 Statement
->QuestionId
,
1236 if (!EFI_ERROR (Status
)) {
1238 // Only for EFI_BROWSER_ACTION_CHANGED need to handle this ActionRequest.
1240 if (Action
== EFI_BROWSER_ACTION_CHANGED
) {
1241 switch (ActionRequest
) {
1242 case EFI_BROWSER_ACTION_REQUEST_RESET
:
1243 gResetRequired
= TRUE
;
1244 Selection
->Action
= UI_ACTION_EXIT
;
1247 case EFI_BROWSER_ACTION_REQUEST_SUBMIT
:
1248 SubmitFormIsRequired
= TRUE
;
1249 Selection
->Action
= UI_ACTION_EXIT
;
1252 case EFI_BROWSER_ACTION_REQUEST_EXIT
:
1253 Selection
->Action
= UI_ACTION_EXIT
;
1256 case EFI_BROWSER_ACTION_REQUEST_FORM_SUBMIT_EXIT
:
1257 SubmitFormIsRequired
= TRUE
;
1258 SettingLevel
= FormLevel
;
1262 case EFI_BROWSER_ACTION_REQUEST_FORM_DISCARD_EXIT
:
1263 DiscardFormIsRequired
= TRUE
;
1264 SettingLevel
= FormLevel
;
1268 case EFI_BROWSER_ACTION_REQUEST_FORM_APPLY
:
1269 SubmitFormIsRequired
= TRUE
;
1270 SettingLevel
= FormLevel
;
1273 case EFI_BROWSER_ACTION_REQUEST_FORM_DISCARD
:
1274 DiscardFormIsRequired
= TRUE
;
1275 SettingLevel
= FormLevel
;
1284 // According the spec, return value from call back of "changing" and
1285 // "retrieve" should update to the question's temp buffer.
1287 if (Action
== EFI_BROWSER_ACTION_CHANGING
|| Action
== EFI_BROWSER_ACTION_RETRIEVE
) {
1288 SetQuestionValue(Selection
->FormSet
, Selection
->Form
, Statement
, TRUE
);
1292 // According the spec, return fail from call back of "changing" and
1293 // "retrieve", should restore the question's value.
1295 if (Action
== EFI_BROWSER_ACTION_CHANGING
|| Action
== EFI_BROWSER_ACTION_RETRIEVE
) {
1296 GetQuestionValue(Selection
->FormSet
, Selection
->Form
, Statement
, TRUE
);
1299 if (Status
== EFI_UNSUPPORTED
) {
1301 // If return EFI_UNSUPPORTED, also consider Hii driver suceess deal with it.
1303 Status
= EFI_SUCCESS
;
1308 if (SubmitFormIsRequired
&& !SkipSaveOrDiscard
) {
1309 SubmitForm (Selection
->FormSet
, Selection
->Form
, SettingLevel
);
1312 if (DiscardFormIsRequired
&& !SkipSaveOrDiscard
) {
1313 DiscardForm (Selection
->FormSet
, Selection
->Form
, SettingLevel
);
1317 FindNextMenu (Selection
, NULL
, NULL
);
1324 The worker function that send the displays to the screen. On output,
1325 the selection made by user is returned.
1327 @param Selection On input, Selection tell setup browser the information
1328 about the Selection, form and formset to be displayed.
1329 On output, Selection return the screen item that is selected
1332 @retval EFI_SUCCESS The page is displayed successfully.
1333 @return Other value if the page failed to be diplayed.
1338 IN OUT UI_MENU_SELECTION
*Selection
1343 EFI_HANDLE NotifyHandle
;
1344 FORM_BROWSER_STATEMENT
*Statement
;
1345 EFI_HII_CONFIG_ACCESS_PROTOCOL
*ConfigAccess
;
1348 gMenuRefreshHead
= NULL
;
1349 ConfigAccess
= Selection
->FormSet
->ConfigAccess
;
1352 // Register notify for Form package update
1354 Status
= mHiiDatabase
->RegisterPackageNotify (
1356 EFI_HII_PACKAGE_FORMS
,
1359 EFI_HII_DATABASE_NOTIFY_REMOVE_PACK
,
1362 if (EFI_ERROR (Status
)) {
1367 // Initialize current settings of Questions in this FormSet
1369 Status
= InitializeCurrentSetting (Selection
->FormSet
);
1370 if (EFI_ERROR (Status
)) {
1375 // Update gOldFormSet on maintain back up FormSet list.
1376 // And, make gOldFormSet point to current FormSet.
1378 if (gOldFormSet
!= NULL
) {
1379 RemoveEntryList (&gOldFormSet
->Link
);
1380 DestroyFormSet (gOldFormSet
);
1382 gOldFormSet
= Selection
->FormSet
;
1383 InsertTailList (&gBrowserFormSetList
, &gOldFormSet
->Link
);
1387 // Initialize Selection->Form
1389 if (Selection
->FormId
== 0) {
1391 // Zero FormId indicates display the first Form in a FormSet
1393 Link
= GetFirstNode (&Selection
->FormSet
->FormListHead
);
1395 Selection
->Form
= FORM_BROWSER_FORM_FROM_LINK (Link
);
1396 Selection
->FormId
= Selection
->Form
->FormId
;
1398 Selection
->Form
= IdToForm (Selection
->FormSet
, Selection
->FormId
);
1401 if (Selection
->Form
== NULL
) {
1403 // No Form to display
1405 Status
= EFI_NOT_FOUND
;
1410 // Check Form is suppressed.
1412 if (Selection
->Form
->SuppressExpression
!= NULL
) {
1413 if (EvaluateExpressionList(Selection
->Form
->SuppressExpression
, TRUE
, Selection
->FormSet
, Selection
->Form
) == ExpressSuppress
) {
1415 // Form is suppressed.
1418 CreateDialog (4, TRUE
, 0, NULL
, &Key
, gEmptyString
, gFormSuppress
, gPressEnter
, gEmptyString
);
1419 } while (Key
.UnicodeChar
!= CHAR_CARRIAGE_RETURN
);
1421 Status
= EFI_NOT_FOUND
;
1427 // Reset FormPackage update flag
1429 mHiiPackageListUpdated
= FALSE
;
1432 // Before display new form, invoke ConfigAccess.Callback() with EFI_BROWSER_ACTION_FORM_OPEN
1433 // for each question with callback flag.
1434 // New form may be the first form, or the different form after another form close.
1436 if ((ConfigAccess
!= NULL
) &&
1437 ((Selection
->Handle
!= mCurrentHiiHandle
) ||
1438 (!CompareGuid (&Selection
->FormSetGuid
, &mCurrentFormSetGuid
)) ||
1439 (Selection
->FormId
!= mCurrentFormId
))) {
1442 // Keep current form information
1444 mCurrentHiiHandle
= Selection
->Handle
;
1445 CopyGuid (&mCurrentFormSetGuid
, &Selection
->FormSetGuid
);
1446 mCurrentFormId
= Selection
->FormId
;
1448 Status
= ProcessCallBackFunction (Selection
, NULL
, EFI_BROWSER_ACTION_FORM_OPEN
, FALSE
);
1449 if (EFI_ERROR (Status
)) {
1454 // EXIT requests to close form.
1456 if (Selection
->Action
== UI_ACTION_EXIT
) {
1460 // IFR is updated during callback of open form, force to reparse the IFR binary
1462 if (mHiiPackageListUpdated
) {
1463 Selection
->Action
= UI_ACTION_REFRESH_FORMSET
;
1464 mHiiPackageListUpdated
= FALSE
;
1470 // Load Questions' Value for display
1472 Status
= LoadFormSetConfig (Selection
, Selection
->FormSet
);
1473 if (EFI_ERROR (Status
)) {
1478 // EXIT requests to close form.
1480 if (Selection
->Action
== UI_ACTION_EXIT
) {
1484 // IFR is updated during callback of read value, force to reparse the IFR binary
1486 if (mHiiPackageListUpdated
) {
1487 Selection
->Action
= UI_ACTION_REFRESH_FORMSET
;
1488 mHiiPackageListUpdated
= FALSE
;
1493 // Displays the Header and Footer borders
1495 DisplayPageFrame (Selection
);
1500 Status
= DisplayForm (Selection
);
1501 if (EFI_ERROR (Status
)) {
1506 // Check Selected Statement (if press ESC, Selection->Statement will be NULL)
1508 Statement
= Selection
->Statement
;
1509 if (Statement
!= NULL
) {
1510 if ((Statement
->QuestionFlags
& EFI_IFR_FLAG_RESET_REQUIRED
) == EFI_IFR_FLAG_RESET_REQUIRED
) {
1511 gResetRequired
= TRUE
;
1515 // Reset FormPackage update flag
1517 mHiiPackageListUpdated
= FALSE
;
1519 if ((ConfigAccess
!= NULL
) &&
1520 ((Statement
->QuestionFlags
& EFI_IFR_FLAG_CALLBACK
) == EFI_IFR_FLAG_CALLBACK
) &&
1521 (Statement
->Operand
!= EFI_IFR_PASSWORD_OP
)) {
1522 Status
= ProcessCallBackFunction(Selection
, Statement
, EFI_BROWSER_ACTION_CHANGING
, FALSE
);
1523 if (Statement
->Operand
== EFI_IFR_REF_OP
&& Selection
->Action
!= UI_ACTION_EXIT
) {
1525 // Process dynamic update ref opcode.
1527 if (!EFI_ERROR (Status
)) {
1528 Status
= ProcessGotoOpCode(Statement
, Selection
, NULL
, NULL
);
1532 // Callback return error status or status return from process goto opcode.
1534 if (EFI_ERROR (Status
)) {
1536 // Cross reference will not be taken
1538 Selection
->FormId
= Selection
->Form
->FormId
;
1539 Selection
->QuestionId
= 0;
1543 if (!EFI_ERROR (Status
) && Statement
->Operand
!= EFI_IFR_REF_OP
) {
1544 ProcessCallBackFunction(Selection
, Statement
, EFI_BROWSER_ACTION_CHANGED
, FALSE
);
1549 // Check whether Form Package has been updated during Callback
1551 if (mHiiPackageListUpdated
&& (Selection
->Action
== UI_ACTION_REFRESH_FORM
)) {
1553 // Force to reparse IFR binary of target Formset
1555 mHiiPackageListUpdated
= FALSE
;
1556 Selection
->Action
= UI_ACTION_REFRESH_FORMSET
;
1561 // Before exit the form, invoke ConfigAccess.Callback() with EFI_BROWSER_ACTION_FORM_CLOSE
1562 // for each question with callback flag.
1564 if ((ConfigAccess
!= NULL
) &&
1565 ((Selection
->Action
== UI_ACTION_EXIT
) ||
1566 (Selection
->Handle
!= mCurrentHiiHandle
) ||
1567 (!CompareGuid (&Selection
->FormSetGuid
, &mCurrentFormSetGuid
)) ||
1568 (Selection
->FormId
!= mCurrentFormId
))) {
1570 Status
= ProcessCallBackFunction (Selection
, NULL
, EFI_BROWSER_ACTION_FORM_CLOSE
, FALSE
);
1571 if (EFI_ERROR (Status
)) {
1575 } while (Selection
->Action
== UI_ACTION_REFRESH_FORM
);
1579 // Reset current form information to the initial setting when error happens or form exit.
1581 if (EFI_ERROR (Status
) || Selection
->Action
== UI_ACTION_EXIT
) {
1582 mCurrentHiiHandle
= NULL
;
1583 CopyGuid (&mCurrentFormSetGuid
, &gZeroGuid
);
1588 // Unregister notify for Form package update
1590 mHiiDatabase
->UnregisterPackageNotify (