SearchDataSourcesBox

Inheritance Hierarchy

          IComponent

          IControl

          ISearchDataSourcesBox

          SearchDataSourcesBox

Description

The SearchDataSourcesBox component is used to start BI search and display its results.

Comments

BI search is a full-text search of data by keywords in the structure of multidimensional repository sources. To use BI search on working with BI server, set up repository and index data sources. See setup instructions in the Installing and Setting Up BI Search Service subsection.

To start BI search, call the StartSearch method with specifying required text. The search can be tracked using the OnStartSearch - OnFinishSearch events. When the search is finished, the total number of found matches will be available in the TotalCount property, and first hundred elements with results will be loaded to the Items collection. To load next elements, use the LoadNextPage method.

Example

Properties of the SearchDataSourcesBox Component

  Property name Brief description
The Align property determines behavior of the component when its parent component is resized.
The AllowDrag property determines whether an object can be dragged from the component.
The AllowDrop property determines whether the component can accept a dragged object.
The Anchors property returns settings determining % of the size change for the current component when the parent component is resized.
The Brush property determines the brush that is used to fill component area.
The ClientHeight property is used to receive or specify the height of the component’s client area.
The ClientWidth property is used to receive or specify the width of the component’s client area.
The Color property determines a component background color.
The ComponentCount property returns the number of child components.
The Components property returns the child component.
The Cursor property determines the look of the cursor over the component.
The Data property is used to store any custom data.
The Enabled property determines whether the component is available for the user.
The Focused property returns True if the focus is set on the component.
The Font property determines the set of characteristics describing the font that is used to display text.
The Height property determines component height.
The HelpContext property determines a unique index for the context help section for this component.
The Hint property determines a component tooltip text.
The HintTimeout determines the time, for which a tooltip is displayed.
The IsAllDataLoaded property returns the checkbox that specifies whether all element with search results are loaded to component area.
The Items property returns collection of elements with search results.
The Left property determines the coordinate of the left border of the component.
The Name property determines a component name.
The Parent property determines a parent component.
The ParentColor property determines whether the component inherits the color of the parent component.
The ParentFont property determines whether the component uses the font of the parent component.
The ParentShowHint property determines whether a tooltip is displayed.
The PopupMenu property determines the context menu to be displayed on right-click on the component.
The ShowHint property enables and disables showing a component tooltip.
The TabOrder property determines the component position in the tab order.
The TabStop property determines whether the component is focused when the Tab key is pressed.
The Tag property is not used by the compiler. The user can change the value of the Tag property and use it as he wishes.
The Text property determines the row identifying a component for the user.
The Top property determines the coordinate of the top border of the component.
The TotalCount property returns the total number of found matches.
The Visible property determines visibility of the component during execution.
The Width property determines component width.

Methods of the SearchDataSourcesBox Component

  Method name Brief description
The BringToFront method brings a component to front.
The CancelSearch method aborts BI search.
The ClientToScreen method converts the coordinates of a point specified relative to the component coordinate system into screen coordinates.
The DoDragDrop method enables the user to start dragging operation.
The GetImage method returns the image of the component with all the child components.
The LoadNextPage method continues search and loads the next set of elements with search results to the component area.
The ScreenToClient method converts screen coordinates of a point into coordinates specified relative to the component coordinate system.
The SendToBack method sends a component to back.
The SetFocus method sets focus to this component.
The StartSearch method starts BI search.

Events of the SearchDataSourcesBox Component

  Event name Brief description
The OnAfterSelectionChange event occurs after selecting element with search result in the component area.
The OnBeforeSelectionChange event occurs before selecting element with search result in the component area.
The OnBeginDrag event occurs for a component when the user starts to drag an object from the component.
The OnCancelSearch event occurs at the moment of force cancel of BI search.
The OnClick event occurs if the user clicks the component area with the main mouse button.
The OnControlMove event occurs when the component is moved
The OnControlResize event occurs when the component is resized
The OnDblClick event occurs if the user double-clicks a component area with the mouse button.
The OnDragDrop event occurs for the component if the user drops the dragged object over it.
The OnDragEnter event occurs when a dragged object crosses the borders of this component.
The OnDragLeave event occurs when a dragged object leaves the borders of this component.
The OnDragOver event occurs for the component when the user drags an object over it.
The OnEnter event occurs when the component receives focus.
The OnExit event occurs when the component loses focus.
The OnFinishSearch event occurs at the moment of BI search finish.
The OnHScroll event occurs when horizontal scrollbar slider changes its position
The OnKeyDown event occurs if the component is focused and the keyboard key is pressed.
The OnKeyPress event occurs if the component is focused when the user presses a character key.
The OnKeyPreview event occurs prior to each event related to clicking mouse buttons
The OnKeyUp event occurs if the component is focused and the user releases any button previously pressed.
The OnMouseDown event occurs if the component is focused and any of the mouse buttons is pressed.
The OnMouseEnter event occurs when the mouse cursor enters the component area
The OnMouseHover event occurs when the mouse cursor is held in the component area
The OnMouseLeave event occurs when the mouse cursor leaves the component area
The OnMouseMove event occurs when the user moves the cursor over the component.
The OnMouseUp event occurs if the component is focused, and any of the previously pressed mouse buttons is released.
The OnMouseWheel event occurs if the component is focused when the mouse wheel is rotated.
The OnStartSearch event occurs at the moment of BI search start.
The OnVScroll event occurs when vertical scrollbar slider changes its position

See also:

Additional Components