TdxOfficeSearchBoxProperties.GetPaths(TObject,Char) Method
Returns all paths to a specific UI item within the current search source.
Declaration
function GetPaths(ASourceItem: TObject; const APathDelimiter: Char = dxOfficeSearchBoxDefaultPathDelimiter): TStringList; virtual;
Parameters
Name | Type |
---|---|
ASourceItem | TObject |
APathDelimiter | Char |
Returns
Type |
---|
TStringList |
Remarks
A path consists of UI items (delimited via customizable character) that a user has to click to navigate to the target item. Each bar- or ribbon-based application UI can contain the same item in different toolbars (for instance, in a ribbon group and the Quick Access Toolbar), that is, the item can have several links.
You can call this function within the OnDropDownMenuItemAdded event handler to obtain valid paths to ASourceItem as a string list and choose any of them. The GetPaths function uses the dxOfficeSearchBoxDefaultPathDelimiter global constant value as the APathDelimiter parameter if you omit a custom delimiter character.
Depending on a search source, the path can include:
Search Source | Path Description |
---|---|
Bar Manager | The captions of the corresponding toolbar and its items. |
Ribbon | The names of the tab, group, and submenu items. |