_Excel_RangeSort
Beschreibung anzeigen in
Sortiert einen Zellbereich
#include <Excel.au3>
_Excel_RangeSort ( $oWorkbook, $vWorksheet, $vRange, $vKey1 [, $iOrder1 = $xlAscending [, $iSortText = $xlSortNormal [, $iHeader = $xlNo [, $bMatchcase = False [, $iOrientation = $xlSortRows [, $vKey2 = Default [, $iOrder2 = Default [, $vKey3 = Default [, $iOrder3 = Default]]]]]]]]] )
Parameter
| $oWorkbook | Excel Arbeitsbuch-Objekt |
| $vWorksheet | Name, Index oder Arbeitsblatt-Objekt, das sortiert werden soll. Wenn das Schlüsselwort Default gesetzt ist wird das aktive Arbeitsblatt sortiert |
| $vRange | Ein Bereichsobjekt, ein A1 Bereich oder das Schlüsselwort Default um das gesamte Arbeitsblatt zu sortieren (Standard = Schlüsselwort Default) |
| $vKey1 | Definiert das erste Sortierfeld, entweder ein A1 Bereich oder ein Bereichsobjekt |
| $iOrder1 | [optional] Bestimmt die Sortierreihenfolge. Kann ein Wert aus der XlSortOrder Aufzählung sein (Standard = $xlAscending) |
| $iSortText | [optional] Gibt an, wie der Text in $vKey1, $vKey2 und $vKey3 sortiert werden soll. Kann ein Wert aus der XlSortDataOption Aufzählung sein (Standard = $xlSortNormal) |
| $iHeader | [optional] Gibt an, ob die erste Zeile Headerinformationen beinhaltet. Kann ein Wert der XlYesNoGuess Auszählung sein (Standard = $xlNo) |
| $bMatchCase | [optional] True um eine Groß- und Kleinschreibung berücksichtigende Sortierung vorzunehmen, False um sie nicht zu berücksichtigen (Standard = False) |
| $iOrientation | [optional] Gibt die Sortierungsrichtung (Zeilen oder Spalten) an. Kann ein Wert der XlSortOrientation Aufzählung sein (Standard = $xlSortColumns) |
| $vKey2 | [optional] Siehe $vKey1 |
| $iOrder2 | [optional] Siehe $iOrder1 |
| $vKey3 | [optional] Siehe $vKey1 |
| $iOrder3 | [optional] Siehe $iOrder1 |
Rückgabewert
| Erfolg: | Ein Objekt des sortierten Bereichs |
| Fehler: | 0 und setzt @error. |
| @error: | 1 - $oWorkbook ist kein Objekt oder Arbeitsbuch 2 - $vWorksheet Name oder Index ist falsch oder $vWorksheet ist kein Arbeitsblatt. @extended ist auf den COM Fehlercode gesetzt 3 - $vRange ist falsch. @extended ist auf den COM Fehlercode gesetzt 4 - $vKey1 ist falsch. @extended ist auf den COM Fehlercode gesetzt 5 - $vKey2 ist falsch. @extended ist auf den COM Fehlercode gesetzt 6 - $vKey3 ist falsch. @extended ist auf den COM Fehlercode gesetzt 7 - Fehler von der Sort-Methode wurde zurückgegeben. @extended ist auf den COM Fehlercode gesetzt |
Beispiel
Beispiel 1
#include <Excel.au3>
#include <MsgBoxConstants.au3>
; Anwendungsobjekt erstellen und eine Beispielarbeitsmappe öffnen
Local $oExcel = _Excel_Open()
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example", "Fehler beim Erstellen des Excel-Anwendungsobjekts." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
Local $oWorkbook = _Excel_BookOpen($oExcel, @ScriptDir & "\Extras\_Excel1.xls")
If @error Then
MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example", "Fehler beim Öffnen der Arbeitsmappe '" & @ScriptDir & "\Extras\_Excel1.xls'." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
_Excel_Close($oExcel)
Exit
EndIf
; Einen Bereich mit aufsteigenden Überschriften in Spalte I sortieren
MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example 1", "OK drücken, um den Bereich I1:K7 zu sortieren. Schlüssel ist Spalte I.")
_Excel_RangeSort($oWorkbook, Default, "I1:K7", "I:I", Default, Default, $xlYes)
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example 1", "Fehler beim Sortieren von Daten." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example 1", "Daten erfolgreich im Bereich I1:K7 sortiert")
Beispiel 2
#include <Excel.au3>
#include <MsgBoxConstants.au3>
; Anwendungsobjekt erstellen und eine Beispielarbeitsmappe öffnen
Local $oExcel = _Excel_Open()
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example", "Fehler beim Erstellen des Excel-Anwendungsobjekts." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
Local $oWorkbook = _Excel_BookOpen($oExcel, @ScriptDir & "\Extras\_Excel1.xls")
If @error Then
MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example", "Fehler beim Öffnen der Arbeitsmappe '" & @ScriptDir & "\Extras\_Excel1.xls'." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
_Excel_Close($oExcel)
Exit
EndIf
; Einen Bereich mit Überschriften absteigend in Spalte K sortieren. Zahlen als Text sortieren
MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example 2", "OK drücken, um den Bereich I1:K7 zu sortieren. Schlüssel ist Spalte K.")
_Excel_RangeSort($oWorkbook, Default, "I1:K7", "K:K", $xlDescending, Default, $xlYes)
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example 2", "Fehler beim Sortieren von Daten." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example 2", "Daten erfolgreich im Bereich I1:K7 sortiert")
Beispiel 3
#include <Excel.au3>
#include <MsgBoxConstants.au3>
; Anwendungsobjekt erstellen und eine Beispielarbeitsmappe öffnen
Local $oExcel = _Excel_Open()
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example", "Fehler beim Erstellen des Excel-Anwendungsobjekts." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
Local $oWorkbook = _Excel_BookOpen($oExcel, @ScriptDir & "\Extras\_Excel1.xls")
If @error Then
MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example", "Fehler beim Öffnen der Arbeitsmappe '" & @ScriptDir & "\Extras\_Excel1.xls'." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
_Excel_Close($oExcel)
Exit
EndIf
; Einen Bereich mit Überschriften absteigend in Zeile 1 sortieren (Spaltenüberschriften)
MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example 3", "OK drücken, um den Bereich I1:K7 zu sortieren. Schlüssel ist Zeile 1.")
_Excel_RangeSort($oWorkbook, Default, "I1:K7", "1:1", $xlDescending, Default, $xlYes, Default, $xlSortRows)
If @error Then Exit MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example 3", "Fehler beim Sortieren von Daten." & @CRLF & "@error = " & @error & ", @extended = " & @extended)
MsgBox($MB_SYSTEMMODAL, "Excel UDF: _Excel_RangeSort Example 3", "Daten erfolgreich im Bereich I1:K7 sortiert")