#include "CustomizedDisplayLibInternal.h"

Functions
EFI_STATUS EFIAPI	DisplayPageFrame (IN FORM_DISPLAY_ENGINE_FORM FormData, OUT EFI_SCREEN_DESCRIPTOR ScreenForStatement)

VOID EFIAPI	RefreshKeyHelp (IN FORM_DISPLAY_ENGINE_FORM FormData, IN FORM_DISPLAY_ENGINE_STATEMENT Statement, IN BOOLEAN Selected)

VOID EFIAPI	UpdateStatusBar (IN UINTN MessageType, IN BOOLEAN State)

VOID EFIAPI	CreateDialog (OUT EFI_INPUT_KEY *Key OPTIONAL,...)

UINTN EFIAPI	ConfirmDataChange (VOID)

BOOLEAN EFIAPI	FormExitPolicy (VOID)

UINT64 EFIAPI	FormExitTimeout (IN FORM_DISPLAY_ENGINE_FORM *FormData)

UINTN EFIAPI	PrintStringAt (IN UINTN Column, IN UINTN Row, IN CHAR16 *String)

UINTN EFIAPI	PrintStringAtWithWidth (IN UINTN Column, IN UINTN Row, IN CHAR16 *String, IN UINTN Width)

UINTN EFIAPI	PrintCharAt (IN UINTN Column, IN UINTN Row, CHAR16 Character)

VOID EFIAPI	ClearLines (IN UINTN LeftColumn, IN UINTN RightColumn, IN UINTN TopRow, IN UINTN BottomRow, IN UINTN TextAttribute)

UINT8 EFIAPI	GetPopupColor (VOID)

UINT8 EFIAPI	GetPopupInverseColor (VOID)

UINT8 EFIAPI	GetPickListColor (VOID)

UINT8 EFIAPI	GetArrowColor (VOID)

UINT8 EFIAPI	GetInfoTextColor (VOID)

UINT8 EFIAPI	GetHelpTextColor (VOID)

UINT8 EFIAPI	GetGrayedTextColor (VOID)

UINT8 EFIAPI	GetHighlightTextColor (VOID)

UINT8 EFIAPI	GetFieldTextColor (VOID)

UINT8 EFIAPI	GetSubTitleTextColor (VOID)

VOID EFIAPI	ClearDisplayPage (VOID)

EFI_STATUS EFIAPI	CustomizedDisplayLibConstructor (IN EFI_HANDLE ImageHandle, IN EFI_SYSTEM_TABLE *SystemTable)

EFI_STATUS EFIAPI	CustomizedDisplayLibDestructor (IN EFI_HANDLE ImageHandle, IN EFI_SYSTEM_TABLE *SystemTable)

Variables
EFI_GUID	gCustomizedDisplayLibGuid

EFI_HII_HANDLE	mCDLStringPackHandle

UINT16	gClassOfVfr

BOOLEAN	gLibIsFirstForm = TRUE

BANNER_DATA *	gBannerData

UINTN	gFooterHeight

Detailed Description

This library class defines a set of interfaces to customize Display module

Copyright (c) 2013 - 2018, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file CustomizedDisplayLib.c.

Function Documentation

◆ ClearDisplayPage()

VOID EFIAPI ClearDisplayPage ( VOID )

Clear Screen to the initial state.

Definition at line 918 of file CustomizedDisplayLib.c.

◆ ClearLines()

VOID EFIAPI ClearLines	(	IN UINTN	LeftColumn,
		IN UINTN	RightColumn,
		IN UINTN	TopRow,
		IN UINTN	BottomRow,
		IN UINTN	TextAttribute
	)

Clear retangle with specified text attribute.

Parameters

LeftColumn	Left column of retangle.
RightColumn	Right column of retangle.
TopRow	Start row of retangle.
BottomRow	End row of retangle.
TextAttribute	The character foreground and background.

Definition at line 730 of file CustomizedDisplayLib.c.

◆ ConfirmDataChange()

UINTN EFIAPI ConfirmDataChange ( VOID )

Confirm how to handle the changed data.

Returns: Action BROWSER_ACTION_SUBMIT, BROWSER_ACTION_DISCARD or other values.

Definition at line 574 of file CustomizedDisplayLib.c.

◆ CreateDialog()

VOID EFIAPI CreateDialog	(	OUT EFI_INPUT_KEY *Key	OPTIONAL,
			...
	)

Create popup window. It will replace CreateDialog().

This function draws OEM/Vendor specific pop up windows.

Parameters

[out]	Key	User Input Key
	...	String to be shown in Popup. The variable argument list is terminated by a NULL.

Definition at line 424 of file CustomizedDisplayLib.c.

◆ CustomizedDisplayLibConstructor()

EFI_STATUS EFIAPI CustomizedDisplayLibConstructor	(	IN EFI_HANDLE	ImageHandle,
		IN EFI_SYSTEM_TABLE *	SystemTable
	)

Constructor of Customized Display Library Instance.

Parameters

ImageHandle	The firmware allocated handle for the EFI image.
SystemTable	A pointer to the EFI System Table.

Return values

EFI_SUCCESS The constructor always returns EFI_SUCCESS.

Definition at line 938 of file CustomizedDisplayLib.c.

◆ CustomizedDisplayLibDestructor()

EFI_STATUS EFIAPI CustomizedDisplayLibDestructor	(	IN EFI_HANDLE	ImageHandle,
		IN EFI_SYSTEM_TABLE *	SystemTable
	)

Destructor of Customized Display Library Instance.

Parameters

ImageHandle	The firmware allocated handle for the EFI image.
SystemTable	A pointer to the EFI System Table.

Return values

EFI_SUCCESS	The destructor completed successfully.
Other	value The destructor did not complete successfully.

Definition at line 963 of file CustomizedDisplayLib.c.

◆ DisplayPageFrame()

EFI_STATUS EFIAPI DisplayPageFrame	(	IN FORM_DISPLAY_ENGINE_FORM *	FormData,
		OUT EFI_SCREEN_DESCRIPTOR *	ScreenForStatement
	)

+---------------------------------------------------------------------------—+ | Setup Page | +---------------------------------------------------------------------------—+

Statement Statement Statement

+---------------------------------------------------------------------------—+ | F9=Reset to Defaults F10=Save | | ^"=Move Highlight <Spacebar> Toggles Checkbox Esc=Exit | +---------------------------------------------------------------------------—+ StatusBar This funtion defines Page Frame and Backgroud.

Based on the above layout, it will be responsible for HeaderHeight, FooterHeight, StatusBarHeight and Backgroud. And, it will reserve Screen for Statement.

Parameters

[in]	FormData	Form Data to be shown in Page.
[out]	ScreenForStatement	Screen to be used for Statement. (Prompt, Value and Help)

Returns: Status

Definition at line 55 of file CustomizedDisplayLib.c.

◆ FormExitPolicy()

BOOLEAN EFIAPI FormExitPolicy ( VOID )

OEM specifies whether Setup exits Page by ESC key.

This function customized the behavior that whether Setup exits Page so that system able to boot when configuration is not changed.

Return values

TRUE	Exits FrontPage
FALSE	Don't exit FrontPage.

Definition at line 619 of file CustomizedDisplayLib.c.

◆ FormExitTimeout()

UINT64 EFIAPI FormExitTimeout ( IN FORM_DISPLAY_ENGINE_FORM * FormData )

Set Timeout value for a ceratain Form to get user response.

This function allows to set timeout value on a ceratain form if necessary. If timeout is not zero, the form will exit if user has no response in timeout.

Parameters

[in] FormData Form Data to be shown in Page

Returns: 0 No timeout for this form.; > 0 Timeout value in 100 ns units.

Definition at line 639 of file CustomizedDisplayLib.c.

◆ GetArrowColor()

UINT8 EFIAPI GetArrowColor ( VOID )

Get OEM/Vendor specific arrow color attribute.

Return values

Byte	code color setting for arrow color.

Definition at line 822 of file CustomizedDisplayLib.c.

◆ GetFieldTextColor()

UINT8 EFIAPI GetFieldTextColor ( VOID )

Get OEM/Vendor specific field text color attribute.

Return values

Byte	code color setting for field text color.

Definition at line 892 of file CustomizedDisplayLib.c.

◆ GetGrayedTextColor()

UINT8 EFIAPI GetGrayedTextColor ( VOID )

Get OEM/Vendor specific grayed out text color attribute.

Return values

Byte	code color setting for grayed out text color.

Definition at line 864 of file CustomizedDisplayLib.c.

◆ GetHelpTextColor()

UINT8 EFIAPI GetHelpTextColor ( VOID )

Get OEM/Vendor specific help text color attribute.

Return values

Byte	code color setting for help text color.

Definition at line 850 of file CustomizedDisplayLib.c.

◆ GetHighlightTextColor()

UINT8 EFIAPI GetHighlightTextColor ( VOID )

Get OEM/Vendor specific highlighted text color attribute.

Return values

Byte	code color setting for highlight text color.

Definition at line 878 of file CustomizedDisplayLib.c.

◆ GetInfoTextColor()

UINT8 EFIAPI GetInfoTextColor ( VOID )

Get OEM/Vendor specific info text color attribute.

Return values

Byte	code color setting for info text color.

Definition at line 836 of file CustomizedDisplayLib.c.

◆ GetPickListColor()

UINT8 EFIAPI GetPickListColor ( VOID )

Get OEM/Vendor specific PickList color attribute.

Return values

Byte	code color setting for pick list color.

Definition at line 808 of file CustomizedDisplayLib.c.

◆ GetPopupColor()

UINT8 EFIAPI GetPopupColor ( VOID )

Get OEM/Vendor specific popup attribute colors.

Return values

Byte	code color setting for popup color.

Definition at line 780 of file CustomizedDisplayLib.c.

◆ GetPopupInverseColor()

UINT8 EFIAPI GetPopupInverseColor ( VOID )

Get OEM/Vendor specific popup attribute colors.

Return values

Byte	code color setting for popup inverse color.

Definition at line 794 of file CustomizedDisplayLib.c.

◆ GetSubTitleTextColor()

UINT8 EFIAPI GetSubTitleTextColor ( VOID )

Get OEM/Vendor specific subtitle text color attribute.

Return values

Byte	code color setting for subtitle text color.

Definition at line 906 of file CustomizedDisplayLib.c.

◆ PrintCharAt()

UINTN EFIAPI PrintCharAt	(	IN UINTN	Column,
		IN UINTN	Row,
		CHAR16	Character
	)

Prints a character to the default console, at the supplied cursor position, using L"%c" format.

Parameters

Column	The cursor position to print the string at. When it is -1, use current Position.
Row	The cursor position to print the string at. When it is -1, use current Position.
Character	Character to print.

Returns: Length of string printed to the console.

Definition at line 709 of file CustomizedDisplayLib.c.

◆ PrintStringAt()

UINTN EFIAPI PrintStringAt	(	IN UINTN	Column,
		IN UINTN	Row,
		IN CHAR16 *	String
	)

Prints a unicode string to the default console, at the supplied cursor position, using L"%s" format.

Parameters

Column	The cursor position to print the string at. When it is -1, use current Position.
Row	The cursor position to print the string at. When it is -1, use current Position.
String	String pointer.

Returns: Length of string printed to the console

Definition at line 663 of file CustomizedDisplayLib.c.

◆ PrintStringAtWithWidth()

UINTN EFIAPI PrintStringAtWithWidth	(	IN UINTN	Column,
		IN UINTN	Row,
		IN CHAR16 *	String,
		IN UINTN	Width
	)

Prints a unicode string to the default console, at the supplied cursor position, using L"%s" format.

Parameters

Column	The cursor position to print the string at. When it is -1, use current Position.
Row	The cursor position to print the string at. When it is -1, use current Position.
String	String pointer.
Width	Width for String.

Returns: Length of string printed to the console

Definition at line 686 of file CustomizedDisplayLib.c.

◆ RefreshKeyHelp()

VOID EFIAPI RefreshKeyHelp	(	IN FORM_DISPLAY_ENGINE_FORM *	FormData,
		IN FORM_DISPLAY_ENGINE_STATEMENT *	Statement,
		IN BOOLEAN	Selected
	)

This function updates customized key panel's help information. The library will prepare those Strings for the basic key, ESC, Enter, Up/Down/Left/Right, +/-. and arrange them in Footer panel.

Parameters

[in]	FormData	Form Data to be shown in Page. FormData has the highlighted statement.
[in]	Statement	The statement current selected.
[in]	Selected	Whether or not a tag be selected. TRUE means Enter has hit this question.

Definition at line 127 of file CustomizedDisplayLib.c.

◆ UpdateStatusBar()

VOID EFIAPI UpdateStatusBar	(	IN UINTN	MessageType,
		IN BOOLEAN	State
	)

Update status bar.

This function updates the status bar on the bottom of menu screen. It just shows StatusBar. Original logic in this function should be splitted out.

Parameters

[in]	MessageType	The type of message to be shown. InputError or Configuration Changed.
[in]	State	Show or Clear Message.

Definition at line 356 of file CustomizedDisplayLib.c.

Variable Documentation

◆ gBannerData

BANNER_DATA* gBannerData

Definition at line 18 of file CustomizedDisplayLib.c.

◆ gClassOfVfr

UINT16 gClassOfVfr

Definition at line 16 of file CustomizedDisplayLib.c.

◆ gCustomizedDisplayLibGuid

EFI_GUID gCustomizedDisplayLibGuid

Initial value:

= {
  0x99fdc8fd, 0x849b, 0x4eba, { 0xad, 0x13, 0xfb, 0x96, 0x99, 0xc9, 0xa, 0x4d }
}

Definition at line 11 of file CustomizedDisplayLib.c.

◆ gFooterHeight

UINTN gFooterHeight

Definition at line 20 of file CustomizedDisplayLib.c.

◆ gLibIsFirstForm

BOOLEAN gLibIsFirstForm = TRUE

Definition at line 17 of file CustomizedDisplayLib.c.

◆ mCDLStringPackHandle

EFI_HII_HANDLE mCDLStringPackHandle

Definition at line 15 of file CustomizedDisplayLib.c.

Functions

Variables

Detailed Description

Function Documentation

◆ ClearDisplayPage()

◆ ClearLines()

◆ ConfirmDataChange()

◆ CreateDialog()

◆ CustomizedDisplayLibConstructor()

◆ CustomizedDisplayLibDestructor()

◆ DisplayPageFrame()

◆ FormExitPolicy()

◆ FormExitTimeout()

◆ GetArrowColor()

◆ GetFieldTextColor()

◆ GetGrayedTextColor()

◆ GetHelpTextColor()

◆ GetHighlightTextColor()

◆ GetInfoTextColor()

◆ GetPickListColor()

◆ GetPopupColor()

◆ GetPopupInverseColor()

◆ GetSubTitleTextColor()

◆ PrintCharAt()

◆ PrintStringAt()

◆ PrintStringAtWithWidth()

◆ RefreshKeyHelp()

◆ UpdateStatusBar()

Variable Documentation

◆ gBannerData

◆ gClassOfVfr

◆ gCustomizedDisplayLibGuid

◆ gFooterHeight

◆ gLibIsFirstForm

◆ mCDLStringPackHandle