Skip to main content
All docs
V25.2
  • Spreadsheet Formula Bar

    • 2 minutes to read

    The TdxSpreadSheetFormulaBar control is designed to complement Spreadsheet controls with additional cell view and edit options found in many popular spreadsheet applications.

    VCL Spreadsheet: Formula Bar

    The main UI element is the Formula Editor designed to display and edit cell values. The Formula AutoComplete functionality suggests users registered functions and available defined names that match the entered portion of a recognized name.

    VCL Spreadsheet: Formula Bar Autocomplete Functionality

    Name and Button boxes are optional and offer additional cell selection and edit options:

    VCL Spreadsheet: The Name Box

    The Name box allows you to input a reference to a cell or cell range to select it in the active worksheet, or create a defined name based on the current selection. If a defined name is already assigned to a cell or cell range, a user can select it using the Name box drop-down list.

    VCL Spreadsheet: The Name Box Menu

    The Button box lists Cancel, Enter, and Insert Function buttons. The Enter and Cancel are enabled only when the Edit box is focused:

    Cancel
    Discards the current user input and returns focus to the spreadsheet control associated with the Formula Bar (the Esc keystroke equivalent).
    Enter
    Returns focus to the active cell in the associated spreadsheet control and posts the current user input to the cell (the Enter keystroke equivalent).
    Insert Function
    This button enabled when an in-place cell editor or the Edit box is inactive, or when the active editor’s value starts with the equals sign. A click on this button displays the Insert Function dialog that allows users to pick a built-in function from a complete list (that is, the All category) or a specific function category (Compatibility, for example):

    VCL Spreadsheet: The "Insert Function" Dialog

    Note

    The Shift + F3 key combination displays the Insert Function dialog under the same conditions.

    Refer to the TdxSpreadSheetFormulaBar class description for detailed information on all available options.

    See Also