Table of Contents

Connecting toolbars to an editor

The format toolbar, edit toolbar, and horizontal ruler are companion controls: on their own they do nothing, but once bound to a TTMSFNCRichEditor they render the matching command buttons or ruler markers and keep themselves in sync with the editor. Every companion inherits a single RichEditor property from the shared base class TTMSFNCRichEditorToolBar, so the binding is identical for all three. Reach for this pattern whenever you want a Word-style editing surface: dock the toolbars along the top, place the ruler beneath them, and let the editor fill the rest of the form.

Edit and format toolbars and a horizontal ruler docked above a rich editor Edit and format toolbars and a horizontal ruler docked above a rich editor

Binding the companions

Set each control's RichEditor property to the same editor instance. Because the property is shared through the base class, one editor can drive any combination of the three companions, and multiple toolbars can target the same editor at once.

procedure TForm1.FormCreate(Sender: TObject);
begin
  // All three companions bind to the same editor through the RichEditor
  // property they inherit from TTMSFNCRichEditorToolBar.
  TMSFNCRichEditorEditToolBar1.RichEditor     := TMSFNCRichEditor1;
  TMSFNCRichEditorFormatToolBar1.RichEditor   := TMSFNCRichEditor1;
  TMSFNCRichEditorHorizontalRuler1.RichEditor := TMSFNCRichEditor1;

  // Dock the edit and format toolbars along the top, the ruler just below
  // them, and let the editor fill the rest of the form.
  TMSFNCRichEditorEditToolBar1.Align     := TAlignLayout.Top;
  TMSFNCRichEditorFormatToolBar1.Align   := TAlignLayout.Top;
  TMSFNCRichEditorHorizontalRuler1.Align := TAlignLayout.Top;
  TMSFNCRichEditor1.Align                := TAlignLayout.Client;
end;

Docking with Align (or a TTMSFNCDockPanel) gives the classic layout: edit and format toolbars at the top, the ruler directly below them, and the editor filling the client area.

Automatic selection synchronisation

Once bound, a toolbar reflects the editor's current selection automatically — move the caret into bold text and the bold button shows as active, into a differently-sized run and the font-size picker updates. You do not wire anything for this; the companion listens to the editor and refreshes its own button and marker states. The ruler likewise mirrors the active paragraph's margins and indents.

Design-time auto-connect

When you drop a horizontal ruler on a form that already contains a TTMSFNCRichEditor, the ruler assigns that editor to its RichEditor property automatically at design time, so the ruler is live the moment it appears. You can always reassign RichEditor afterwards to target a different editor.

Pitfalls

  • Every companion needs its own RichEditor assignment. Binding the format toolbar does not bind the edit toolbar or the ruler — set RichEditor on each control you drop.
  • Clear the binding before freeing an editor you own. If you create and free the editor at runtime independently of the toolbars, the companions detect the editor being destroyed through Delphi's notification mechanism, but reassigning RichEditor to nil first keeps intent explicit.

See also