com.esri.arcgis.arcmapui
Interface IFinder

All Superinterfaces:
Serializable
All Known Implementing Classes:
FindFeatures

public interface IFinder
extends Serializable

Provides access to IFinder interface for the MxFind routine. Implement this interface to create a custom find dialog page.

Remarks

Implement the IFinder interface in order to create a custom Find tab shown in the ArcMap Find dialog.

Performing a search with a Find tab will typically return an array of features used to populate the result list that automatically appears at the bottom of the dialog. Populating this list is done with the IFindCallBack and IFeatureFindData interfaces.

Product Availability

Available with ArcGIS Desktop.


Method Summary
 void find(IFindCallBack pFindCallBack)
          Perform find functionality.
 int getColumnCount()
          Number of columns to display in list box.
 String getColumnName(int column)
          The column name.
 int getColumnWidth(int column)
          The column width in Dialog Units (1/4 of avg.
 int getHWnd()
          The window handle for the finder.
 IUID getMenuUID()
          UID of menu to popup in list box.
 String getName()
          The control name.
 void initializeControl(IApplication pApplication, IFindPanelEvents pFindEventsCallBack)
          Called to initialize control.
 void newSearch()
          New search.
 void stop()
          User requested find to stop.
 void updateControl()
          Called whenever ArcMap status changes.
 

Method Detail

initializeControl

void initializeControl(IApplication pApplication,
                       IFindPanelEvents pFindEventsCallBack)
                       throws IOException,
                              AutomationException
Called to initialize control.

Description

Called on when the Find dialog is loaded the first time.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Parameters:
pApplication - A reference to a com.esri.arcgis.framework.IApplication (in)
pFindEventsCallBack - A reference to a com.esri.arcgis.arcmapui.IFindPanelEvents (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

updateControl

void updateControl()
                   throws IOException,
                          AutomationException
Called whenever ArcMap status changes.

Description

Called by ArcMap when control needs to be redrawn.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getName

String getName()
               throws IOException,
                      AutomationException
The control name. Used for the FindUI tab.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Returns:
The name
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getColumnCount

int getColumnCount()
                   throws IOException,
                          AutomationException
Number of columns to display in list box.

Description

Return the number of columns the result list should contain.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Returns:
The columnCount
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getColumnName

String getColumnName(int column)
                     throws IOException,
                            AutomationException
The column name.

Product Availability

Available with ArcGIS Desktop.

Parameters:
column - The column (in)
Returns:
The columnName
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getColumnWidth

int getColumnWidth(int column)
                   throws IOException,
                          AutomationException
The column width in Dialog Units (1/4 of avg. char width).

Product Availability

Available with ArcGIS Desktop.

Parameters:
column - The column (in)
Returns:
The width
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMenuUID

IUID getMenuUID()
                throws IOException,
                       AutomationException
UID of menu to popup in list box.

Description

UID of the context menu that will be shown when the user right-clicks a value in the result list. The standard menu esriArcMapUI.FeatureFindContextMenu can be used.

You should set the value of IMXDocument::ContextItem to an ISet containing the features returned by the search to correctly support the use of a context menu.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Returns:
A reference to a com.esri.arcgis.system.IUID
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

find

void find(IFindCallBack pFindCallBack)
          throws IOException,
                 AutomationException
Perform find functionality.

Description

Perform the search.

Parameters such as the layer on which to perform the search and the value to search for are typically read from the controls in your tab.

You may search the layer using the IFind interface or any other selection function.

Each feature in the array corresponding to the result of the search is managed using the IFeatureFindData interface. For each feature, do set the IFeatureFindData::Layer and IFeatureFindData::ActiveView properties.

Use IFindCallBack to add these features to the result list. For each of them set the Object property and the Column values then call the AddNewRow method.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Parameters:
pFindCallBack - A reference to a com.esri.arcgis.arcmapui.IFindCallBack (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

stop

void stop()
          throws IOException,
                 AutomationException
User requested find to stop.

Description

Called when the user clicks on the Stop button.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

newSearch

void newSearch()
               throws IOException,
                      AutomationException
New search. Clear control input boxes.

Description

Called when the user clicks on the New Search button.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getHWnd

int getHWnd()
            throws IOException,
                   AutomationException
The window handle for the finder.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Returns:
The hWnd (A COM typedef)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.