KlassenKlassenKlassenKlassen | | | | Operatoren

get_region_indexget_region_indexGetRegionIndexget_region_indexGetRegionIndexGetRegionIndex (Operator)

Name

get_region_indexget_region_indexGetRegionIndexget_region_indexGetRegionIndexGetRegionIndex — Ermitteln des Index aller Regionen, die einen übergebenen Punkt enthalten.

Signatur

get_region_index(Regions : : Row, Column : Index)

Herror get_region_index(const Hobject Regions, const Hlong Row, const Hlong Column, Hlong* Index)

Herror T_get_region_index(const Hobject Regions, const Htuple Row, const Htuple Column, Htuple* Index)

Herror get_region_index(Hobject Regions, const HTuple& Row, const HTuple& Column, Hlong* Index)

Herror get_region_index(Hobject Regions, const HTuple& Row, const HTuple& Column, HTuple* Index)

HTuple HRegionArray::GetRegionIndex(const HTuple& Row, const HTuple& Column) const

void GetRegionIndex(const HObject& Regions, const HTuple& Row, const HTuple& Column, HTuple* Index)

HTuple HRegion::GetRegionIndex(Hlong Row, Hlong Column) const

void HOperatorSetX.GetRegionIndex(
[in] IHUntypedObjectX* Regions, [in] VARIANT Row, [in] VARIANT Column, [out] VARIANT* Index)

VARIANT HRegionX.GetRegionIndex(
[in] Hlong Row, [in] Hlong Column)

static void HOperatorSet.GetRegionIndex(HObject regions, HTuple row, HTuple column, out HTuple index)

HTuple HRegion.GetRegionIndex(int row, int column)

Beschreibung

get_region_indexget_region_indexGetRegionIndexget_region_indexGetRegionIndexGetRegionIndex liefert den Index aller Regionen in RegionsRegionsRegionsRegionsRegionsregions (Wertebereich 1 bis n), die den Testpunkt (RowRowRowRowRowrow,ColumnColumnColumnColumnColumncolumn) enthalten, d.h.:

Die zurückgegebenen Indizes können z.B. in select_objselect_objSelectObjselect_objSelectObjSelectObj verwendet werden, um die Regionen, die den Testpunkt enthalten, zu selektieren.

Achtung

Es kann vorkommen, dass mehr als eine Region den Punkt enthält, falls sich die Regionen überlappen. In diesem Fall werden all diese Regionen ausgegeben. Falls keine Region den angegebenen Punkt enthält, wird das leere Tupel (=keine Region) ausgegeben.

Parallelisierung

Parameter

RegionsRegionsRegionsRegionsRegionsregions (input_object)  region-array objectHRegionHRegionHRegionArrayHRegionXHobject

Zu untersuchende Regionen.

RowRowRowRowRowrow (input_control)  point.y HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Zeilenindex des Testpunktes.

Defaultwert: 100

Typischer Wertebereich: Row Row Row Row Row row (lin)

ColumnColumnColumnColumnColumncolumn (input_control)  point.x HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Spaltenindex des Testpunktes.

Defaultwert: 100

Typischer Wertebereich: Column Column Column Column Column column (lin)

IndexIndexIndexIndexIndexindex (output_control)  integer(-array) HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Index der Regionen die den Testpunkt enthalten.

Komplexität

Sei F die Fläche einer Region und N die Anzahl der Regionen, dann beträgt die Laufzeitkomplexität im Mittel O(ln(sqrt(F)) * N).

Ergebnis

get_region_indexget_region_indexGetRegionIndexget_region_indexGetRegionIndexGetRegionIndex liefert den Wert 2 (H_MSG_TRUE), falls die Parameter korrekt sind. Das Verhalten bei leerer Eingabe (keine Eingaberegionen vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdthresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionconnectionConnectionConnection

Alternativen

select_region_pointselect_region_pointSelectRegionPointselect_region_pointSelectRegionPointSelectRegionPoint

Siehe auch

get_mbuttonget_mbuttonGetMbuttonget_mbuttonGetMbuttonGetMbutton, get_mpositionget_mpositionGetMpositionget_mpositionGetMpositionGetMposition, test_region_pointtest_region_pointTestRegionPointtest_region_pointTestRegionPointTestRegionPoint

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren