TdxAuthorizationForm Class

An authorization form with an embedded browser.

Declaration

TdxAuthorizationForm = class(
    TdxCustomAuthorizationForm
)

Remarks

This authorization dialog relies on the web browser functionality of the Microsoft Shell Doc Object and Control Library (shdocvw.dll) to display a sign-in web form of a target online service. Only the authorization agents with support for embedded browsers display this authorization dialog (for instance, TdxMicrosoftGraphAPIOAuth2Authorization).

The web form prompts an end user to enter both the user name and password required to authenticate a previously registered client application in an online account. Then, the form requests the user consent to grant all permissions required by all data providers associated with the authorization agent component. If the agent receives the account authorization code as a result, the authorization form automatically closes; otherwise, it displays a sign-in error.

You can use the DefaultHeight and DefaultWidth writeable typed constants to change the initial dimensions of the authorization form.

Do not use the TdxAuthorizationForm class directly. All OAuth 2.0-compatible authorization agents with support for embedded browsers invoke the authorization form as a modal dialog automatically every time they attempt to obtain an online account authorization code.

Note

The TdxGoogleAPIOAuth2AuthorizationAgent component does not invoke this authorization form. Instead, the component invokes the default system browser to authenticate and authorize a user in a Google account.