]> git.proxmox.com Git - mirror_edk2.git/blob - MdeModulePkg/Universal/SetupBrowserDxe/Presentation.c
projects / mirror_edk2.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
blame | history | raw | HEAD
1.Reposition the platform info. Move from the old position to left one block space...
[mirror_edk2.git] / MdeModulePkg / Universal / SetupBrowserDxe / Presentation.c
1 /** @file
2 Utility functions for UI presentation.
3
4 Copyright (c) 2004 - 2010, 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
9
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.
12
13 **/
14
15 #include "Setup.h"
16
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;
22
23 /**
24 Clear retangle with specified text attribute.
25
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.
31
32 **/
33 VOID
34 ClearLines (
35 IN UINTN LeftColumn,
36 IN UINTN RightColumn,
37 IN UINTN TopRow,
38 IN UINTN BottomRow,
39 IN UINTN TextAttribute
40 )
41 {
42 CHAR16 *Buffer;
43 UINTN Row;
44
45 //
46 // For now, allocate an arbitrarily long buffer
47 //
48 Buffer = AllocateZeroPool (0x10000);
49 ASSERT (Buffer != NULL);
50
51 //
52 // Set foreground and background as defined
53 //
54 gST->ConOut->SetAttribute (gST->ConOut, TextAttribute);
55
56 //
57 // Much faster to buffer the long string instead of print it a character at a time
58 //
59 SetUnicodeMem (Buffer, RightColumn - LeftColumn, L' ');
60
61 //
62 // Clear the desired area with the appropriate foreground/background
63 //
64 for (Row = TopRow; Row <= BottomRow; Row++) {
65 PrintStringAt (LeftColumn, Row, Buffer);
66 }
67
68 gST->ConOut->SetCursorPosition (gST->ConOut, LeftColumn, TopRow);
69
70 FreePool (Buffer);
71 return ;
72 }
73
74 /**
75 Concatenate a narrow string to another string.
76
77 @param Destination The destination string.
78 @param Source The source string. The string to be concatenated.
79 to the end of Destination.
80
81 **/
82 VOID
83 NewStrCat (
84 IN OUT CHAR16 *Destination,
85 IN CHAR16 *Source
86 )
87 {
88 UINTN Length;
89
90 for (Length = 0; Destination[Length] != 0; Length++)
91 ;
92
93 //
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
98 //
99 Destination[Length] = NARROW_CHAR;
100 Length++;
101
102 StrCpy (Destination + Length, Source);
103 }
104
105 /**
106 Count the storage space of a Unicode string.
107
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.
113
114 If String is NULL, then ASSERT ().
115
116 @param String The input string to be counted.
117
118 @return Storage space for the input string.
119
120 **/
121 UINTN
122 GetStringWidth (
123 IN CHAR16 *String
124 )
125 {
126 UINTN Index;
127 UINTN Count;
128 UINTN IncrementValue;
129
130 ASSERT (String != NULL);
131 if (String == NULL) {
132 return 0;
133 }
134
135 Index = 0;
136 Count = 0;
137 IncrementValue = 1;
138
139 do {
140 //
141 // Advance to the null-terminator or to the first width directive
142 //
143 for (;
144 (String[Index] != NARROW_CHAR) && (String[Index] != WIDE_CHAR) && (String[Index] != 0);
145 Index++, Count = Count + IncrementValue
146 )
147 ;
148
149 //
150 // We hit the null-terminator, we now have a count
151 //
152 if (String[Index] == 0) {
153 break;
154 }
155 //
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)
158 //
159 if (String[Index] == NARROW_CHAR) {
160 //
161 // Skip to the next character
162 //
163 Index++;
164 IncrementValue = 1;
165 } else {
166 //
167 // Skip to the next character
168 //
169 Index++;
170 IncrementValue = 2;
171 }
172 } while (String[Index] != 0);
173
174 //
175 // Increment by one to include the null-terminator in the size
176 //
177 Count++;
178
179 return Count * sizeof (CHAR16);
180 }
181
182 /**
183 This function displays the page frame.
184
185 **/
186 VOID
187 DisplayPageFrame (
188 VOID
189 )
190 {
191 UINTN Index;
192 UINT8 Line;
193 UINT8 Alignment;
194 CHAR16 Character;
195 CHAR16 *Buffer;
196 CHAR16 *StrFrontPageBanner;
197 UINTN Row;
198 EFI_SCREEN_DESCRIPTOR LocalScreen;
199 UINT8 RowIdx;
200 UINT8 ColumnIdx;
201
202 ZeroMem (&LocalScreen, sizeof (EFI_SCREEN_DESCRIPTOR));
203 gST->ConOut->QueryMode (gST->ConOut, gST->ConOut->Mode->Mode, &LocalScreen.RightColumn, &LocalScreen.BottomRow);
204 ClearLines (0, LocalScreen.RightColumn, 0, LocalScreen.BottomRow, KEYHELP_BACKGROUND);
205
206 CopyMem (&LocalScreen, &gScreenDimensions, sizeof (EFI_SCREEN_DESCRIPTOR));
207
208 //
209 // For now, allocate an arbitrarily long buffer
210 //
211 Buffer = AllocateZeroPool (0x10000);
212 ASSERT (Buffer != NULL);
213
214 Character = BOXDRAW_HORIZONTAL;
215
216 for (Index = 0; Index + 2 < (LocalScreen.RightColumn - LocalScreen.LeftColumn); Index++) {
217 Buffer[Index] = Character;
218 }
219
220 if ((gClassOfVfr & FORMSET_CLASS_FRONT_PAGE) == FORMSET_CLASS_FRONT_PAGE) {
221 //
222 // ClearLines(0, LocalScreen.RightColumn, 0, BANNER_HEIGHT-1, BANNER_TEXT | BANNER_BACKGROUND);
223 //
224 ClearLines (
225 LocalScreen.LeftColumn,
226 LocalScreen.RightColumn,
227 LocalScreen.TopRow,
228 FRONT_PAGE_HEADER_HEIGHT - 1 + LocalScreen.TopRow,
229 BANNER_TEXT | BANNER_BACKGROUND
230 );
231 //
232 // for (Line = 0; Line < BANNER_HEIGHT; Line++) {
233 //
234 for (Line = (UINT8) LocalScreen.TopRow; Line < BANNER_HEIGHT + (UINT8) LocalScreen.TopRow; Line++) {
235 //
236 // for (Alignment = 0; Alignment < BANNER_COLUMNS; Alignment++) {
237 //
238 for (Alignment = (UINT8) LocalScreen.LeftColumn;
239 Alignment < BANNER_COLUMNS + (UINT8) LocalScreen.LeftColumn;
240 Alignment++
241 ) {
242 RowIdx = (UINT8) (Line - (UINT8) LocalScreen.TopRow);
243 ColumnIdx = (UINT8) (Alignment - (UINT8) LocalScreen.LeftColumn);
244
245 ASSERT (RowIdx < BANNER_HEIGHT);
246 ASSERT (ColumnIdx < BANNER_COLUMNS);
247
248 if (gBannerData->Banner[RowIdx][ColumnIdx] != 0x0000) {
249 StrFrontPageBanner = GetToken (
250 gBannerData->Banner[RowIdx][ColumnIdx],
251 gFrontPageHandle
252 );
253 } else {
254 continue;
255 }
256
257 switch (Alignment - LocalScreen.LeftColumn) {
258 case 0:
259 //
260 // Handle left column
261 //
262 PrintStringAt (LocalScreen.LeftColumn + BANNER_LEFT_COLUMN_INDENT, Line, StrFrontPageBanner);
263 break;
264
265 case 1:
266 //
267 // Handle center column
268 //
269 PrintStringAt (
270 LocalScreen.LeftColumn + (LocalScreen.RightColumn - LocalScreen.LeftColumn) / 3,
271 Line,
272 StrFrontPageBanner
273 );
274 break;
275
276 case 2:
277 //
278 // Handle right column
279 //
280 PrintStringAt (
281 LocalScreen.LeftColumn + (LocalScreen.RightColumn - LocalScreen.LeftColumn) * 2 / 3,
282 Line,
283 StrFrontPageBanner
284 );
285 break;
286 }
287
288 FreePool (StrFrontPageBanner);
289 }
290 }
291 }
292
293 ClearLines (
294 LocalScreen.LeftColumn,
295 LocalScreen.RightColumn,
296 LocalScreen.BottomRow - STATUS_BAR_HEIGHT - FOOTER_HEIGHT,
297 LocalScreen.BottomRow - STATUS_BAR_HEIGHT - 1,
298 KEYHELP_TEXT | KEYHELP_BACKGROUND
299 );
300
301 if ((gClassOfVfr & FORMSET_CLASS_FRONT_PAGE) != FORMSET_CLASS_FRONT_PAGE) {
302 ClearLines (
303 LocalScreen.LeftColumn,
304 LocalScreen.RightColumn,
305 LocalScreen.TopRow,
306 LocalScreen.TopRow + NONE_FRONT_PAGE_HEADER_HEIGHT - 1,
307 TITLE_TEXT | TITLE_BACKGROUND
308 );
309 //
310 // Print Top border line
311 // +------------------------------------------------------------------------------+
312 // ? ?
313 // +------------------------------------------------------------------------------+
314 //
315 Character = BOXDRAW_DOWN_RIGHT;
316
317 PrintChar (Character);
318 PrintString (Buffer);
319
320 Character = BOXDRAW_DOWN_LEFT;
321 PrintChar (Character);
322
323 Character = BOXDRAW_VERTICAL;
324 for (Row = LocalScreen.TopRow + 1; Row <= LocalScreen.TopRow + NONE_FRONT_PAGE_HEADER_HEIGHT - 2; Row++) {
325 PrintCharAt (LocalScreen.LeftColumn, Row, Character);
326 PrintCharAt (LocalScreen.RightColumn - 1, Row, Character);
327 }
328
329 Character = BOXDRAW_UP_RIGHT;
330 PrintCharAt (LocalScreen.LeftColumn, LocalScreen.TopRow + NONE_FRONT_PAGE_HEADER_HEIGHT - 1, Character);
331 PrintString (Buffer);
332
333 Character = BOXDRAW_UP_LEFT;
334 PrintChar (Character);
335
336 if ((gClassOfVfr & FORMSET_CLASS_PLATFORM_SETUP) == FORMSET_CLASS_PLATFORM_SETUP) {
337 //
338 // Print Bottom border line
339 // +------------------------------------------------------------------------------+
340 // ? ?
341 // +------------------------------------------------------------------------------+
342 //
343 Character = BOXDRAW_DOWN_RIGHT;
344 PrintCharAt (LocalScreen.LeftColumn, LocalScreen.BottomRow - STATUS_BAR_HEIGHT - FOOTER_HEIGHT, Character);
345
346 PrintString (Buffer);
347
348 Character = BOXDRAW_DOWN_LEFT;
349 PrintChar (Character);
350 Character = BOXDRAW_VERTICAL;
351 for (Row = LocalScreen.BottomRow - STATUS_BAR_HEIGHT - FOOTER_HEIGHT + 1;
352 Row <= LocalScreen.BottomRow - STATUS_BAR_HEIGHT - 2;
353 Row++
354 ) {
355 PrintCharAt (LocalScreen.LeftColumn, Row, Character);
356 PrintCharAt (LocalScreen.RightColumn - 1, Row, Character);
357 }
358
359 Character = BOXDRAW_UP_RIGHT;
360 PrintCharAt (LocalScreen.LeftColumn, LocalScreen.BottomRow - STATUS_BAR_HEIGHT - 1, Character);
361
362 PrintString (Buffer);
363
364 Character = BOXDRAW_UP_LEFT;
365 PrintChar (Character);
366 }
367 }
368
369 FreePool (Buffer);
370
371 }
372
373
374 /**
375 Evaluate all expressions in a Form.
376
377 @param FormSet FormSet this Form belongs to.
378 @param Form The Form.
379
380 @retval EFI_SUCCESS The expression evaluated successfuly
381
382 **/
383 EFI_STATUS
384 EvaluateFormExpressions (
385 IN FORM_BROWSER_FORMSET *FormSet,
386 IN FORM_BROWSER_FORM *Form
387 )
388 {
389 EFI_STATUS Status;
390 LIST_ENTRY *Link;
391 FORM_EXPRESSION *Expression;
392
393 Link = GetFirstNode (&Form->ExpressionListHead);
394 while (!IsNull (&Form->ExpressionListHead, Link)) {
395 Expression = FORM_EXPRESSION_FROM_LINK (Link);
396 Link = GetNextNode (&Form->ExpressionListHead, Link);
397
398 if (Expression->Type == EFI_HII_EXPRESSION_INCONSISTENT_IF ||
399 Expression->Type == EFI_HII_EXPRESSION_NO_SUBMIT_IF ||
400 Expression->Type == EFI_HII_EXPRESSION_WRITE ||
401 (Expression->Type == EFI_HII_EXPRESSION_READ && Form->FormType != STANDARD_MAP_FORM_TYPE)) {
402 //
403 // Postpone Form validation to Question editing or Form submitting or Question Write or Question Read for nonstandard form.
404 //
405 continue;
406 }
407
408 Status = EvaluateExpression (FormSet, Form, Expression);
409 if (EFI_ERROR (Status)) {
410 return Status;
411 }
412 }
413
414 return EFI_SUCCESS;
415 }
416
417 /*
418 +------------------------------------------------------------------------------+
419 ? Setup Page ?
420 +------------------------------------------------------------------------------+
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438 +------------------------------------------------------------------------------+
439 ?F1=Scroll Help F9=Reset to Defaults F10=Save and Exit ?
440 | ^"=Move Highlight <Spacebar> Toggles Checkbox Esc=Discard Changes |
441 +------------------------------------------------------------------------------+
442 */
443
444 /**
445
446
447 Display form and wait for user to select one menu option, then return it.
448
449 @param Selection On input, Selection tell setup browser the information
450 about the Selection, form and formset to be displayed.
451 On output, Selection return the screen item that is selected
452 by user.
453 @retval EFI_SUCESSS This function always return successfully for now.
454
455 **/
456 EFI_STATUS
457 DisplayForm (
458 IN OUT UI_MENU_SELECTION *Selection
459 )
460 {
461 CHAR16 *StringPtr;
462 UINT16 MenuItemCount;
463 EFI_HII_HANDLE Handle;
464 BOOLEAN Suppress;
465 EFI_SCREEN_DESCRIPTOR LocalScreen;
466 UINT16 Width;
467 UINTN ArrayEntry;
468 CHAR16 *OutputString;
469 LIST_ENTRY *Link;
470 FORM_BROWSER_STATEMENT *Statement;
471 UINT16 NumberOfLines;
472 EFI_STATUS Status;
473 UI_MENU_OPTION *MenuOption;
474
475 Handle = Selection->Handle;
476 MenuItemCount = 0;
477 ArrayEntry = 0;
478 OutputString = NULL;
479
480 UiInitMenu ();
481
482 CopyMem (&LocalScreen, &gScreenDimensions, sizeof (EFI_SCREEN_DESCRIPTOR));
483
484 StringPtr = GetToken (Selection->Form->FormTitle, Handle);
485
486 if ((gClassOfVfr & FORMSET_CLASS_FRONT_PAGE) != FORMSET_CLASS_FRONT_PAGE) {
487 gST->ConOut->SetAttribute (gST->ConOut, TITLE_TEXT | TITLE_BACKGROUND);
488 PrintStringAt (
489 (LocalScreen.RightColumn + LocalScreen.LeftColumn - GetStringWidth (StringPtr) / 2) / 2,
490 LocalScreen.TopRow + 1,
491 StringPtr
492 );
493 }
494
495 //
496 // Remove Buffer allocated for StringPtr after it has been used.
497 //
498 FreePool (StringPtr);
499
500 //
501 // Evaluate all the Expressions in this Form
502 //
503 Status = EvaluateFormExpressions (Selection->FormSet, Selection->Form);
504 if (EFI_ERROR (Status)) {
505 return Status;
506 }
507
508 Selection->FormEditable = FALSE;
509 Link = GetFirstNode (&Selection->Form->StatementListHead);
510 while (!IsNull (&Selection->Form->StatementListHead, Link)) {
511 Statement = FORM_BROWSER_STATEMENT_FROM_LINK (Link);
512
513 if (Statement->SuppressExpression != NULL) {
514 Suppress = Statement->SuppressExpression->Result.Value.b;
515 } else {
516 Suppress = FALSE;
517 }
518
519 if (Statement->DisableExpression != NULL) {
520 Suppress = (BOOLEAN) (Suppress || Statement->DisableExpression->Result.Value.b);
521 }
522
523 if (!Suppress) {
524 StringPtr = GetToken (Statement->Prompt, Handle);
525
526 Width = GetWidth (Statement, Handle);
527
528 NumberOfLines = 1;
529 ArrayEntry = 0;
530 for (; GetLineByWidth (StringPtr, Width, &ArrayEntry, &OutputString) != 0x0000;) {
531 //
532 // If there is more string to process print on the next row and increment the Skip value
533 //
534 if (StrLen (&StringPtr[ArrayEntry]) != 0) {
535 NumberOfLines++;
536 }
537
538 FreePool (OutputString);
539 }
540
541 //
542 // We are NOT!! removing this StringPtr buffer via FreePool since it is being used in the menuoptions, we will do
543 // it in UiFreeMenu.
544 //
545 MenuOption = UiAddMenuOption (StringPtr, Selection->Handle, Statement, NumberOfLines, MenuItemCount);
546 MenuItemCount++;
547
548 if (MenuOption->IsQuestion && !MenuOption->ReadOnly) {
549 //
550 // At least one item is not readonly, this Form is considered as editable
551 //
552 Selection->FormEditable = TRUE;
553 }
554 }
555
556 Link = GetNextNode (&Selection->Form->StatementListHead, Link);
557 }
558
559 Status = UiDisplayMenu (Selection);
560
561 UiFreeMenu ();
562
563 return Status;
564 }
565
566 /**
567 Initialize the HII String Token to the correct values.
568
569 **/
570 VOID
571 InitializeBrowserStrings (
572 VOID
573 )
574 {
575 gFunctionNineString = GetToken (STRING_TOKEN (FUNCTION_NINE_STRING), gHiiHandle);
576 gFunctionTenString = GetToken (STRING_TOKEN (FUNCTION_TEN_STRING), gHiiHandle);
577 gEnterString = GetToken (STRING_TOKEN (ENTER_STRING), gHiiHandle);
578 gEnterCommitString = GetToken (STRING_TOKEN (ENTER_COMMIT_STRING), gHiiHandle);
579 gEnterEscapeString = GetToken (STRING_TOKEN (ENTER_ESCAPE_STRING), gHiiHandle);
580 gEscapeString = GetToken (STRING_TOKEN (ESCAPE_STRING), gHiiHandle);
581 gSaveFailed = GetToken (STRING_TOKEN (SAVE_FAILED), gHiiHandle);
582 gMoveHighlight = GetToken (STRING_TOKEN (MOVE_HIGHLIGHT), gHiiHandle);
583 gMakeSelection = GetToken (STRING_TOKEN (MAKE_SELECTION), gHiiHandle);
584 gDecNumericInput = GetToken (STRING_TOKEN (DEC_NUMERIC_INPUT), gHiiHandle);
585 gHexNumericInput = GetToken (STRING_TOKEN (HEX_NUMERIC_INPUT), gHiiHandle);
586 gToggleCheckBox = GetToken (STRING_TOKEN (TOGGLE_CHECK_BOX), gHiiHandle);
587 gPromptForData = GetToken (STRING_TOKEN (PROMPT_FOR_DATA), gHiiHandle);
588 gPromptForPassword = GetToken (STRING_TOKEN (PROMPT_FOR_PASSWORD), gHiiHandle);
589 gPromptForNewPassword = GetToken (STRING_TOKEN (PROMPT_FOR_NEW_PASSWORD), gHiiHandle);
590 gConfirmPassword = GetToken (STRING_TOKEN (CONFIRM_PASSWORD), gHiiHandle);
591 gConfirmError = GetToken (STRING_TOKEN (CONFIRM_ERROR), gHiiHandle);
592 gPassowordInvalid = GetToken (STRING_TOKEN (PASSWORD_INVALID), gHiiHandle);
593 gPressEnter = GetToken (STRING_TOKEN (PRESS_ENTER), gHiiHandle);
594 gEmptyString = GetToken (STRING_TOKEN (EMPTY_STRING), gHiiHandle);
595 gAreYouSure = GetToken (STRING_TOKEN (ARE_YOU_SURE), gHiiHandle);
596 gYesResponse = GetToken (STRING_TOKEN (ARE_YOU_SURE_YES), gHiiHandle);
597 gNoResponse = GetToken (STRING_TOKEN (ARE_YOU_SURE_NO), gHiiHandle);
598 gMiniString = GetToken (STRING_TOKEN (MINI_STRING), gHiiHandle);
599 gPlusString = GetToken (STRING_TOKEN (PLUS_STRING), gHiiHandle);
600 gMinusString = GetToken (STRING_TOKEN (MINUS_STRING), gHiiHandle);
601 gAdjustNumber = GetToken (STRING_TOKEN (ADJUST_NUMBER), gHiiHandle);
602 gSaveChanges = GetToken (STRING_TOKEN (SAVE_CHANGES), gHiiHandle);
603 gOptionMismatch = GetToken (STRING_TOKEN (OPTION_MISMATCH), gHiiHandle);
604 gFormSuppress = GetToken (STRING_TOKEN (FORM_SUPPRESSED), gHiiHandle);
605 return ;
606 }
607
608 /**
609 Free up the resource allocated for all strings required
610 by Setup Browser.
611
612 **/
613 VOID
614 FreeBrowserStrings (
615 VOID
616 )
617 {
618 FreePool (gFunctionNineString);
619 FreePool (gFunctionTenString);
620 FreePool (gEnterString);
621 FreePool (gEnterCommitString);
622 FreePool (gEnterEscapeString);
623 FreePool (gEscapeString);
624 FreePool (gMoveHighlight);
625 FreePool (gMakeSelection);
626 FreePool (gDecNumericInput);
627 FreePool (gHexNumericInput);
628 FreePool (gToggleCheckBox);
629 FreePool (gPromptForData);
630 FreePool (gPromptForPassword);
631 FreePool (gPromptForNewPassword);
632 FreePool (gConfirmPassword);
633 FreePool (gPassowordInvalid);
634 FreePool (gConfirmError);
635 FreePool (gPressEnter);
636 FreePool (gEmptyString);
637 FreePool (gAreYouSure);
638 FreePool (gYesResponse);
639 FreePool (gNoResponse);
640 FreePool (gMiniString);
641 FreePool (gPlusString);
642 FreePool (gMinusString);
643 FreePool (gAdjustNumber);
644 FreePool (gSaveChanges);
645 FreePool (gOptionMismatch);
646 FreePool (gFormSuppress);
647 return ;
648 }
649
650
651 /**
652 Update key's help imformation.
653
654 @param Selection Tell setup browser the information about the Selection
655 @param MenuOption The Menu option
656 @param Selected Whether or not a tag be selected
657
658 **/
659 VOID
660 UpdateKeyHelp (
661 IN UI_MENU_SELECTION *Selection,
662 IN UI_MENU_OPTION *MenuOption,
663 IN BOOLEAN Selected
664 )
665 {
666 UINTN SecCol;
667 UINTN ThdCol;
668 UINTN LeftColumnOfHelp;
669 UINTN RightColumnOfHelp;
670 UINTN TopRowOfHelp;
671 UINTN BottomRowOfHelp;
672 UINTN StartColumnOfHelp;
673 EFI_SCREEN_DESCRIPTOR LocalScreen;
674 FORM_BROWSER_STATEMENT *Statement;
675
676 CopyMem (&LocalScreen, &gScreenDimensions, sizeof (EFI_SCREEN_DESCRIPTOR));
677
678 SecCol = LocalScreen.LeftColumn + (LocalScreen.RightColumn - LocalScreen.LeftColumn) / 3;
679 ThdCol = LocalScreen.LeftColumn + (LocalScreen.RightColumn - LocalScreen.LeftColumn) * 2 / 3;
680
681 StartColumnOfHelp = LocalScreen.LeftColumn + 2;
682 LeftColumnOfHelp = LocalScreen.LeftColumn + 1;
683 RightColumnOfHelp = LocalScreen.RightColumn - 2;
684 TopRowOfHelp = LocalScreen.BottomRow - 4;
685 BottomRowOfHelp = LocalScreen.BottomRow - 3;
686
687 gST->ConOut->SetAttribute (gST->ConOut, KEYHELP_TEXT | KEYHELP_BACKGROUND);
688
689 Statement = MenuOption->ThisTag;
690 switch (Statement->Operand) {
691 case EFI_IFR_ORDERED_LIST_OP:
692 case EFI_IFR_ONE_OF_OP:
693 case EFI_IFR_NUMERIC_OP:
694 case EFI_IFR_TIME_OP:
695 case EFI_IFR_DATE_OP:
696 ClearLines (LeftColumnOfHelp, RightColumnOfHelp, TopRowOfHelp, BottomRowOfHelp, KEYHELP_TEXT | KEYHELP_BACKGROUND);
697
698 if (!Selected) {
699 if ((gClassOfVfr & FORMSET_CLASS_PLATFORM_SETUP) == FORMSET_CLASS_PLATFORM_SETUP) {
700 if (Selection->FormEditable) {
701 PrintStringAt (SecCol, TopRowOfHelp, gFunctionNineString);
702 PrintStringAt (ThdCol, TopRowOfHelp, gFunctionTenString);
703 }
704 PrintStringAt (ThdCol, BottomRowOfHelp, gEscapeString);
705 }
706
707 if ((Statement->Operand == EFI_IFR_DATE_OP) ||
708 (Statement->Operand == EFI_IFR_TIME_OP)) {
709 PrintAt (
710 StartColumnOfHelp,
711 BottomRowOfHelp,
712 L"%c%c%c%c%s",
713 ARROW_UP,
714 ARROW_DOWN,
715 ARROW_RIGHT,
716 ARROW_LEFT,
717 gMoveHighlight
718 );
719 PrintStringAt (SecCol, BottomRowOfHelp, gEnterString);
720 PrintStringAt (StartColumnOfHelp, TopRowOfHelp, gAdjustNumber);
721 } else {
722 PrintAt (StartColumnOfHelp, BottomRowOfHelp, L"%c%c%s", ARROW_UP, ARROW_DOWN, gMoveHighlight);
723 if (Statement->Operand == EFI_IFR_NUMERIC_OP && Statement->Step != 0) {
724 PrintStringAt (StartColumnOfHelp, TopRowOfHelp, gAdjustNumber);
725 }
726 PrintStringAt (SecCol, BottomRowOfHelp, gEnterString);
727 }
728 } else {
729 PrintStringAt (SecCol, BottomRowOfHelp, gEnterCommitString);
730
731 //
732 // If it is a selected numeric with manual input, display different message
733 //
734 if ((Statement->Operand == EFI_IFR_NUMERIC_OP) ||
735 (Statement->Operand == EFI_IFR_DATE_OP) ||
736 (Statement->Operand == EFI_IFR_TIME_OP)) {
737 PrintStringAt (
738 SecCol,
739 TopRowOfHelp,
740 ((Statement->Flags & EFI_IFR_DISPLAY_UINT_HEX) == EFI_IFR_DISPLAY_UINT_HEX) ? gHexNumericInput : gDecNumericInput
741 );
742 } else if (Statement->Operand != EFI_IFR_ORDERED_LIST_OP) {
743 PrintAt (StartColumnOfHelp, BottomRowOfHelp, L"%c%c%s", ARROW_UP, ARROW_DOWN, gMoveHighlight);
744 }
745
746 if (Statement->Operand == EFI_IFR_ORDERED_LIST_OP) {
747 PrintStringAt (StartColumnOfHelp, TopRowOfHelp, gPlusString);
748 PrintStringAt (ThdCol, TopRowOfHelp, gMinusString);
749 }
750
751 PrintStringAt (ThdCol, BottomRowOfHelp, gEnterEscapeString);
752 }
753 break;
754
755 case EFI_IFR_CHECKBOX_OP:
756 ClearLines (LeftColumnOfHelp, RightColumnOfHelp, TopRowOfHelp, BottomRowOfHelp, KEYHELP_TEXT | KEYHELP_BACKGROUND);
757
758 if ((gClassOfVfr & FORMSET_CLASS_PLATFORM_SETUP) == FORMSET_CLASS_PLATFORM_SETUP) {
759 if (Selection->FormEditable) {
760 PrintStringAt (SecCol, TopRowOfHelp, gFunctionNineString);
761 PrintStringAt (ThdCol, TopRowOfHelp, gFunctionTenString);
762 }
763 PrintStringAt (ThdCol, BottomRowOfHelp, gEscapeString);
764 }
765
766 PrintAt (StartColumnOfHelp, BottomRowOfHelp, L"%c%c%s", ARROW_UP, ARROW_DOWN, gMoveHighlight);
767 PrintStringAt (SecCol, BottomRowOfHelp, gToggleCheckBox);
768 break;
769
770 case EFI_IFR_REF_OP:
771 case EFI_IFR_PASSWORD_OP:
772 case EFI_IFR_STRING_OP:
773 case EFI_IFR_TEXT_OP:
774 case EFI_IFR_ACTION_OP:
775 case EFI_IFR_RESET_BUTTON_OP:
776 ClearLines (LeftColumnOfHelp, RightColumnOfHelp, TopRowOfHelp, BottomRowOfHelp, KEYHELP_TEXT | KEYHELP_BACKGROUND);
777
778 if (!Selected) {
779 if ((gClassOfVfr & FORMSET_CLASS_PLATFORM_SETUP) == FORMSET_CLASS_PLATFORM_SETUP) {
780 if (Selection->FormEditable) {
781 PrintStringAt (SecCol, TopRowOfHelp, gFunctionNineString);
782 PrintStringAt (ThdCol, TopRowOfHelp, gFunctionTenString);
783 }
784 PrintStringAt (ThdCol, BottomRowOfHelp, gEscapeString);
785 }
786
787 PrintAt (StartColumnOfHelp, BottomRowOfHelp, L"%c%c%s", ARROW_UP, ARROW_DOWN, gMoveHighlight);
788 if (Statement->Operand != EFI_IFR_TEXT_OP) {
789 PrintStringAt (SecCol, BottomRowOfHelp, gEnterString);
790 }
791 } else {
792 if (Statement->Operand != EFI_IFR_REF_OP) {
793 PrintStringAt (
794 (LocalScreen.RightColumn - GetStringWidth (gEnterCommitString) / 2) / 2,
795 BottomRowOfHelp,
796 gEnterCommitString
797 );
798 PrintStringAt (ThdCol, BottomRowOfHelp, gEnterEscapeString);
799 }
800 }
801 break;
802
803 default:
804 break;
805 }
806 }
807
808 /**
809 Functions which are registered to receive notification of
810 database events have this prototype. The actual event is encoded
811 in NotifyType. The following table describes how PackageType,
812 PackageGuid, Handle, and Package are used for each of the
813 notification types.
814
815 @param PackageType Package type of the notification.
816
817 @param PackageGuid If PackageType is
818 EFI_HII_PACKAGE_TYPE_GUID, then this is
819 the pointer to the GUID from the Guid
820 field of EFI_HII_PACKAGE_GUID_HEADER.
821 Otherwise, it must be NULL.
822
823 @param Package Points to the package referred to by the
824 notification Handle The handle of the package
825 list which contains the specified package.
826
827 @param Handle The HII handle.
828
829 @param NotifyType The type of change concerning the
830 database. See
831 EFI_HII_DATABASE_NOTIFY_TYPE.
832
833 **/
834 EFI_STATUS
835 EFIAPI
836 FormUpdateNotify (
837 IN UINT8 PackageType,
838 IN CONST EFI_GUID *PackageGuid,
839 IN CONST EFI_HII_PACKAGE_HEADER *Package,
840 IN EFI_HII_HANDLE Handle,
841 IN EFI_HII_DATABASE_NOTIFY_TYPE NotifyType
842 )
843 {
844 mHiiPackageListUpdated = TRUE;
845
846 return EFI_SUCCESS;
847 }
848
849 /**
850 The worker function that send the displays to the screen. On output,
851 the selection made by user is returned.
852
853 @param Selection On input, Selection tell setup browser the information
854 about the Selection, form and formset to be displayed.
855 On output, Selection return the screen item that is selected
856 by user.
857
858 @retval EFI_SUCCESS The page is displayed successfully.
859 @return Other value if the page failed to be diplayed.
860
861 **/
862 EFI_STATUS
863 SetupBrowser (
864 IN OUT UI_MENU_SELECTION *Selection
865 )
866 {
867 EFI_STATUS Status;
868 LIST_ENTRY *Link;
869 EFI_BROWSER_ACTION_REQUEST ActionRequest;
870 EFI_HANDLE NotifyHandle;
871 EFI_HII_VALUE *HiiValue;
872 EFI_IFR_TYPE_VALUE *TypeValue;
873 FORM_BROWSER_STATEMENT *Statement;
874 EFI_HII_CONFIG_ACCESS_PROTOCOL *ConfigAccess;
875 FORM_BROWSER_FORMSET *FormSet;
876 EFI_INPUT_KEY Key;
877 BOOLEAN SubmitFormIsRequired;
878
879 gMenuRefreshHead = NULL;
880 gResetRequired = FALSE;
881 FormSet = Selection->FormSet;
882 ConfigAccess = Selection->FormSet->ConfigAccess;
883
884 //
885 // Register notify for Form package update
886 //
887 Status = mHiiDatabase->RegisterPackageNotify (
888 mHiiDatabase,
889 EFI_HII_PACKAGE_FORMS,
890 NULL,
891 FormUpdateNotify,
892 EFI_HII_DATABASE_NOTIFY_REMOVE_PACK,
893 &NotifyHandle
894 );
895 if (EFI_ERROR (Status)) {
896 return Status;
897 }
898
899 //
900 // Initialize current settings of Questions in this FormSet
901 //
902 Status = InitializeCurrentSetting (Selection->FormSet);
903 if (EFI_ERROR (Status)) {
904 goto Done;
905 }
906
907 do {
908 //
909 // Initialize Selection->Form
910 //
911 if (Selection->FormId == 0) {
912 //
913 // Zero FormId indicates display the first Form in a FormSet
914 //
915 Link = GetFirstNode (&Selection->FormSet->FormListHead);
916
917 Selection->Form = FORM_BROWSER_FORM_FROM_LINK (Link);
918 Selection->FormId = Selection->Form->FormId;
919 } else {
920 Selection->Form = IdToForm (Selection->FormSet, Selection->FormId);
921 }
922
923 if (Selection->Form == NULL) {
924 //
925 // No Form to display
926 //
927 Status = EFI_NOT_FOUND;
928 goto Done;
929 }
930
931 //
932 // Check Form is suppressed.
933 //
934 if (Selection->Form->SuppressExpression != NULL) {
935 Status = EvaluateExpression (Selection->FormSet, Selection->Form, Selection->Form->SuppressExpression);
936 if (EFI_ERROR (Status) || (Selection->Form->SuppressExpression->Result.Type != EFI_IFR_TYPE_BOOLEAN)) {
937 Status = EFI_INVALID_PARAMETER;
938 goto Done;
939 }
940
941 if (Selection->Form->SuppressExpression->Result.Value.b) {
942 //
943 // Form is suppressed.
944 //
945 do {
946 CreateDialog (4, TRUE, 0, NULL, &Key, gEmptyString, gFormSuppress, gPressEnter, gEmptyString);
947 } while (Key.UnicodeChar != CHAR_CARRIAGE_RETURN);
948
949 Status = EFI_NOT_FOUND;
950 goto Done;
951 }
952 }
953
954 //
955 // Reset FormPackage update flag
956 //
957 mHiiPackageListUpdated = FALSE;
958
959 //
960 // Before display new form, invoke ConfigAccess.Callback() with EFI_BROWSER_ACTION_FORM_OPEN
961 // for each question with callback flag.
962 // New form may be the first form, or the different form after another form close.
963 //
964 if ((ConfigAccess != NULL) &&
965 ((Selection->Handle != mCurrentHiiHandle) ||
966 (!CompareGuid (&Selection->FormSetGuid, &mCurrentFormSetGuid)) ||
967 (Selection->FormId != mCurrentFormId))) {
968
969 //
970 // Keep current form information
971 //
972 mCurrentHiiHandle = Selection->Handle;
973 CopyGuid (&mCurrentFormSetGuid, &Selection->FormSetGuid);
974 mCurrentFormId = Selection->FormId;
975
976 //
977 // Go through each statement in this form
978 //
979 SubmitFormIsRequired = FALSE;
980 Link = GetFirstNode (&Selection->Form->StatementListHead);
981 while (!IsNull (&Selection->Form->StatementListHead, Link)) {
982 Statement = FORM_BROWSER_STATEMENT_FROM_LINK (Link);
983 Link = GetNextNode (&Selection->Form->StatementListHead, Link);
984
985 if ((Statement->QuestionFlags & EFI_IFR_FLAG_CALLBACK) != EFI_IFR_FLAG_CALLBACK) {
986 continue;
987 }
988
989 //
990 // Check whether Statement is disabled.
991 //
992 if (Statement->DisableExpression != NULL) {
993 Status = EvaluateExpression (Selection->FormSet, Selection->Form, Statement->DisableExpression);
994 if (!EFI_ERROR (Status) &&
995 (Statement->DisableExpression->Result.Type == EFI_IFR_TYPE_BOOLEAN) &&
996 (Statement->DisableExpression->Result.Value.b)) {
997 continue;
998 }
999 }
1000
1001 ActionRequest = EFI_BROWSER_ACTION_REQUEST_NONE;
1002 Status = ConfigAccess->Callback (
1003 ConfigAccess,
1004 EFI_BROWSER_ACTION_FORM_OPEN,
1005 Statement->QuestionId,
1006 EFI_IFR_TYPE_UNDEFINED,
1007 NULL,
1008 &ActionRequest
1009 );
1010
1011 if (!EFI_ERROR (Status)) {
1012 switch (ActionRequest) {
1013 case EFI_BROWSER_ACTION_REQUEST_RESET:
1014 gResetRequired = TRUE;
1015 break;
1016
1017 case EFI_BROWSER_ACTION_REQUEST_SUBMIT:
1018 SubmitFormIsRequired = TRUE;
1019 break;
1020
1021 case EFI_BROWSER_ACTION_REQUEST_EXIT:
1022 Selection->Action = UI_ACTION_EXIT;
1023 gNvUpdateRequired = FALSE;
1024 break;
1025
1026 default:
1027 break;
1028 }
1029 }
1030 }
1031 if (SubmitFormIsRequired) {
1032 SubmitForm (Selection->FormSet, Selection->Form);
1033 }
1034 //
1035 // EXIT requests to close form.
1036 //
1037 if (Selection->Action == UI_ACTION_EXIT) {
1038 goto Done;
1039 }
1040 //
1041 // IFR is updated during callback of open form, force to reparse the IFR binary
1042 //
1043 if (mHiiPackageListUpdated) {
1044 Selection->Action = UI_ACTION_REFRESH_FORMSET;
1045 mHiiPackageListUpdated = FALSE;
1046 goto Done;
1047 }
1048 }
1049
1050 //
1051 // Load Questions' Value for display
1052 //
1053 Status = LoadFormSetConfig (Selection, Selection->FormSet);
1054 if (EFI_ERROR (Status)) {
1055 goto Done;
1056 }
1057
1058 //
1059 // EXIT requests to close form.
1060 //
1061 if (Selection->Action == UI_ACTION_EXIT) {
1062 goto Done;
1063 }
1064 //
1065 // IFR is updated during callback of read value, force to reparse the IFR binary
1066 //
1067 if (mHiiPackageListUpdated) {
1068 Selection->Action = UI_ACTION_REFRESH_FORMSET;
1069 mHiiPackageListUpdated = FALSE;
1070 goto Done;
1071 }
1072
1073 //
1074 // Displays the Header and Footer borders
1075 //
1076 DisplayPageFrame ();
1077
1078 //
1079 // Display form
1080 //
1081 Status = DisplayForm (Selection);
1082 if (EFI_ERROR (Status)) {
1083 goto Done;
1084 }
1085
1086 //
1087 // Check Selected Statement (if press ESC, Selection->Statement will be NULL)
1088 //
1089 Statement = Selection->Statement;
1090 if (Statement != NULL) {
1091 if ((Statement->QuestionFlags & EFI_IFR_FLAG_RESET_REQUIRED) == EFI_IFR_FLAG_RESET_REQUIRED) {
1092 gResetRequired = TRUE;
1093 }
1094
1095 //
1096 // Reset FormPackage update flag
1097 //
1098 mHiiPackageListUpdated = FALSE;
1099
1100 if ((ConfigAccess != NULL) &&
1101 ((Statement->QuestionFlags & EFI_IFR_FLAG_CALLBACK) == EFI_IFR_FLAG_CALLBACK) &&
1102 (Statement->Operand != EFI_IFR_PASSWORD_OP)) {
1103
1104 ActionRequest = EFI_BROWSER_ACTION_REQUEST_NONE;
1105
1106 HiiValue = &Statement->HiiValue;
1107 TypeValue = &HiiValue->Value;
1108 if (HiiValue->Type == EFI_IFR_TYPE_BUFFER) {
1109 //
1110 // For OrderedList, passing in the value buffer to Callback()
1111 //
1112 TypeValue = (EFI_IFR_TYPE_VALUE *) Statement->BufferValue;
1113 }
1114
1115 Status = ConfigAccess->Callback (
1116 ConfigAccess,
1117 EFI_BROWSER_ACTION_CHANGING,
1118 Statement->QuestionId,
1119 HiiValue->Type,
1120 TypeValue,
1121 &ActionRequest
1122 );
1123
1124 if (!EFI_ERROR (Status)) {
1125 switch (ActionRequest) {
1126 case EFI_BROWSER_ACTION_REQUEST_RESET:
1127 gResetRequired = TRUE;
1128 break;
1129
1130 case EFI_BROWSER_ACTION_REQUEST_SUBMIT:
1131 SubmitForm (Selection->FormSet, Selection->Form);
1132 break;
1133
1134 case EFI_BROWSER_ACTION_REQUEST_EXIT:
1135 Selection->Action = UI_ACTION_EXIT;
1136 gNvUpdateRequired = FALSE;
1137 break;
1138
1139 default:
1140 break;
1141 }
1142 } else if (Status != EFI_UNSUPPORTED) {
1143 //
1144 // Callback return error status other than EFI_UNSUPPORTED
1145 //
1146 if (Statement->Operand == EFI_IFR_REF_OP) {
1147 //
1148 // Cross reference will not be taken
1149 //
1150 Selection->FormId = Selection->Form->FormId;
1151 Selection->QuestionId = 0;
1152 }
1153 }
1154 }
1155
1156 //
1157 // Check whether Form Package has been updated during Callback
1158 //
1159 if (mHiiPackageListUpdated && (Selection->Action == UI_ACTION_REFRESH_FORM)) {
1160 //
1161 // Force to reparse IFR binary of target Formset
1162 //
1163 mHiiPackageListUpdated = FALSE;
1164 Selection->Action = UI_ACTION_REFRESH_FORMSET;
1165 }
1166 }
1167
1168 //
1169 // Before exit the form, invoke ConfigAccess.Callback() with EFI_BROWSER_ACTION_FORM_CLOSE
1170 // for each question with callback flag.
1171 //
1172 if ((ConfigAccess != NULL) &&
1173 ((Selection->Action == UI_ACTION_EXIT) ||
1174 (Selection->Handle != mCurrentHiiHandle) ||
1175 (!CompareGuid (&Selection->FormSetGuid, &mCurrentFormSetGuid)) ||
1176 (Selection->FormId != mCurrentFormId))) {
1177 //
1178 // Go through each statement in this form
1179 //
1180 SubmitFormIsRequired = FALSE;
1181 Link = GetFirstNode (&Selection->Form->StatementListHead);
1182 while (!IsNull (&Selection->Form->StatementListHead, Link)) {
1183 Statement = FORM_BROWSER_STATEMENT_FROM_LINK (Link);
1184 Link = GetNextNode (&Selection->Form->StatementListHead, Link);
1185
1186 if ((Statement->QuestionFlags & EFI_IFR_FLAG_CALLBACK) != EFI_IFR_FLAG_CALLBACK) {
1187 continue;
1188 }
1189
1190 ActionRequest = EFI_BROWSER_ACTION_REQUEST_NONE;
1191 Status = ConfigAccess->Callback (
1192 ConfigAccess,
1193 EFI_BROWSER_ACTION_FORM_CLOSE,
1194 Statement->QuestionId,
1195 EFI_IFR_TYPE_UNDEFINED,
1196 NULL,
1197 &ActionRequest
1198 );
1199
1200 if (!EFI_ERROR (Status)) {
1201 switch (ActionRequest) {
1202 case EFI_BROWSER_ACTION_REQUEST_RESET:
1203 gResetRequired = TRUE;
1204 break;
1205
1206 case EFI_BROWSER_ACTION_REQUEST_SUBMIT:
1207 SubmitFormIsRequired = TRUE;
1208 break;
1209
1210 case EFI_BROWSER_ACTION_REQUEST_EXIT:
1211 Selection->Action = UI_ACTION_EXIT;
1212 gNvUpdateRequired = FALSE;
1213 break;
1214
1215 default:
1216 break;
1217 }
1218 }
1219 }
1220 if (SubmitFormIsRequired) {
1221 SubmitForm (Selection->FormSet, Selection->Form);
1222 }
1223 }
1224 } while (Selection->Action == UI_ACTION_REFRESH_FORM);
1225
1226 //
1227 // Record the old formset
1228 //
1229 if (gOldFormSet != NULL) {
1230 DestroyFormSet (gOldFormSet);
1231 }
1232 gOldFormSet = FormSet;
1233
1234 Done:
1235 //
1236 // Reset current form information to the initial setting when error happens or form exit.
1237 //
1238 if (EFI_ERROR (Status) || Selection->Action == UI_ACTION_EXIT) {
1239 mCurrentHiiHandle = NULL;
1240 CopyGuid (&mCurrentFormSetGuid, &gZeroGuid);
1241 mCurrentFormId = 0;
1242 }
1243
1244 //
1245 // Unregister notify for Form package update
1246 //
1247 mHiiDatabase->UnregisterPackageNotify (
1248 mHiiDatabase,
1249 NotifyHandle
1250 );
1251 return Status;
1252 }
EFI Development Kit II mirror for PVE