sort_contours_xldsort_contours_xldSortContoursXldSortContoursXld (Operator)
Name
sort_contours_xldsort_contours_xldSortContoursXldSortContoursXld — Sortieren von Konturen aufgrund ihrer relativen Lage.
Signatur
void SortContoursXld(const HObject& Contours, HObject* SortedContours, const HTuple& SortMode, const HTuple& Order, const HTuple& RowOrCol)
HXLDCont HXLDCont::SortContoursXld(const HString& SortMode, const HString& Order, const HString& RowOrCol) const
HXLDCont HXLDCont::SortContoursXld(const char* SortMode, const char* Order, const char* RowOrCol) const
HXLDCont HXLDCont::SortContoursXld(const wchar_t* SortMode, const wchar_t* Order, const wchar_t* RowOrCol) const
(Nur Windows)
Beschreibung
sort_contours_xldsort_contours_xldSortContoursXldSortContoursXldSortContoursXld ordnet die Konturen bezüglich ihrer
relativen Position an. RowOrColRowOrColRowOrColRowOrColrowOrCol spezifiziert dabei, nach welcher
Koordinate ihrer Position die Konturen zuerst sortiert werden:
'row'"row""row""row""row" lässt die Konturen zuerst bzgl. der Zeilenkoordinate der
Position und dann bei gleichen Zeilenkoordinaten
bzgl. der verbleibenden Spaltenkoordinate sortieren. 'column'"column""column""column""column"
verwendet dagegen zuerst die Spaltenkoordinate.
Die Position einer Kontur wird dabei mit Hilfe des Parameters
SortModeSortModeSortModeSortModesortMode durch einen einzelnen Referenzpunkt festgelegt.
Hierzu stehen folgende Parameterwerte zur Verfügung:
- 'upper_left'"upper_left""upper_left""upper_left""upper_left"
-
:
Die Position wird durch die linke, obere Ecke des umschließenden
Rechtecks bestimmt.
- 'upper_right'"upper_right""upper_right""upper_right""upper_right"
-
Die Position wird durch die rechte, obere Ecke des umschließenden
Rechtecks bestimmt.
- 'lower_left'"lower_left""lower_left""lower_left""lower_left"
-
Die Position wird durch die linke, untere Ecke des umschließenden
Rechtecks bestimmt.
- 'lower_right'"lower_right""lower_right""lower_right""lower_right"
-
Die Position wird durch die rechte, untere Ecke des umschließenden
Rechtecks bestimmt.
- 'character'"character""character""character""character"
-
:
Die Position wird durch die linke, obere Ecke des umschließenden
Rechtecks bestimmt. Abweichend von 'upper_left'"upper_left""upper_left""upper_left""upper_left" wird auch
dann nach der verbleibenden Koordinate sortiert, wenn sich zwei
Konturen in der Koordinatenrichtung überlappen, welche durch
den Parameter RowOrColRowOrColRowOrColRowOrColrowOrCol definiert ist.
Der Parameter OrderOrderOrderOrderorder legt fest, ob auf- oder
absteigend sortiert wird. Bei 'true'"true""true""true""true" wird
aufsteigend bei 'false'"false""false""false""false" absteigend sortiert.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
ContoursContoursContoursContourscontours (input_object) xld_cont-array → objectHXLDContHXLDContHobject
Anzuordnende Konturen.
SortedContoursSortedContoursSortedContoursSortedContourssortedContours (output_object) xld_cont-array → objectHXLDContHXLDContHobject *
Angeordnete Konturen.
SortModeSortModeSortModeSortModesortMode (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Art der Sortierung.
Defaultwert:
'upper_left'
"upper_left"
"upper_left"
"upper_left"
"upper_left"
Werteliste: 'character'"character""character""character""character", 'lower_left'"lower_left""lower_left""lower_left""lower_left", 'lower_right'"lower_right""lower_right""lower_right""lower_right", 'upper_left'"upper_left""upper_left""upper_left""upper_left", 'upper_right'"upper_right""upper_right""upper_right""upper_right"
OrderOrderOrderOrderorder (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Aufsteigend oder absteigend sortieren.
Defaultwert:
'true'
"true"
"true"
"true"
"true"
Werteliste: 'false'"false""false""false""false", 'true'"true""true""true""true"
RowOrColRowOrColRowOrColRowOrColrowOrCol (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Anordnung erst nach Zeile oder Spalte.
Defaultwert:
'row'
"row"
"row"
"row"
"row"
Werteliste: 'column'"column""column""column""column", 'row'"row""row""row""row"
Ergebnis
Sind die Parameter korrekt, dann liefert
sort_contours_xldsort_contours_xldSortContoursXldSortContoursXldSortContoursXld den Wert 2 (H_MSG_TRUE).
Andernfalls wird eine Fehlerbehandlung durchgeführt.
Siehe auch
sort_regionsort_regionSortRegionSortRegionSortRegion
Modul
Foundation