Navigation Component

Fnd_Nav_AddButtonTable

Fnd_Nav_AddButtonTable (->table{; label{; foreground color; background color}})

Legacy manual page 167

Parameters

ParameterTypeDescription
tablePointerTable
labelTextButton label (optional)
foreground colorLongintText color (optional)
background colorLongintBackground color (optional)

Description

This method adds a new button to the palette and assigns the specified table to it.

Fnd_Nav_AddButtonTable (->[Invoices])
Fnd_Nav_AddButtonTable (->[People];"Customers")

This routine calls Foundation’s IO component to display the table. If the IO component is not available, an error will occur when the button is clicked. If the Foundation Virtual Structure component is available, it will be used to determine the table name if no label is specified. Otherwise the actual table name will be used. Buttons are always added to the palette after existing palette buttons. To add a button in any other position, just use the Fnd_Nav_Delete to delete all of the existing palette buttons, then recreate the palette using Fnd_Nav_AddButtonMethod and Fnd_Nav_AddButtonTable. See the Fnd_Nav_AddButtonMethod routine for an example.

You can optionally specify the text color and background color to use for the new button. See 4D’s SET RGB COLORS command documentation for more information about specifying colors. Pass the 4D constant Default foreground color and Default background color to restore the palette’s default colors.

` Add a button with blue text and a light blue background color.
Fnd_Nav_AddButtonTable (->[Invoices];"";0x00FF;0x00C6D4FC)
Extracted source text
            Fnd_Nav_AddButtonTable (->table{; label{; foreground color; background color}})

              Parameter                Type              Description
              table                    Pointer           Table
              label                    Text              Button label (optional)
              foreground color         Longint           Text color (optional)
              background color         Longint           Background color (optional)

            This method adds a new button to the palette and assigns the specified table to it.
              Fnd_Nav_AddButtonTable (->[Invoices])
              Fnd_Nav_AddButtonTable (->[People];"Customers")

            This routine calls Foundation’s IO component to display the table. If the IO component is not available,
            an error will occur when the button is clicked.
            If the Foundation Virtual Structure component is available, it will be used to determine the table name if
            no label is specified. Otherwise the actual table name will be used.
            Buttons are always added to the palette after existing palette buttons. To add a button in any other
            position, just use the Fnd_Nav_Delete to delete all of the existing palette buttons, then recreate
            the palette using Fnd_Nav_AddButtonMethod and Fnd_Nav_AddButtonTable. See the
            Fnd_Nav_AddButtonMethod routine for an example.

            You can optionally specify the text color and background color to use for the new button. See 4D’s
            SET RGB COLORS command documentation for more information about specifying colors. Pass the
            4D constant Default foreground color and Default background color to restore the palette’s default
            colors.
                ` Add a button with blue text and a light blue background color.
              Fnd_Nav_AddButtonTable (->[Invoices];"";0x00FF;0x00C6D4FC)