dxShowMessageFmt(string,Untyped[],TdxMessageDialogHyperlinkClickDelegate,TdxMessageDialogShowHyperlinkHintDelegate,TdxMessageDialogHintedTextClickDelegate,TdxMessageDialogShowTextHintDelegate) Method

Opens a generic message dialog box with a formatted message and an OK button.

Declaration

procedure dxShowMessageFmt(const AMessage: string; AArguments; const AHyperlinkClickProc: TdxMessageDialogHyperlinkClickDelegate = nil; const AShowHyperlinkHintProc: TdxMessageDialogShowHyperlinkHintDelegate = nil; const AHintedTextClickProc: TdxMessageDialogHintedTextClickDelegate = nil; const AShowTextHintProc: TdxMessageDialogShowTextHintDelegate = nil);

Parameters

Name	Type	Description
AMessage	string	Message dialog box content. The AMessage parameter value initializes the created form’s Message property. The AMessage parameter supports a set of BBCode-inspired tags that allow you to format message box content. In addition, dxShowMessageFmt allows you to define placeholders within the message and fill these placeholders using the AArguments parameter as a source. Placeholders follow the same syntax used by the system Format function.
AArguments	Specifies arguments used to fill placeholders in a formatting pattern defined within a content string passed as the AMessage parameter as demonstrated in the following code example: Display a Generic Message Dialog with a Templated Message.
AHyperlinkClickProc	TdxMessageDialogHyperlinkClickDelegate	Optional. A procedure that handles clicks on hyperlinks in the displayed message. For example, use this procedure to identify the clicked hyperlink and prevent specific links from being activated. This parameter value initializes the HyperlinkClickProc property of the created message dialog box form. Refer to the procedural type description for detailed information and a code example: TdxMessageDialogHyperlinkClickDelegate.
AShowHyperlinkHintProc	TdxMessageDialogShowHyperlinkHintDelegate	Optional. A procedure that handles hyperlink hint display events. For example, use this procedure to modify the predefined hint message (the hyperlink target URI) based on conditions in your application. This parameter value initializes the ShowHyperlinkHintProc property of the created message dialog box form. Refer to the procedural type description for detailed information and a code example: TdxMessageDialogShowHyperlinkHintDelegate
AHintedTextClickProc	TdxMessageDialogHintedTextClickDelegate	Optional. A procedure that handles clicks on hint-marked text ranges in the displayed message. For example, use this procedure to identify the clicked text range. This parameter value initializes the HintedTextClickProc property of the created message dialog box form. Refer to the procedural type description for detailed information and a code example: TdxMessageDialogHintedTextClickDelegate.
AShowTextHintProc	TdxMessageDialogShowTextHintDelegate	Optional. A procedure that handles hint display events for hint-marked text ranges enclosed between [HINT] and [\HINT] tags. For example, use this procedure to modify the hint message based on conditions in your application. This parameter value initializes the ShowTextHintProc property of the created message dialog box form. Refer to the procedural type description for detailed information and a code example: TdxMessageDialogShowTextHintDelegate.

Remarks

Call the dxShowMessageFmt procedure to display a generic message dialog box with a formatted message and an OK button. The message box uses the Application.Title value as the title.

Code Example: Display a Generic Message Dialog with a Templated Message

The code example in this section prepares a message template string that includes %s placeholders and a source array containing two strings (as placeholder values). The demonstrated dxShowMessageFmt procedure displays a message dialog box with a message generated from the message template and the source array.

Delphi

uses
  dxMessageDialog, // Declares the dxShowMessageFmt method
  Winapi.Windows;  // Declares WinAPI constants
// ...

procedure TMyForm.DemonstrateDxShowMessageFmt1;
var
  AHelpURL, AMessage, ATitleURL: string;
begin
  // Define a formatted message template with hyperlinks (using the BBCode-inspired markup)
  AHelpURL := 'https://docs.devexpress.com/VCL/dxMessageDialog.dxShowMessageFmt(D5C2B558)';
  ATitleURL := 'https://docwiki.embarcadero.com/Libraries/en/Vcl.Forms.TApplication.Title';
  AMessage := 
    '[URL=%s]dxShowMessageFmt[/URL] displays a generic message dialog box ' +
    'with a formatted message ([B]AMessage[/B]) and an [B]OK[/B] button.' +
    sLineBreak + sLineBreak + 'The message box has no icon and uses the ' +
    '[URL=%s]Application.Title[/URL] value as the title.';

  dxShowMessageFmt(AMessage, [AHelpURL, ATitleURL]); // Displays a formatted message dialog box
end;

C++

#include "dxMessageDialog.hpp" // Declares the dxShowMessageFmt method
#include <Winapi.Windows.hpp> // Declares WinAPI constants

// Add the following linker directive to the corresponding CPP source file:
#pragma link "dxMessageDialog" // Required to use dxMessageDialog.hpp declarations
// ...

void __fastcall TMyForm::DemonstrateDxShowMessageFmt1()
{
  UnicodeString AMessage, AHelpURL, ATitleURL;

  // Define a formatted message template with hyperlinks (using the BBCode-inspired markup)
  AHelpURL = "https://docs.devexpress.com/VCL/dxMessageDialog.dxShowMessageFmt(D5C2B558)";
  ATitleURL = "https://docwiki.embarcadero.com/Libraries/en/Vcl.Forms.TApplication.Title";
  AMessage = UnicodeString(
    "[URL=%s]dxShowMessageFmt[/URL] displays a generic message dialog box "
    "with a formatted message ([B]AMessage[/B]) and an [B]OK[/B] button.") +
    sLineBreak + sLineBreak + "The message box has no icon and uses the "
    "[URL=%s]Application.Title[/URL] value as the title.";

  // Display a formatted message dialog box
  dxShowMessageFmt(AMessage, ARRAYOFCONST((AHelpURL, ATitleURL))); 
}