Share via


CMFCToolBarsCustomizeDialog::CheckToolsValidity

Verifies the validity of the list of user tools.

virtual BOOL CheckToolsValidity(
   const CObList& lstTools 
);

Parameters

  • [in] lstTools
    The list of user-defined tools to check.

Return Value

Returns TRUE if the list of user-defined tools is valid; otherwise FALSE. The default implementation always returns TRUE.

Remarks

The framework calls this method to verify the validity of objects that represent user-defined tools returned by CMFCToolBarsCustomizeDialog::CheckToolsValidity.

Override the CheckToolsValidity method in a class derived from CMFCToolBarsCustomizeDialog Class if you want to validate the user tools before the user closes the dialog box. If this method returns FALSE when the user clicks either the Close button in the upper-right corner of the dialog box or the button labeled Close in the lower-right corner of the dialog box, the dialog box displays the Tools tab instead of closing. If this method returns FALSE when the user clicks a tab to navigate away from the Tools tab, the navigation does not occur. You should display an appropriate message box to inform the user of the problem that caused validation to fail.

Requirements

Header: afxToolBarsCustomizeDialog.h

See Also

Reference

CMFCToolBarsCustomizeDialog Class

Hierarchy Chart