BitmapEncoder.IsThumbnailGenerated Eigenschaft

Definition

Namespace:

Windows.Graphics.Imaging

Gibt an, ob automatisch eine neue Miniaturansicht generiert wird.

public:
 property bool IsThumbnailGenerated { bool get(); void set(bool value); };

bool IsThumbnailGenerated();

void IsThumbnailGenerated(bool value);

public bool IsThumbnailGenerated { get; set; }

var boolean = bitmapEncoder.isThumbnailGenerated;
bitmapEncoder.isThumbnailGenerated = boolean;

Public Property IsThumbnailGenerated As Boolean

Eigenschaftswert

Boolean

bool

Ein Wert, der angibt, ob der Bitmapencoder automatisch eine neue Miniaturansicht generiert. Der Standardwert ist False.

Hinweise

Wenn dieser Wert true ist, generiert der Bitmapencoder eine neue Miniaturansicht, indem die Frame-Bitmap herunterskaliert wird. Die Miniaturansichtsgröße wird durch die Eigenschaften GeneratedThumbnailWidth und GeneratedThumbnailHeight bestimmt. Wenn dieser Wert false ist, wird keine Miniaturansicht in die Datei geschrieben.

Wenn bitmapEncoder mit der CreateForTranscodingAsync-Methode erstellt wurde und IsThumbnailGenerated false ist, bleiben alle vorhandenen Miniaturansichtsdaten vom Bitmapencoder unberührt. Wenn die Bitmap vor der Codierung geändert wurde, kann die Ausgabedatei eine Miniaturansicht aufweisen, die nicht mit dem neuen Inhalt des Bilds übereinstimmt.

Nur JPEG-, TIFF- und JPEG-XR-Bildtypen unterstützen die Codierung von Miniaturansichten. Wenn das zu codierende Bildformat keine Miniaturansichten unterstützt und Sie IsThumbnailGenerated auf true festlegen, schlägt der Aufruf von FlushAsync mit HRESULT WINCODEC_ERR_UNSUPPORTEDOPERATION fehl. Sie sollten diese Ausnahme abfangen und die Codierung mit deaktivierter Miniaturansichtsgenerierung wiederholen. Wenn Ihre App nur Bildformate codiert, die Miniaturansichten unterstützen, können Sie diesen Schritt überspringen.

try
 {
     await encoder.FlushAsync();
 }
 catch (Exception err)
 {
     switch (err.HResult)
     {
         case unchecked ((int) 0x88982F81): //WINCODEC_ERR_UNSUPPORTEDOPERATION
             // If the encoder does not support writing a thumbnail, then try again
             // but disable thumbnail generation.
             encoder.IsThumbnailGenerated = false;
             break;
         default:
             throw err;
     }
 }

 if (encoder.IsThumbnailGenerated == false)
 {
     await encoder.FlushAsync();
 }