Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxAuthorizationForm Class

An authorization form with an embedded browser.

#Declaration

Delphi
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.

See Also