2 Utility functions for UI presentation.
4 Copyright (c) 2004 - 2011, 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
;
472 EFI_SCREEN_DESCRIPTOR LocalScreen
;
475 CHAR16
*OutputString
;
477 FORM_BROWSER_STATEMENT
*Statement
;
478 UINT16 NumberOfLines
;
480 UI_MENU_OPTION
*MenuOption
;
482 Handle
= Selection
->Handle
;
489 CopyMem (&LocalScreen
, &gScreenDimensions
, sizeof (EFI_SCREEN_DESCRIPTOR
));
491 StringPtr
= GetToken (Selection
->Form
->FormTitle
, Handle
);
493 if ((gClassOfVfr
& FORMSET_CLASS_FRONT_PAGE
) != FORMSET_CLASS_FRONT_PAGE
) {
494 if (Selection
->Form
->ModalForm
) {
495 gST
->ConOut
->SetAttribute (gST
->ConOut
, TITLE_TEXT
| EFI_BACKGROUND_BLACK
);
497 gST
->ConOut
->SetAttribute (gST
->ConOut
, TITLE_TEXT
| TITLE_BACKGROUND
);
500 (LocalScreen
.RightColumn
+ LocalScreen
.LeftColumn
- GetStringWidth (StringPtr
) / 2) / 2,
501 LocalScreen
.TopRow
+ 1,
507 // Remove Buffer allocated for StringPtr after it has been used.
509 FreePool (StringPtr
);
512 // Evaluate all the Expressions in this Form
514 Status
= EvaluateFormExpressions (Selection
->FormSet
, Selection
->Form
);
515 if (EFI_ERROR (Status
)) {
519 Selection
->FormEditable
= FALSE
;
520 Link
= GetFirstNode (&Selection
->Form
->StatementListHead
);
521 while (!IsNull (&Selection
->Form
->StatementListHead
, Link
)) {
522 Statement
= FORM_BROWSER_STATEMENT_FROM_LINK (Link
);
524 if (Statement
->SuppressExpression
!= NULL
) {
525 Suppress
= Statement
->SuppressExpression
->Result
.Value
.b
;
530 if (Statement
->DisableExpression
!= NULL
) {
531 Suppress
= (BOOLEAN
) (Suppress
|| Statement
->DisableExpression
->Result
.Value
.b
);
535 StringPtr
= GetToken (Statement
->Prompt
, Handle
);
537 Width
= GetWidth (Statement
, Handle
);
541 for (; GetLineByWidth (StringPtr
, Width
, &ArrayEntry
, &OutputString
) != 0x0000;) {
543 // If there is more string to process print on the next row and increment the Skip value
545 if (StrLen (&StringPtr
[ArrayEntry
]) != 0) {
549 FreePool (OutputString
);
553 // We are NOT!! removing this StringPtr buffer via FreePool since it is being used in the menuoptions, we will do
556 MenuOption
= UiAddMenuOption (StringPtr
, Selection
->Handle
, Statement
, NumberOfLines
, MenuItemCount
);
559 if (MenuOption
->IsQuestion
&& !MenuOption
->ReadOnly
) {
561 // At least one item is not readonly, this Form is considered as editable
563 Selection
->FormEditable
= TRUE
;
567 Link
= GetNextNode (&Selection
->Form
->StatementListHead
, Link
);
570 Status
= UiDisplayMenu (Selection
);
578 Initialize the HII String Token to the correct values.
582 InitializeBrowserStrings (
586 gEnterString
= GetToken (STRING_TOKEN (ENTER_STRING
), gHiiHandle
);
587 gEnterCommitString
= GetToken (STRING_TOKEN (ENTER_COMMIT_STRING
), gHiiHandle
);
588 gEnterEscapeString
= GetToken (STRING_TOKEN (ENTER_ESCAPE_STRING
), gHiiHandle
);
589 gEscapeString
= GetToken (STRING_TOKEN (ESCAPE_STRING
), gHiiHandle
);
590 gMoveHighlight
= GetToken (STRING_TOKEN (MOVE_HIGHLIGHT
), gHiiHandle
);
591 gMakeSelection
= GetToken (STRING_TOKEN (MAKE_SELECTION
), gHiiHandle
);
592 gDecNumericInput
= GetToken (STRING_TOKEN (DEC_NUMERIC_INPUT
), gHiiHandle
);
593 gHexNumericInput
= GetToken (STRING_TOKEN (HEX_NUMERIC_INPUT
), gHiiHandle
);
594 gToggleCheckBox
= GetToken (STRING_TOKEN (TOGGLE_CHECK_BOX
), gHiiHandle
);
595 gPromptForData
= GetToken (STRING_TOKEN (PROMPT_FOR_DATA
), gHiiHandle
);
596 gPromptForPassword
= GetToken (STRING_TOKEN (PROMPT_FOR_PASSWORD
), gHiiHandle
);
597 gPromptForNewPassword
= GetToken (STRING_TOKEN (PROMPT_FOR_NEW_PASSWORD
), gHiiHandle
);
598 gConfirmPassword
= GetToken (STRING_TOKEN (CONFIRM_PASSWORD
), gHiiHandle
);
599 gConfirmError
= GetToken (STRING_TOKEN (CONFIRM_ERROR
), gHiiHandle
);
600 gPassowordInvalid
= GetToken (STRING_TOKEN (PASSWORD_INVALID
), gHiiHandle
);
601 gPressEnter
= GetToken (STRING_TOKEN (PRESS_ENTER
), gHiiHandle
);
602 gEmptyString
= GetToken (STRING_TOKEN (EMPTY_STRING
), gHiiHandle
);
603 gAreYouSure
= GetToken (STRING_TOKEN (ARE_YOU_SURE
), gHiiHandle
);
604 gYesResponse
= GetToken (STRING_TOKEN (ARE_YOU_SURE_YES
), gHiiHandle
);
605 gNoResponse
= GetToken (STRING_TOKEN (ARE_YOU_SURE_NO
), gHiiHandle
);
606 gMiniString
= GetToken (STRING_TOKEN (MINI_STRING
), gHiiHandle
);
607 gPlusString
= GetToken (STRING_TOKEN (PLUS_STRING
), gHiiHandle
);
608 gMinusString
= GetToken (STRING_TOKEN (MINUS_STRING
), gHiiHandle
);
609 gAdjustNumber
= GetToken (STRING_TOKEN (ADJUST_NUMBER
), gHiiHandle
);
610 gSaveChanges
= GetToken (STRING_TOKEN (SAVE_CHANGES
), gHiiHandle
);
611 gOptionMismatch
= GetToken (STRING_TOKEN (OPTION_MISMATCH
), gHiiHandle
);
612 gFormSuppress
= GetToken (STRING_TOKEN (FORM_SUPPRESSED
), gHiiHandle
);
617 Free up the resource allocated for all strings required
626 FreePool (gEnterString
);
627 FreePool (gEnterCommitString
);
628 FreePool (gEnterEscapeString
);
629 FreePool (gEscapeString
);
630 FreePool (gMoveHighlight
);
631 FreePool (gMakeSelection
);
632 FreePool (gDecNumericInput
);
633 FreePool (gHexNumericInput
);
634 FreePool (gToggleCheckBox
);
635 FreePool (gPromptForData
);
636 FreePool (gPromptForPassword
);
637 FreePool (gPromptForNewPassword
);
638 FreePool (gConfirmPassword
);
639 FreePool (gPassowordInvalid
);
640 FreePool (gConfirmError
);
641 FreePool (gPressEnter
);
642 FreePool (gEmptyString
);
643 FreePool (gAreYouSure
);
644 FreePool (gYesResponse
);
645 FreePool (gNoResponse
);
646 FreePool (gMiniString
);
647 FreePool (gPlusString
);
648 FreePool (gMinusString
);
649 FreePool (gAdjustNumber
);
650 FreePool (gSaveChanges
);
651 FreePool (gOptionMismatch
);
652 FreePool (gFormSuppress
);
657 Show all registered HotKey help strings on bottom Rows.
661 PrintHotKeyHelpString (
667 UINTN BottomRowOfHotKeyHelp
;
670 EFI_SCREEN_DESCRIPTOR LocalScreen
;
672 BROWSER_HOT_KEY
*HotKey
;
674 CopyMem (&LocalScreen
, &gScreenDimensions
, sizeof (EFI_SCREEN_DESCRIPTOR
));
675 ColumnWidth
= (LocalScreen
.RightColumn
- LocalScreen
.LeftColumn
) / 3;
676 BottomRowOfHotKeyHelp
= LocalScreen
.BottomRow
- STATUS_BAR_HEIGHT
- 3;
679 // Calculate total number of Register HotKeys.
682 Link
= GetFirstNode (&gBrowserHotKeyList
);
683 while (!IsNull (&gBrowserHotKeyList
, Link
)) {
684 HotKey
= BROWSER_HOT_KEY_FROM_LINK (Link
);
686 // Help string can't exceed ColumnWidth. One Row will show three Help information.
688 if (StrLen (HotKey
->HelpString
) > ColumnWidth
) {
689 HotKey
->HelpString
[ColumnWidth
] = L
'\0';
692 // Calculate help information Column and Row.
694 if ((Index
% 3) != 2) {
695 CurrentCol
= LocalScreen
.LeftColumn
+ (2 - Index
% 3) * ColumnWidth
;
697 CurrentCol
= LocalScreen
.LeftColumn
+ 2;
699 CurrentRow
= BottomRowOfHotKeyHelp
- Index
/ 3;
701 // Print HotKey help string on bottom Row.
703 PrintStringAt (CurrentCol
, CurrentRow
, HotKey
->HelpString
);
708 Link
= GetNextNode (&gBrowserHotKeyList
, Link
);
716 Update key's help imformation.
718 @param Selection Tell setup browser the information about the Selection
719 @param MenuOption The Menu option
720 @param Selected Whether or not a tag be selected
725 IN UI_MENU_SELECTION
*Selection
,
726 IN UI_MENU_OPTION
*MenuOption
,
732 UINTN LeftColumnOfHelp
;
733 UINTN RightColumnOfHelp
;
735 UINTN BottomRowOfHelp
;
736 UINTN StartColumnOfHelp
;
737 EFI_SCREEN_DESCRIPTOR LocalScreen
;
738 FORM_BROWSER_STATEMENT
*Statement
;
740 gST
->ConOut
->SetAttribute (gST
->ConOut
, KEYHELP_TEXT
| KEYHELP_BACKGROUND
);
742 if (Selection
->Form
->ModalForm
) {
746 CopyMem (&LocalScreen
, &gScreenDimensions
, sizeof (EFI_SCREEN_DESCRIPTOR
));
748 SecCol
= LocalScreen
.LeftColumn
+ (LocalScreen
.RightColumn
- LocalScreen
.LeftColumn
) / 3;
749 ThdCol
= LocalScreen
.LeftColumn
+ (LocalScreen
.RightColumn
- LocalScreen
.LeftColumn
) / 3 * 2;
751 StartColumnOfHelp
= LocalScreen
.LeftColumn
+ 2;
752 LeftColumnOfHelp
= LocalScreen
.LeftColumn
+ 1;
753 RightColumnOfHelp
= LocalScreen
.RightColumn
- 2;
754 TopRowOfHelp
= LocalScreen
.BottomRow
- STATUS_BAR_HEIGHT
- gFooterHeight
+ 1;
755 BottomRowOfHelp
= LocalScreen
.BottomRow
- STATUS_BAR_HEIGHT
- 2;
757 Statement
= MenuOption
->ThisTag
;
758 switch (Statement
->Operand
) {
759 case EFI_IFR_ORDERED_LIST_OP
:
760 case EFI_IFR_ONE_OF_OP
:
761 case EFI_IFR_NUMERIC_OP
:
762 case EFI_IFR_TIME_OP
:
763 case EFI_IFR_DATE_OP
:
764 ClearLines (LeftColumnOfHelp
, RightColumnOfHelp
, TopRowOfHelp
, BottomRowOfHelp
, KEYHELP_TEXT
| KEYHELP_BACKGROUND
);
768 // On system setting, HotKey will show on every form.
770 if (gBrowserSettingScope
== SystemLevel
||
771 (Selection
->FormEditable
&& gFunctionKeySetting
!= NONE_FUNCTION_KEY_SETTING
)) {
772 PrintHotKeyHelpString ();
775 if ((gClassOfVfr
& FORMSET_CLASS_PLATFORM_SETUP
) == FORMSET_CLASS_PLATFORM_SETUP
) {
776 PrintStringAt (ThdCol
, BottomRowOfHelp
, gEscapeString
);
779 if ((Statement
->Operand
== EFI_IFR_DATE_OP
) ||
780 (Statement
->Operand
== EFI_IFR_TIME_OP
)) {
791 PrintStringAt (SecCol
, BottomRowOfHelp
, gEnterString
);
792 PrintStringAt (StartColumnOfHelp
, TopRowOfHelp
, gAdjustNumber
);
794 PrintAt (StartColumnOfHelp
, BottomRowOfHelp
, L
"%c%c%s", ARROW_UP
, ARROW_DOWN
, gMoveHighlight
);
795 if (Statement
->Operand
== EFI_IFR_NUMERIC_OP
&& Statement
->Step
!= 0) {
796 PrintStringAt (StartColumnOfHelp
, TopRowOfHelp
, gAdjustNumber
);
798 PrintStringAt (SecCol
, BottomRowOfHelp
, gEnterString
);
801 PrintStringAt (SecCol
, BottomRowOfHelp
, gEnterCommitString
);
804 // If it is a selected numeric with manual input, display different message
806 if ((Statement
->Operand
== EFI_IFR_NUMERIC_OP
) ||
807 (Statement
->Operand
== EFI_IFR_DATE_OP
) ||
808 (Statement
->Operand
== EFI_IFR_TIME_OP
)) {
812 ((Statement
->Flags
& EFI_IFR_DISPLAY_UINT_HEX
) == EFI_IFR_DISPLAY_UINT_HEX
) ? gHexNumericInput
: gDecNumericInput
814 } else if (Statement
->Operand
!= EFI_IFR_ORDERED_LIST_OP
) {
815 PrintAt (StartColumnOfHelp
, BottomRowOfHelp
, L
"%c%c%s", ARROW_UP
, ARROW_DOWN
, gMoveHighlight
);
818 if (Statement
->Operand
== EFI_IFR_ORDERED_LIST_OP
) {
819 PrintStringAt (StartColumnOfHelp
, TopRowOfHelp
, gPlusString
);
820 PrintStringAt (ThdCol
, TopRowOfHelp
, gMinusString
);
823 PrintStringAt (ThdCol
, BottomRowOfHelp
, gEnterEscapeString
);
827 case EFI_IFR_CHECKBOX_OP
:
828 ClearLines (LeftColumnOfHelp
, RightColumnOfHelp
, TopRowOfHelp
, BottomRowOfHelp
, KEYHELP_TEXT
| KEYHELP_BACKGROUND
);
831 // On system setting, HotKey will show on every form.
833 if (gBrowserSettingScope
== SystemLevel
||
834 (Selection
->FormEditable
&& gFunctionKeySetting
!= NONE_FUNCTION_KEY_SETTING
)) {
835 PrintHotKeyHelpString ();
837 if ((gClassOfVfr
& FORMSET_CLASS_PLATFORM_SETUP
) == FORMSET_CLASS_PLATFORM_SETUP
) {
838 PrintStringAt (ThdCol
, BottomRowOfHelp
, gEscapeString
);
841 PrintAt (StartColumnOfHelp
, BottomRowOfHelp
, L
"%c%c%s", ARROW_UP
, ARROW_DOWN
, gMoveHighlight
);
842 PrintStringAt (SecCol
, BottomRowOfHelp
, gToggleCheckBox
);
846 case EFI_IFR_PASSWORD_OP
:
847 case EFI_IFR_STRING_OP
:
848 case EFI_IFR_TEXT_OP
:
849 case EFI_IFR_ACTION_OP
:
850 case EFI_IFR_RESET_BUTTON_OP
:
851 case EFI_IFR_SUBTITLE_OP
:
852 ClearLines (LeftColumnOfHelp
, RightColumnOfHelp
, TopRowOfHelp
, BottomRowOfHelp
, KEYHELP_TEXT
| KEYHELP_BACKGROUND
);
856 // On system setting, HotKey will show on every form.
858 if (gBrowserSettingScope
== SystemLevel
||
859 (Selection
->FormEditable
&& gFunctionKeySetting
!= NONE_FUNCTION_KEY_SETTING
)) {
860 PrintHotKeyHelpString ();
862 if ((gClassOfVfr
& FORMSET_CLASS_PLATFORM_SETUP
) == FORMSET_CLASS_PLATFORM_SETUP
) {
863 PrintStringAt (ThdCol
, BottomRowOfHelp
, gEscapeString
);
866 PrintAt (StartColumnOfHelp
, BottomRowOfHelp
, L
"%c%c%s", ARROW_UP
, ARROW_DOWN
, gMoveHighlight
);
867 if (Statement
->Operand
!= EFI_IFR_TEXT_OP
&& Statement
->Operand
!= EFI_IFR_SUBTITLE_OP
) {
868 PrintStringAt (SecCol
, BottomRowOfHelp
, gEnterString
);
871 if (Statement
->Operand
!= EFI_IFR_REF_OP
) {
873 (LocalScreen
.RightColumn
- GetStringWidth (gEnterCommitString
) / 2) / 2,
877 PrintStringAt (ThdCol
, BottomRowOfHelp
, gEnterEscapeString
);
888 Functions which are registered to receive notification of
889 database events have this prototype. The actual event is encoded
890 in NotifyType. The following table describes how PackageType,
891 PackageGuid, Handle, and Package are used for each of the
894 @param PackageType Package type of the notification.
896 @param PackageGuid If PackageType is
897 EFI_HII_PACKAGE_TYPE_GUID, then this is
898 the pointer to the GUID from the Guid
899 field of EFI_HII_PACKAGE_GUID_HEADER.
900 Otherwise, it must be NULL.
902 @param Package Points to the package referred to by the
903 notification Handle The handle of the package
904 list which contains the specified package.
906 @param Handle The HII handle.
908 @param NotifyType The type of change concerning the
910 EFI_HII_DATABASE_NOTIFY_TYPE.
916 IN UINT8 PackageType
,
917 IN CONST EFI_GUID
*PackageGuid
,
918 IN CONST EFI_HII_PACKAGE_HEADER
*Package
,
919 IN EFI_HII_HANDLE Handle
,
920 IN EFI_HII_DATABASE_NOTIFY_TYPE NotifyType
923 mHiiPackageListUpdated
= TRUE
;
929 check whether the formset need to update the NV.
931 @param FormSet FormSet data structure.
933 @retval TRUE Need to update the NV.
934 @retval FALSE No need to update the NV.
938 IN FORM_BROWSER_FORMSET
*FormSet
942 FORM_BROWSER_FORM
*Form
;
944 Link
= GetFirstNode (&FormSet
->FormListHead
);
945 while (!IsNull (&FormSet
->FormListHead
, Link
)) {
946 Form
= FORM_BROWSER_FORM_FROM_LINK (Link
);
948 if (Form
->NvUpdateRequired
) {
952 Link
= GetNextNode (&FormSet
->FormListHead
, Link
);
959 check whether the formset need to update the NV.
961 @param FormSet FormSet data structure.
962 @param SetValue Whether set new value or clear old value.
967 IN FORM_BROWSER_FORMSET
*FormSet
,
972 FORM_BROWSER_FORM
*Form
;
974 Link
= GetFirstNode (&FormSet
->FormListHead
);
975 while (!IsNull (&FormSet
->FormListHead
, Link
)) {
976 Form
= FORM_BROWSER_FORM_FROM_LINK (Link
);
978 Form
->NvUpdateRequired
= SetValue
;
980 Link
= GetNextNode (&FormSet
->FormListHead
, Link
);
984 Find menu which will show next time.
986 @param Selection On input, Selection tell setup browser the information
987 about the Selection, form and formset to be displayed.
988 On output, Selection return the screen item that is selected
990 @param Repaint Whether need to repaint the menu.
991 @param NewLine Whether need to show at new line.
993 @retval TRUE Need return.
994 @retval FALSE No need to return.
998 IN OUT UI_MENU_SELECTION
*Selection
,
1003 UI_MENU_LIST
*CurrentMenu
;
1009 CurrentMenu
= Selection
->CurrentMenu
;
1011 if (CurrentMenu
!= NULL
&& CurrentMenu
->Parent
!= NULL
) {
1013 // Form Level Check whether the data is changed.
1015 if (gBrowserSettingScope
== FormLevel
&& Selection
->Form
->NvUpdateRequired
) {
1016 Status
= gST
->ConIn
->ReadKeyStroke (gST
->ConIn
, &Key
);
1018 YesResponse
= gYesResponse
[0];
1019 NoResponse
= gNoResponse
[0];
1022 // If NV flag is up, prompt user
1025 CreateDialog (4, TRUE
, 0, NULL
, &Key
, gEmptyString
, gSaveChanges
, gAreYouSure
, gEmptyString
);
1028 (Key
.ScanCode
!= SCAN_ESC
) &&
1029 ((Key
.UnicodeChar
| UPPER_LOWER_CASE_OFFSET
) != (NoResponse
| UPPER_LOWER_CASE_OFFSET
)) &&
1030 ((Key
.UnicodeChar
| UPPER_LOWER_CASE_OFFSET
) != (YesResponse
| UPPER_LOWER_CASE_OFFSET
))
1033 if (Key
.ScanCode
== SCAN_ESC
) {
1035 // User hits the ESC key, Ingore.
1037 if (Repaint
!= NULL
) {
1040 if (NewLine
!= NULL
) {
1044 Selection
->Action
= UI_ACTION_NONE
;
1048 if ((Key
.UnicodeChar
| UPPER_LOWER_CASE_OFFSET
) == (YesResponse
| UPPER_LOWER_CASE_OFFSET
)) {
1050 // If the user hits the YesResponse key
1052 Status
= SubmitForm (Selection
->FormSet
, Selection
->Form
, FormLevel
);
1055 // If the user hits the NoResponse key
1057 Status
= DiscardForm (Selection
->FormSet
, Selection
->Form
, FormLevel
);
1062 // we have a parent, so go to the parent menu
1064 if (CompareGuid (&CurrentMenu
->FormSetGuid
, &CurrentMenu
->Parent
->FormSetGuid
)) {
1066 // The parent menu and current menu are in the same formset
1068 Selection
->Action
= UI_ACTION_REFRESH_FORM
;
1070 Selection
->Action
= UI_ACTION_REFRESH_FORMSET
;
1072 Selection
->Statement
= NULL
;
1074 Selection
->FormId
= CurrentMenu
->Parent
->FormId
;
1075 Selection
->QuestionId
= CurrentMenu
->Parent
->QuestionId
;
1078 // Clear highlight record for this menu
1080 CurrentMenu
->QuestionId
= 0;
1084 if ((gClassOfVfr
& FORMSET_CLASS_FRONT_PAGE
) == FORMSET_CLASS_FRONT_PAGE
) {
1086 // We never exit FrontPage, so skip the ESC
1088 Selection
->Action
= UI_ACTION_NONE
;
1093 // We are going to leave current FormSet, so check uncommited data in this FormSet
1095 if (gBrowserSettingScope
!= SystemLevel
&& IsNvUpdateRequired(Selection
->FormSet
)) {
1096 Status
= gST
->ConIn
->ReadKeyStroke (gST
->ConIn
, &Key
);
1098 YesResponse
= gYesResponse
[0];
1099 NoResponse
= gNoResponse
[0];
1102 // If NV flag is up, prompt user
1105 CreateDialog (4, TRUE
, 0, NULL
, &Key
, gEmptyString
, gSaveChanges
, gAreYouSure
, gEmptyString
);
1108 (Key
.ScanCode
!= SCAN_ESC
) &&
1109 ((Key
.UnicodeChar
| UPPER_LOWER_CASE_OFFSET
) != (NoResponse
| UPPER_LOWER_CASE_OFFSET
)) &&
1110 ((Key
.UnicodeChar
| UPPER_LOWER_CASE_OFFSET
) != (YesResponse
| UPPER_LOWER_CASE_OFFSET
))
1113 if (Key
.ScanCode
== SCAN_ESC
) {
1115 // User hits the ESC key
1117 if (Repaint
!= NULL
) {
1121 if (NewLine
!= NULL
) {
1125 Selection
->Action
= UI_ACTION_NONE
;
1129 if ((Key
.UnicodeChar
| UPPER_LOWER_CASE_OFFSET
) == (YesResponse
| UPPER_LOWER_CASE_OFFSET
)) {
1131 // If the user hits the YesResponse key
1133 Status
= SubmitForm (Selection
->FormSet
, Selection
->Form
, FormSetLevel
);
1136 // If the user hits the NoResponse key
1138 Status
= DiscardForm (Selection
->FormSet
, Selection
->Form
, FormSetLevel
);
1142 Selection
->Statement
= NULL
;
1143 if (CurrentMenu
!= NULL
) {
1144 CurrentMenu
->QuestionId
= 0;
1147 Selection
->Action
= UI_ACTION_EXIT
;
1152 Call the call back function for the question and process the return action.
1154 @param Selection On input, Selection tell setup browser the information
1155 about the Selection, form and formset to be displayed.
1156 On output, Selection return the screen item that is selected
1158 @param Question The Question which need to call.
1159 @param Action The action request.
1160 @param SkipSaveOrDiscard Whether skip save or discard action.
1162 @retval EFI_SUCCESS The call back function excutes successfully.
1163 @return Other value if the call back function failed to excute.
1166 ProcessCallBackFunction (
1167 IN OUT UI_MENU_SELECTION
*Selection
,
1168 IN FORM_BROWSER_STATEMENT
*Question
,
1169 IN EFI_BROWSER_ACTION Action
,
1170 IN BOOLEAN SkipSaveOrDiscard
1174 EFI_BROWSER_ACTION_REQUEST ActionRequest
;
1175 EFI_HII_CONFIG_ACCESS_PROTOCOL
*ConfigAccess
;
1176 EFI_HII_VALUE
*HiiValue
;
1177 EFI_IFR_TYPE_VALUE
*TypeValue
;
1178 FORM_BROWSER_STATEMENT
*Statement
;
1179 BOOLEAN SubmitFormIsRequired
;
1180 BOOLEAN DiscardFormIsRequired
;
1183 BROWSER_SETTING_SCOPE SettingLevel
;
1185 ConfigAccess
= Selection
->FormSet
->ConfigAccess
;
1186 SubmitFormIsRequired
= FALSE
;
1187 SettingLevel
= FormSetLevel
;
1188 DiscardFormIsRequired
= FALSE
;
1190 Status
= EFI_SUCCESS
;
1191 ActionRequest
= EFI_BROWSER_ACTION_REQUEST_NONE
;
1193 if (ConfigAccess
== NULL
) {
1197 Link
= GetFirstNode (&Selection
->Form
->StatementListHead
);
1198 while (!IsNull (&Selection
->Form
->StatementListHead
, Link
)) {
1199 Statement
= FORM_BROWSER_STATEMENT_FROM_LINK (Link
);
1200 Link
= GetNextNode (&Selection
->Form
->StatementListHead
, Link
);
1203 // if Question != NULL, only process the question. Else, process all question in this form.
1205 if ((Question
!= NULL
) && (Statement
!= Question
)) {
1209 if ((Statement
->QuestionFlags
& EFI_IFR_FLAG_CALLBACK
) != EFI_IFR_FLAG_CALLBACK
) {
1214 // Check whether Statement is disabled.
1216 if (Statement
->DisableExpression
!= NULL
) {
1217 Status
= EvaluateExpression (Selection
->FormSet
, Selection
->Form
, Statement
->DisableExpression
);
1218 if (!EFI_ERROR (Status
) &&
1219 (Statement
->DisableExpression
->Result
.Type
== EFI_IFR_TYPE_BOOLEAN
) &&
1220 (Statement
->DisableExpression
->Result
.Value
.b
)) {
1225 HiiValue
= &Statement
->HiiValue
;
1226 TypeValue
= &HiiValue
->Value
;
1227 if (HiiValue
->Type
== EFI_IFR_TYPE_BUFFER
) {
1229 // For OrderedList, passing in the value buffer to Callback()
1231 TypeValue
= (EFI_IFR_TYPE_VALUE
*) Statement
->BufferValue
;
1234 ActionRequest
= EFI_BROWSER_ACTION_REQUEST_NONE
;
1235 Status
= ConfigAccess
->Callback (
1238 Statement
->QuestionId
,
1243 if (!EFI_ERROR (Status
)) {
1244 switch (ActionRequest
) {
1245 case EFI_BROWSER_ACTION_REQUEST_RESET
:
1246 gResetRequired
= TRUE
;
1249 case EFI_BROWSER_ACTION_REQUEST_SUBMIT
:
1250 SubmitFormIsRequired
= TRUE
;
1253 case EFI_BROWSER_ACTION_REQUEST_EXIT
:
1254 Selection
->Action
= UI_ACTION_EXIT
;
1257 case EFI_BROWSER_ACTION_REQUEST_FORM_SUBMIT_EXIT
:
1258 SubmitFormIsRequired
= TRUE
;
1259 SettingLevel
= FormLevel
;
1263 case EFI_BROWSER_ACTION_REQUEST_FORM_DISCARD_EXIT
:
1264 DiscardFormIsRequired
= TRUE
;
1265 SettingLevel
= FormLevel
;
1269 case EFI_BROWSER_ACTION_REQUEST_FORM_APPLY
:
1270 SubmitFormIsRequired
= TRUE
;
1271 SettingLevel
= FormLevel
;
1274 case EFI_BROWSER_ACTION_REQUEST_FORM_DISCARD
:
1275 DiscardFormIsRequired
= TRUE
;
1276 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
);
1290 } else if (Status
== EFI_UNSUPPORTED
) {
1292 // If return EFI_UNSUPPORTED, also consider Hii driver suceess deal with it.
1294 Status
= EFI_SUCCESS
;
1298 if (SubmitFormIsRequired
&& !SkipSaveOrDiscard
) {
1299 SubmitForm (Selection
->FormSet
, Selection
->Form
, SettingLevel
);
1302 if (DiscardFormIsRequired
&& !SkipSaveOrDiscard
) {
1303 DiscardForm (Selection
->FormSet
, Selection
->Form
, SettingLevel
);
1307 FindNextMenu (Selection
, NULL
, NULL
);
1314 The worker function that send the displays to the screen. On output,
1315 the selection made by user is returned.
1317 @param Selection On input, Selection tell setup browser the information
1318 about the Selection, form and formset to be displayed.
1319 On output, Selection return the screen item that is selected
1322 @retval EFI_SUCCESS The page is displayed successfully.
1323 @return Other value if the page failed to be diplayed.
1328 IN OUT UI_MENU_SELECTION
*Selection
1333 EFI_HANDLE NotifyHandle
;
1334 FORM_BROWSER_STATEMENT
*Statement
;
1335 EFI_HII_CONFIG_ACCESS_PROTOCOL
*ConfigAccess
;
1338 gMenuRefreshHead
= NULL
;
1339 ConfigAccess
= Selection
->FormSet
->ConfigAccess
;
1342 // Register notify for Form package update
1344 Status
= mHiiDatabase
->RegisterPackageNotify (
1346 EFI_HII_PACKAGE_FORMS
,
1349 EFI_HII_DATABASE_NOTIFY_REMOVE_PACK
,
1352 if (EFI_ERROR (Status
)) {
1357 // Initialize current settings of Questions in this FormSet
1359 Status
= InitializeCurrentSetting (Selection
->FormSet
);
1360 if (EFI_ERROR (Status
)) {
1365 // Update gOldFormSet on maintain back up FormSet list.
1366 // And, make gOldFormSet point to current FormSet.
1368 if (gOldFormSet
!= NULL
) {
1369 RemoveEntryList (&gOldFormSet
->Link
);
1370 DestroyFormSet (gOldFormSet
);
1372 gOldFormSet
= Selection
->FormSet
;
1373 InsertTailList (&gBrowserFormSetList
, &gOldFormSet
->Link
);
1377 // Initialize Selection->Form
1379 if (Selection
->FormId
== 0) {
1381 // Zero FormId indicates display the first Form in a FormSet
1383 Link
= GetFirstNode (&Selection
->FormSet
->FormListHead
);
1385 Selection
->Form
= FORM_BROWSER_FORM_FROM_LINK (Link
);
1386 Selection
->FormId
= Selection
->Form
->FormId
;
1388 Selection
->Form
= IdToForm (Selection
->FormSet
, Selection
->FormId
);
1391 if (Selection
->Form
== NULL
) {
1393 // No Form to display
1395 Status
= EFI_NOT_FOUND
;
1400 // Check Form is suppressed.
1402 if (Selection
->Form
->SuppressExpression
!= NULL
) {
1403 Status
= EvaluateExpression (Selection
->FormSet
, Selection
->Form
, Selection
->Form
->SuppressExpression
);
1404 if (EFI_ERROR (Status
) || (Selection
->Form
->SuppressExpression
->Result
.Type
!= EFI_IFR_TYPE_BOOLEAN
)) {
1405 Status
= EFI_INVALID_PARAMETER
;
1409 if (Selection
->Form
->SuppressExpression
->Result
.Value
.b
) {
1411 // Form is suppressed.
1414 CreateDialog (4, TRUE
, 0, NULL
, &Key
, gEmptyString
, gFormSuppress
, gPressEnter
, gEmptyString
);
1415 } while (Key
.UnicodeChar
!= CHAR_CARRIAGE_RETURN
);
1417 Status
= EFI_NOT_FOUND
;
1423 // Reset FormPackage update flag
1425 mHiiPackageListUpdated
= FALSE
;
1428 // Before display new form, invoke ConfigAccess.Callback() with EFI_BROWSER_ACTION_FORM_OPEN
1429 // for each question with callback flag.
1430 // New form may be the first form, or the different form after another form close.
1432 if ((ConfigAccess
!= NULL
) &&
1433 ((Selection
->Handle
!= mCurrentHiiHandle
) ||
1434 (!CompareGuid (&Selection
->FormSetGuid
, &mCurrentFormSetGuid
)) ||
1435 (Selection
->FormId
!= mCurrentFormId
))) {
1438 // Keep current form information
1440 mCurrentHiiHandle
= Selection
->Handle
;
1441 CopyGuid (&mCurrentFormSetGuid
, &Selection
->FormSetGuid
);
1442 mCurrentFormId
= Selection
->FormId
;
1444 Status
= ProcessCallBackFunction (Selection
, NULL
, EFI_BROWSER_ACTION_FORM_OPEN
, FALSE
);
1445 if (EFI_ERROR (Status
)) {
1450 // EXIT requests to close form.
1452 if (Selection
->Action
== UI_ACTION_EXIT
) {
1456 // IFR is updated during callback of open form, force to reparse the IFR binary
1458 if (mHiiPackageListUpdated
) {
1459 Selection
->Action
= UI_ACTION_REFRESH_FORMSET
;
1460 mHiiPackageListUpdated
= FALSE
;
1466 // Load Questions' Value for display
1468 Status
= LoadFormSetConfig (Selection
, Selection
->FormSet
);
1469 if (EFI_ERROR (Status
)) {
1474 // EXIT requests to close form.
1476 if (Selection
->Action
== UI_ACTION_EXIT
) {
1480 // IFR is updated during callback of read value, force to reparse the IFR binary
1482 if (mHiiPackageListUpdated
) {
1483 Selection
->Action
= UI_ACTION_REFRESH_FORMSET
;
1484 mHiiPackageListUpdated
= FALSE
;
1489 // Displays the Header and Footer borders
1491 DisplayPageFrame (Selection
);
1496 Status
= DisplayForm (Selection
);
1497 if (EFI_ERROR (Status
)) {
1502 // Check Selected Statement (if press ESC, Selection->Statement will be NULL)
1504 Statement
= Selection
->Statement
;
1505 if (Statement
!= NULL
) {
1506 if ((Statement
->QuestionFlags
& EFI_IFR_FLAG_RESET_REQUIRED
) == EFI_IFR_FLAG_RESET_REQUIRED
) {
1507 gResetRequired
= TRUE
;
1511 // Reset FormPackage update flag
1513 mHiiPackageListUpdated
= FALSE
;
1515 if ((ConfigAccess
!= NULL
) &&
1516 ((Statement
->QuestionFlags
& EFI_IFR_FLAG_CALLBACK
) == EFI_IFR_FLAG_CALLBACK
) &&
1517 (Statement
->Operand
!= EFI_IFR_PASSWORD_OP
)) {
1519 Status
= ProcessCallBackFunction(Selection
, Statement
, EFI_BROWSER_ACTION_CHANGING
, FALSE
);
1520 if (Statement
->Operand
== EFI_IFR_REF_OP
&& Selection
->Action
!= UI_ACTION_EXIT
) {
1522 // Process dynamic update ref opcode.
1524 if (!EFI_ERROR (Status
)) {
1525 Status
= ProcessGotoOpCode(Statement
, Selection
, NULL
, NULL
);
1529 // Callback return error status or status return from process goto opcode.
1531 if (EFI_ERROR (Status
)) {
1533 // Cross reference will not be taken
1535 Selection
->FormId
= Selection
->Form
->FormId
;
1536 Selection
->QuestionId
= 0;
1542 // Check whether Form Package has been updated during Callback
1544 if (mHiiPackageListUpdated
&& (Selection
->Action
== UI_ACTION_REFRESH_FORM
)) {
1546 // Force to reparse IFR binary of target Formset
1548 mHiiPackageListUpdated
= FALSE
;
1549 Selection
->Action
= UI_ACTION_REFRESH_FORMSET
;
1554 // Before exit the form, invoke ConfigAccess.Callback() with EFI_BROWSER_ACTION_FORM_CLOSE
1555 // for each question with callback flag.
1557 if ((ConfigAccess
!= NULL
) &&
1558 ((Selection
->Action
== UI_ACTION_EXIT
) ||
1559 (Selection
->Handle
!= mCurrentHiiHandle
) ||
1560 (!CompareGuid (&Selection
->FormSetGuid
, &mCurrentFormSetGuid
)) ||
1561 (Selection
->FormId
!= mCurrentFormId
))) {
1563 Status
= ProcessCallBackFunction (Selection
, NULL
, EFI_BROWSER_ACTION_FORM_CLOSE
, FALSE
);
1564 if (EFI_ERROR (Status
)) {
1568 } while (Selection
->Action
== UI_ACTION_REFRESH_FORM
);
1572 // Reset current form information to the initial setting when error happens or form exit.
1574 if (EFI_ERROR (Status
) || Selection
->Action
== UI_ACTION_EXIT
) {
1575 mCurrentHiiHandle
= NULL
;
1576 CopyGuid (&mCurrentFormSetGuid
, &gZeroGuid
);
1581 // Unregister notify for Form package update
1583 mHiiDatabase
->UnregisterPackageNotify (