EncoderParameter Konstruktoren

Definition

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und -Wert.

Überlädt

EncoderParameter(Encoder, Byte)	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einer 8-Bit-Ganzzahl ohne Vorzeichen. Legt die ValueType-Eigenschaft auf ValueTypeByte und die NumberOfValues-Eigenschaft auf 1 fest.
EncoderParameter(Encoder, Int32[], Int32[], Int32[], Int32[])	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und vier Arrays von 32-Bit-Ganzzahlen. Die vier Arrays stellen ein Array von Bereichen rationaler Zahlen dar. Ein rationaler Bereich ist die Menge aller Bruchzahlen von einem kleinsten Bruchwert bis zu einem größten Bruchwert. Legt die ValueType-Eigenschaft auf ValueTypeRationalRange und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im numerator1-Array fest, die gleich der Anzahl der Elemente in den anderen drei Arrays sein muss.
EncoderParameter(Encoder, Int32, Int32, Int32, Int32)	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und vier 32-Bit-Ganzzahlen. Die vier ganzen Zahlen stellen einen Bereich von Bruchzahlen dar. Die ersten beiden ganzen Zahlen stellen die kleinste Bruchzahl im Bereich dar, und die beiden anderen ganzen Zahlen stellen die größte Bruchzahl im Bereich dar. Legt die ValueType-Eigenschaft auf ValueTypeRationalRange und die NumberOfValues-Eigenschaft auf 1 fest.
EncoderParameter(Encoder, Int32, Int32)	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem Paar von 32-Bit-Ganzzahlen. Die beiden Ganzzahlen stellen einen Bruch dar, wobei die erste ganze Zahl der Zähler und die zweite ganze Zahl der Nenner ist. Legt die ValueType-Eigenschaft auf ValueTypeRational und die NumberOfValues-Eigenschaft auf 1 fest.
EncoderParameter(Encoder, Int32, Int32, Int32)	Veraltet. Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und drei ganzen Zahlen, die die Anzahl von Werten, den Datentyp der Werte und einen Zeiger auf die im EncoderParameter-Objekt gespeicherten Werte angeben.
EncoderParameter(Encoder, Int32, EncoderParameterValueType, IntPtr)	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und drei ganzen Zahlen, die die Anzahl von Werten, den Datentyp der Werte und einen Zeiger auf die im EncoderParameter-Objekt gespeicherten Werte angeben.
EncoderParameter(Encoder, Int64, Int64)	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem Paar von ganzen Zahlen mit einer Länge von 64 Bit. Die beiden ganzen Zahlen stellen einen Bereich von ganzen Zahlen dar. Dabei stellt die erste ganze Zahl die kleinste Zahl in dem Bereich dar und die zweite ganze Zahl die größte. Legt die ValueType-Eigenschaft auf ValueTypeLongRange und die NumberOfValues-Eigenschaft auf 1 fest.
EncoderParameter(Encoder, Int32[], Int32[])	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und zwei Arrays von 32-Bit-Ganzzahlen. Die beiden Arrays stellen ein Array von Bruchzahlen dar. Legt die ValueType-Eigenschaft auf ValueTypeRational und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im numerator-Array fest, die gleich der Anzahl der Elemente im denominator-Array sein muss.
EncoderParameter(Encoder, Int64[], Int64[])	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und zwei Arrays von ganzen Zahlen mit einer Länge von 64 Bit. Die beiden Arrays stellen ein Array von Ganzzahlbereichen dar. Legt die ValueType-Eigenschaft auf ValueTypeLongRange und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im rangebegin-Array fest, die gleich der Anzahl der Elemente im rangeend-Array sein muss.
EncoderParameter(Encoder, Byte, Boolean)	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem 8-Bit-Wert. Legt die ValueType-Eigenschaft auf ValueTypeUndefined oder ValueTypeByte und die NumberOfValues-Eigenschaft auf 1 fest.
EncoderParameter(Encoder, String)	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einer Zeichenfolge. Dieser Parameter wird in eine mit NULL endende ASCII-Zeichenfolge konvertiert, bevor er im EncoderParameter-Objekt gespeichert wird. Legt die ValueType-Eigenschaft auf ValueTypeAscii und die NumberOfValues-Eigenschaft auf die Länge der ASCII-Zeichenfolge einschließlich des NULL-Terminators fest.
EncoderParameter(Encoder, Int64[])	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem Array von ganzen Zahlen mit einer Länge von 64 Bit. Legt die ValueType-Eigenschaft auf ValueTypeLong (32-Bit) und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im Array fest.
EncoderParameter(Encoder, Int64)	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einer 64-Bit-Ganzzahl. Legt die ValueType-Eigenschaft auf ValueTypeLong (32 Bits) und die NumberOfValues-Eigenschaft auf 1 fest.
EncoderParameter(Encoder, Int16[])	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem Array von 16-Bit-Ganzzahlen. Legt die ValueType-Eigenschaft auf ValueTypeShort und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im Array fest.
EncoderParameter(Encoder, Int16)	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einer 16-Bit-Ganzzahl. Legt die ValueType-Eigenschaft auf ValueTypeShort und die NumberOfValues-Eigenschaft auf 1 fest.
EncoderParameter(Encoder, Byte[])	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem Array von 8-Bit-Ganzzahlen ohne Vorzeichen. Legt die ValueType-Eigenschaft auf ValueTypeByte und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im Array fest.
EncoderParameter(Encoder, Byte[], Boolean)	Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem Bytearray. Legt die ValueType-Eigenschaft auf ValueTypeUndefined oder ValueTypeByte und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im Array fest.

EncoderParameter(Encoder, Byte)

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einer 8-Bit-Ganzzahl ohne Vorzeichen. Legt die ValueType-Eigenschaft auf ValueTypeByte und die NumberOfValues-Eigenschaft auf 1 fest.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, System::Byte value);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, byte value);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * byte -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, value As Byte)

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value

Byte

Eine 8-Bit-Ganzzahl ohne Vorzeichen, die den im EncoderParameter-Objekt gespeicherten Wert angibt.

EncoderParameter(Encoder, Int32[], Int32[], Int32[], Int32[])

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und vier Arrays von 32-Bit-Ganzzahlen. Die vier Arrays stellen ein Array von Bereichen rationaler Zahlen dar. Ein rationaler Bereich ist die Menge aller Bruchzahlen von einem kleinsten Bruchwert bis zu einem größten Bruchwert. Legt die ValueType-Eigenschaft auf ValueTypeRationalRange und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im numerator1-Array fest, die gleich der Anzahl der Elemente in den anderen drei Arrays sein muss.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <int> ^ numerator1, cli::array <int> ^ denominator1, cli::array <int> ^ numerator2, cli::array <int> ^ denominator2);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int[] numerator1, int[] denominator1, int[] numerator2, int[] denominator2);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int[] * int[] * int[] * int[] -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, numerator1 As Integer(), denominator1 As Integer(), numerator2 As Integer(), denominator2 As Integer())

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

numerator1

Int32[]

Ein Array von 32-Bit-Ganzzahlen, das die Zähler der Mindestwerte für die Bereiche angibt. Die ganzen Zahlen im Array müssen positiv sein.

denominator1

Int32[]

Ein Array von 32-Bit-Ganzzahlen, das die Nenner der Mindestwerte für die Bereiche angibt. Die ganzen Zahlen im Array müssen positiv sein.

numerator2

Int32[]

Ein Array von 32-Bit-Ganzzahlen, das die Zähler der Höchstwerte für die Bereiche angibt. Die ganzen Zahlen im Array müssen positiv sein.

denominator2

Int32[]

Ein Array von 32-Bit-Ganzzahlen, das die Nenner der Höchstwerte für die Bereiche angibt. Die ganzen Zahlen im Array müssen positiv sein.

Hinweise

Der Ith-Bereich besteht aus allen Bruchzahlen von numerator1[i]/denominator1[i] bis numerator2[i]/denominator2[i]/denominator2[i].

EncoderParameter(Encoder, Int32, Int32, Int32, Int32)

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und vier 32-Bit-Ganzzahlen. Die vier ganzen Zahlen stellen einen Bereich von Bruchzahlen dar. Die ersten beiden ganzen Zahlen stellen die kleinste Bruchzahl im Bereich dar, und die beiden anderen ganzen Zahlen stellen die größte Bruchzahl im Bereich dar. Legt die ValueType-Eigenschaft auf ValueTypeRationalRange und die NumberOfValues-Eigenschaft auf 1 fest.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, int numerator1, int demoninator1, int numerator2, int demoninator2);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int numerator1, int demoninator1, int numerator2, int demoninator2);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int * int * int * int -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, numerator1 As Integer, demoninator1 As Integer, numerator2 As Integer, demoninator2 As Integer)

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

numerator1

Int32

Eine 32-Bit-Ganzzahl, die den Zähler der kleinsten Bruchzahl im Bereich darstellt. Darf nicht negativ sein.

demoninator1

Int32

Eine 32-Bit-Ganzzahl, die den Nenner der kleinsten Bruchzahl im Bereich darstellt. Darf nicht negativ sein.

numerator2

Int32

Eine 32-Bit-Ganzzahl, die den Nenner der kleinsten Bruchzahl im Bereich darstellt. Darf nicht negativ sein.

demoninator2

Int32

Eine 32-Bit-Ganzzahl, die den Zähler der größten Bruchzahl im Bereich darstellt. Darf nicht negativ sein.

EncoderParameter(Encoder, Int32, Int32)

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem Paar von 32-Bit-Ganzzahlen. Die beiden Ganzzahlen stellen einen Bruch dar, wobei die erste ganze Zahl der Zähler und die zweite ganze Zahl der Nenner ist. Legt die ValueType-Eigenschaft auf ValueTypeRational und die NumberOfValues-Eigenschaft auf 1 fest.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, int numerator, int denominator);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int numerator, int denominator);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int * int -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, numerator As Integer, denominator As Integer)

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

numerator

Int32

Eine 32-Bit-Ganzzahl, die den Zähler eines Bruchs darstellt. Darf nicht negativ sein.

denominator

Int32

Eine 32-Bit-Ganzzahl, die den Nenner eines Bruchs darstellt. Darf nicht negativ sein.

EncoderParameter(Encoder, Int32, Int32, Int32)

Quelle:

EncoderParameter.cs

Achtung

This constructor has been deprecated. Use EncoderParameter(Encoder encoder, int numberValues, EncoderParameterValueType type, IntPtr value) instead.

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und drei ganzen Zahlen, die die Anzahl von Werten, den Datentyp der Werte und einen Zeiger auf die im EncoderParameter-Objekt gespeicherten Werte angeben.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, int NumberOfValues, int Type, int Value);

[System.Obsolete("This constructor has been deprecated. Use EncoderParameter(Encoder encoder, int numberValues, EncoderParameterValueType type, IntPtr value) instead.")]
public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int NumberOfValues, int Type, int Value);

[<System.Obsolete("This constructor has been deprecated. Use EncoderParameter(Encoder encoder, int numberValues, EncoderParameterValueType type, IntPtr value) instead.")>]
new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int * int * int -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, NumberOfValues As Integer, Type As Integer, Value As Integer)

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

NumberOfValues

Int32

Eine ganze Zahl, die die Anzahl der im EncoderParameter-Objekt gespeicherten Werte angibt. Die NumberOfValues-Eigenschaft wird auf diesen Wert festgelegt.

Type

Int32

Ein Member der EncoderParameterValueType-Enumeration, der den Datentyp der im EncoderParameter-Objekt gespeicherten Werte angibt. Die Type-Eigenschaft und die ValueType-Eigenschaft werden auf diesen Wert festgelegt.

Value

Int32

Ein Zeiger auf ein Array von Werten vom durch den Type-Parameter angegebenen Typ.

Attribute

ObsoleteAttribute

Ausnahmen

InvalidOperationException

Der Typ ist kein gültiger EncoderParameterValueType.

EncoderParameter(Encoder, Int32, EncoderParameterValueType, IntPtr)

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und drei ganzen Zahlen, die die Anzahl von Werten, den Datentyp der Werte und einen Zeiger auf die im EncoderParameter-Objekt gespeicherten Werte angeben.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, int numberValues, System::Drawing::Imaging::EncoderParameterValueType type, IntPtr value);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int numberValues, System.Drawing.Imaging.EncoderParameterValueType type, IntPtr value);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int * System.Drawing.Imaging.EncoderParameterValueType * nativeint -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, numberValues As Integer, type As EncoderParameterValueType, value As IntPtr)

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

numberValues

Int32

Eine ganze Zahl, die die Anzahl der im EncoderParameter-Objekt gespeicherten Werte angibt. Die NumberOfValues-Eigenschaft wird auf diesen Wert festgelegt.

type

EncoderParameterValueType

Ein Member der EncoderParameterValueType-Enumeration, der den Datentyp der im EncoderParameter-Objekt gespeicherten Werte angibt. Die Type-Eigenschaft und die ValueType-Eigenschaft werden auf diesen Wert festgelegt.

value

IntPtr

nativeint

Ein Zeiger auf ein Array von Werten vom durch den Type-Parameter angegebenen Typ.

EncoderParameter(Encoder, Int64, Int64)

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem Paar von ganzen Zahlen mit einer Länge von 64 Bit. Die beiden ganzen Zahlen stellen einen Bereich von ganzen Zahlen dar. Dabei stellt die erste ganze Zahl die kleinste Zahl in dem Bereich dar und die zweite ganze Zahl die größte. Legt die ValueType-Eigenschaft auf ValueTypeLongRange und die NumberOfValues-Eigenschaft auf 1 fest.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, long rangebegin, long rangeend);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, long rangebegin, long rangeend);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int64 * int64 -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, rangebegin As Long, rangeend As Long)

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

rangebegin

Int64

Eine 64-Bit-Ganzzahl, die die kleinste Zahl in einem Bereich von ganzen Zahlen darstellt. Darf nicht negativ sein. Dieser Parameter wird in eine 32-Bit-Ganzzahl konvertiert, bevor er im EncoderParameter-Objekt gespeichert wird.

rangeend

Int64

Eine 64-Bit-Ganzzahl, die die größte Zahl in einem Bereich von ganzen Zahlen darstellt. Darf nicht negativ sein. Dieser Parameter wird in eine 32-Bit-Ganzzahl konvertiert, bevor er im EncoderParameter-Objekt gespeichert wird.

EncoderParameter(Encoder, Int32[], Int32[])

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und zwei Arrays von 32-Bit-Ganzzahlen. Die beiden Arrays stellen ein Array von Bruchzahlen dar. Legt die ValueType-Eigenschaft auf ValueTypeRational und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im numerator-Array fest, die gleich der Anzahl der Elemente im denominator-Array sein muss.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <int> ^ numerator, cli::array <int> ^ denominator);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, int[] numerator, int[] denominator);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int[] * int[] -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, numerator As Integer(), denominator As Integer())

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

numerator

Int32[]

Ein Array von 32-Bit-Ganzzahlen, das die Zähler der Bruchzahlen angibt. Die ganzen Zahlen im Array müssen positiv sein.

denominator

Int32[]

Ein Array von 32-Bit-Ganzzahlen, das die Nenner der Bruchzahlen angibt. Die ganzen Zahlen im Array müssen positiv sein. Ein Nenner mit einem angegebenen Index bildet ein Paar mit dem Zähler mit demselben Index.

EncoderParameter(Encoder, Int64[], Int64[])

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und zwei Arrays von ganzen Zahlen mit einer Länge von 64 Bit. Die beiden Arrays stellen ein Array von Ganzzahlbereichen dar. Legt die ValueType-Eigenschaft auf ValueTypeLongRange und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im rangebegin-Array fest, die gleich der Anzahl der Elemente im rangeend-Array sein muss.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <long> ^ rangebegin, cli::array <long> ^ rangeend);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, long[] rangebegin, long[] rangeend);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int64[] * int64[] -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, rangebegin As Long(), rangeend As Long())

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

rangebegin

Int64[]

Ein Array von 64-Bit-Ganzzahlen, das die Mindestwerte für die Ganzzahlbereiche angibt. Die ganzen Zahlen im Array müssen positiv sein. Die 64-Bit-Ganzzahlen werden in 32-Bit-Ganzzahlen konvertiert, bevor sie im EncoderParameter-Objekt gespeichert werden.

rangeend

Int64[]

Ein Array von 64-Bit-Ganzzahlen, das die Höchstwerte für die Ganzzahlbereiche angibt. Die ganzen Zahlen im Array müssen positiv sein. Die 64-Bit-Ganzzahlen werden in 32-Bit-Ganzzahlen konvertiert, bevor sie im EncoderParameters-Objekt gespeichert werden. Ein Höchstwert mit einem angegebenen Index bildet ein Paar mit dem Mindestwert mit demselben Index.

EncoderParameter(Encoder, Byte, Boolean)

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem 8-Bit-Wert. Legt die ValueType-Eigenschaft auf ValueTypeUndefined oder ValueTypeByte und die NumberOfValues-Eigenschaft auf 1 fest.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, System::Byte value, bool undefined);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, byte value, bool undefined);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * byte * bool -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, value As Byte, undefined As Boolean)

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value

Byte

Ein Byte, das den im EncoderParameter-Objekt gespeicherten Wert angibt.

undefined

Boolean

Wenn true, wird die ValueType-Eigenschaft auf ValueTypeUndefined festgelegt, andernfalls wird die ValueType-Eigenschaft auf ValueTypeByte festgelegt.

EncoderParameter(Encoder, String)

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einer Zeichenfolge. Dieser Parameter wird in eine mit NULL endende ASCII-Zeichenfolge konvertiert, bevor er im EncoderParameter-Objekt gespeichert wird. Legt die ValueType-Eigenschaft auf ValueTypeAscii und die NumberOfValues-Eigenschaft auf die Länge der ASCII-Zeichenfolge einschließlich des NULL-Terminators fest.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, System::String ^ value);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, string value);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * string -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, value As String)

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value

String

Ein String, der den im EncoderParameter-Objekt gespeicherten Wert angibt.

EncoderParameter(Encoder, Int64[])

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem Array von ganzen Zahlen mit einer Länge von 64 Bit. Legt die ValueType-Eigenschaft auf ValueTypeLong (32-Bit) und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im Array fest.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <long> ^ value);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, long[] value);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int64[] -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, value As Long())

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value

Int64[]

Ein Array von ganzen Zahlen mit einer Länge von 64 Bit, der die im EncoderParameter-Objekt gespeicherten Werte angibt. Die ganzen Zahlen im Array müssen positiv sein. Die 64-Bit-Ganzzahlen werden in 32-Bit-Ganzzahlen konvertiert, bevor sie im EncoderParameter-Objekt gespeichert werden.

EncoderParameter(Encoder, Int64)

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einer 64-Bit-Ganzzahl. Legt die ValueType-Eigenschaft auf ValueTypeLong (32 Bits) und die NumberOfValues-Eigenschaft auf 1 fest.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, long value);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, long value);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int64 -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, value As Long)

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value

Int64

Eine ganze Zahl mit einer Länge von 64 Bit, die den im EncoderParameter-Objekt gespeicherten Wert angibt. Darf nicht negativ sein. Dieser Parameter wird in eine 32-Bit-Ganzzahl konvertiert, bevor er im EncoderParameter-Objekt gespeichert wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein EncoderParameter mithilfe des EncoderParameter Konstruktors erstellt wird. Fügen Sie zum Ausführen dieses Beispiels den Code in eine Windows Form-Datei ein, und rufen Sie die VaryQualityLevel -Methode aus dem Konstruktor des Formulars auf. In diesem Beispiel ist eine Imagedatei mit dem Namen TestPhoto.jpgc:\erforderlich.

private void VaryQualityLevel()
{
    // Get a bitmap.
    Bitmap bmp1 = new Bitmap(@"c:\TestPhoto.jpg");
    ImageCodecInfo jpgEncoder = GetEncoder(ImageFormat.Jpeg);

    // Create an Encoder object based on the GUID
    // for the Quality parameter category.
    System.Drawing.Imaging.Encoder myEncoder =
        System.Drawing.Imaging.Encoder.Quality;

    // Create an EncoderParameters object.
    // An EncoderParameters object has an array of EncoderParameter
    // objects. In this case, there is only one
    // EncoderParameter object in the array.
    EncoderParameters myEncoderParameters = new EncoderParameters(1);

    EncoderParameter myEncoderParameter = new EncoderParameter(myEncoder, 50L);
    myEncoderParameters.Param[0] = myEncoderParameter;
    bmp1.Save(@"c:\TestPhotoQualityFifty.jpg", jpgEncoder, myEncoderParameters);

    myEncoderParameter = new EncoderParameter(myEncoder, 100L);
    myEncoderParameters.Param[0] = myEncoderParameter;
    bmp1.Save(@"c:\TestPhotoQualityHundred.jpg", jpgEncoder, myEncoderParameters);

    // Save the bitmap as a JPG file with zero quality level compression.
    myEncoderParameter = new EncoderParameter(myEncoder, 0L);
    myEncoderParameters.Param[0] = myEncoderParameter;
    bmp1.Save(@"c:\TestPhotoQualityZero.jpg", jpgEncoder, myEncoderParameters);
}

Private Sub VaryQualityLevel()
    ' Get a bitmap.
    Dim bmp1 As New Bitmap("c:\TestPhoto.jpg")
    Dim jpgEncoder As ImageCodecInfo = GetEncoder(ImageFormat.Jpeg)

    ' Create an Encoder object based on the GUID
    ' for the Quality parameter category.
    Dim myEncoder As System.Drawing.Imaging.Encoder = System.Drawing.Imaging.Encoder.Quality

    ' Create an EncoderParameters object.
    ' An EncoderParameters object has an array of EncoderParameter
    ' objects. In this case, there is only one
    ' EncoderParameter object in the array.
    Dim myEncoderParameters As New EncoderParameters(1)

    Dim myEncoderParameter As New EncoderParameter(myEncoder, 50&)
    myEncoderParameters.Param(0) = myEncoderParameter
    bmp1.Save("c:\TestPhotoQualityFifty.jpg", jpgEncoder, myEncoderParameters)

    myEncoderParameter = New EncoderParameter(myEncoder, 100&)
    myEncoderParameters.Param(0) = myEncoderParameter
    bmp1.Save("c:\TestPhotoQualityHundred.jpg", jpgEncoder, myEncoderParameters)

    ' Save the bitmap as a JPG file with zero quality level compression.
    myEncoderParameter = New EncoderParameter(myEncoder, 0&)
    myEncoderParameters.Param(0) = myEncoderParameter
    bmp1.Save("c:\TestPhotoQualityZero.jpg", jpgEncoder, myEncoderParameters)

End Sub

private ImageCodecInfo GetEncoder(ImageFormat format)
{
    ImageCodecInfo[] codecs = ImageCodecInfo.GetImageEncoders();

    foreach (ImageCodecInfo codec in codecs)
    {
        if (codec.FormatID == format.Guid)
        {
            return codec;
        }
    }
    
    return null;
}

Private Function GetEncoder(ByVal format As ImageFormat) As ImageCodecInfo

    Dim codecs As ImageCodecInfo() = ImageCodecInfo.GetImageEncoders()

    Dim codec As ImageCodecInfo
    For Each codec In codecs
        If codec.FormatID = format.Guid Then
            Return codec
        End If
    Next codec
    Return Nothing

End Function

EncoderParameter(Encoder, Int16[])

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem Array von 16-Bit-Ganzzahlen. Legt die ValueType-Eigenschaft auf ValueTypeShort und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im Array fest.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <short> ^ value);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, short[] value);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int16[] -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, value As Short())

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value

Int16[]

Ein Array von 16-Bit-Ganzzahlen, das die im EncoderParameter-Objekt gespeicherten Werte angibt. Die ganzen Zahlen im Array müssen positiv sein.

EncoderParameter(Encoder, Int16)

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einer 16-Bit-Ganzzahl. Legt die ValueType-Eigenschaft auf ValueTypeShort und die NumberOfValues-Eigenschaft auf 1 fest.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, short value);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, short value);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * int16 -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, value As Short)

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value

Int16

Eine 16-Bit-Ganzzahl, die den im EncoderParameter-Objekt gespeicherten Wert angibt. Darf nicht negativ sein.

EncoderParameter(Encoder, Byte[])

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem Array von 8-Bit-Ganzzahlen ohne Vorzeichen. Legt die ValueType-Eigenschaft auf ValueTypeByte und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im Array fest.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <System::Byte> ^ value);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, byte[] value);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * byte[] -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, value As Byte())

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value

Byte[]

Ein Array von 8-Bit-Ganzzahlen ohne Vorzeichen, das die im EncoderParameter-Objekt gespeicherten Werte angibt.

EncoderParameter(Encoder, Byte[], Boolean)

Quelle:

EncoderParameter.cs

Initialisiert eine neue Instanz der EncoderParameter-Klasse mit dem angegebenen Encoder-Objekt und einem Bytearray. Legt die ValueType-Eigenschaft auf ValueTypeUndefined oder ValueTypeByte und die NumberOfValues-Eigenschaft auf die Anzahl der Elemente im Array fest.

public:
 EncoderParameter(System::Drawing::Imaging::Encoder ^ encoder, cli::array <System::Byte> ^ value, bool undefined);

public EncoderParameter (System.Drawing.Imaging.Encoder encoder, byte[] value, bool undefined);

new System.Drawing.Imaging.EncoderParameter : System.Drawing.Imaging.Encoder * byte[] * bool -> System.Drawing.Imaging.EncoderParameter

Public Sub New (encoder As Encoder, value As Byte(), undefined As Boolean)

Parameter

encoder

Encoder

Ein Encoder-Objekt, das den global eindeutigen Bezeichner der Parameterkategorie kapselt.

value

Byte[]

Ein Bytearray, das die im EncoderParameter-Objekt gespeicherten Werte angibt.

undefined

Boolean

Wenn true, wird die ValueType-Eigenschaft auf ValueTypeUndefined festgelegt, andernfalls wird die ValueType-Eigenschaft auf ValueTypeByte festgelegt.