All Frameworks Class Hierarchy This Framework Indexes Previous Next

InteractiveInterfaces Interface CATIIniSearchDimensionCriterion

Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.

interface CATIIniSearchDimensionCriterion

Interface to define a dimension-based attribute criterion.
Role: This interface enables the complete definition of a search criterion on dimension attributes.
This refers to any Knowledgeware attribute that uses units. For instance, the diameter of a hole, the first length of a pad, and so on.
Such a criterion must always be used in conjunction with a , as a second argument of the criterion.

Method Index

o GetParameters(CATUnicodeString&,CATUnicodeString&,CATUnicodeString&,CATUnicodeString&,CATIniSearchEnumeration::Comparison&,CATUnicodeString&): Retrives all the parameters of the criterion.
o SetParameters(CATUnicodeString&,CATUnicodeString&,CATIniSearchEnumeration::Comparison,CATUnicodeString): Sets all the parameters of the criterion.
o SetParameters(CATUnicodeString&,CATUnicodeString&,CATUnicodeString&,CATIniSearchEnumeration::Comparison,CATUnicodeString): Sets all the parameters of the criterion.

Methods

o GetParameters

public virtual GetParameters(		`oAttributeInternalName`,
		`oValuetype`,
		`oValueAndUnit1`,
		`oValueAndUnit2`,
		`oOperatingSign`,
		`oAttributeNLSName`)

Retrives all the parameters of the criterion.
Role: This method Retrives all the parameters of the criterion. It is to be used when looking for objects having a specified attribute, whose value belongs (or not) to a range of values.

Parameters:

oAttributeInternalName: The internal name of the string attribute that is being looked for.
oValuetype: It gives us value in form "Range" or "NotRange" it depends on whether oValueAndUnit1 and oValueAndUnit2 are both present i.e. range. If only one of them is present means not range.
oValueAndUnit1: The lower limit value of the range. It is included in the search.
oValueAndUnit2: The upper limit value of the range. It is included in the search.
oOperatingSign: The value corresponding to the desired operating sign.
The only authorized values are Equal and Different.
oAttributeNLSName: This parameter is only required for printing out the query.
If no string is provided here, an NLS print of the query would display the attribute's NLS name, provided the query has been run at least once on a document containing at least one object with the specified attribute.

Returns:

E_FAIL if the criterion is not correctly set up.
S_OK otherwise.

o SetParameters

public virtual SetParameters(	const	`iAttributeInternalName`,
	const	`iValueAndUnit`,
		`iOperatingSign`,
		`iAttributeNLSName`	`=""`)

Sets all the parameters of the criterion.
Role: This method sets all the parameters of the criterion.

Parameters:

iAttributeInternalName: The internal name of the attribute that is being looked for.
To retrieve this piece of information you can proceed as follows:
Record a macro command on a scenario based on the Edit/Search command with your Search query as input (NLS based query).

Check the macro file. It contains the query under the following format: WorkbenchInternalName.TypeInternalName.iAttributeInternalName operator value
iValueAndUnit: The value and unit associated to the attribute.
For instance 3mm.
iOperatingSign: The value corresponding to the desired operating sign.
All values are authorized.
iAttributeNLSName: This parameter is only required for printing out the query.
If no string is provided here, an NLS print of the query would display the attribute's NLS name, provided the query has been run at least once on a document containing at least one object with the specified attribute.

Returns:

E_FAIL if the criterion is not correctly set up.
S_OK otherwise.

o SetParameters

public virtual SetParameters(	const	`iAttributeInternalName`,
	const	`iValueAndUnit1`,
	const	`iValueAndUnit2`,
		`iOperatingSign`,
		`iAttributeNLSName`	`=""`)

Sets all the parameters of the criterion.
Role: This method sets all the parameters of the criterion. It is to be used when looking for objects having a specified attribute, whose value belongs (or not) to a range of values.

Parameters:

iAttributeInternalName: The internal name of the string attribute that is being looked for.
To retrieve this piece of information you can proceed as follows:
Record a macro command on a scenario based on the Edit/Search command with your Search query as input (NLS based query).

Check the macro file. It contains the query under the following format: WorkbenchInternalName.TypeInternalName.iAttributeInternalName operator value
iValueAndUnit1: The lower limit value of the range. It is included in the search.
iValueAndUnit2: The upper limit value of the range. It is included in the search.
iOperatingSign: The value corresponding to the desired operating sign.
The only authorized values are Equal and Different.
iAttributeNLSName: This parameter is only required for printing out the query.
If no string is provided here, an NLS print of the query would display the attribute's NLS name, provided the query has been run at least once on a document containing at least one object with the specified attribute.

Returns:

E_FAIL if the criterion is not correctly set up.
S_OK otherwise.

This object is included in the file: CATIIniSearchDimensionCriterion.h
If needed, your Imakefile.mk should include the module: CATInteractiveInterfaces