BitmapEncoder.IsThumbnailGenerated Propriété

Définition

Espace de noms:

Windows.Graphics.Imaging

Indique si une nouvelle miniature est générée automatiquement.

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

Valeur de propriété

Boolean

bool

Valeur qui indique si l’encodeur bitmap génère automatiquement une nouvelle miniature. La valeur par défaut est False.

Remarques

Lorsque cette valeur est true, l’encodeur bitmap génère une nouvelle miniature en réduisant la mise à l’échelle de l’image bitmap. La taille de la miniature est déterminée par les propriétés GeneratedThumbnailWidth et GeneratedThumbnailHeight . Lorsque cette valeur est false, aucune miniature n’est écrite dans le fichier.

Si BitmapEncoder a été créé à l’aide de la méthode CreateForTranscodingAsync et si IsThumbnailGenerated a la valeur false, l’encodeur bitmap laissera les données miniatures existantes intactes. Dans ce cas, si la bitmap a été modifiée avant l’encodage, il est possible que le fichier de sortie ait une miniature qui ne correspond pas au nouveau contenu de l’image.

Seuls les types d’images JPEG, TIFF et JPEG-XR prennent en charge les miniatures d’encodage. Si le format d’image encodé ne prend pas en charge les miniatures et que vous définissez IsThumbnailGenerated sur true, l’appel à FlushAsync échoue avec HRESULT WINCODEC_ERR_UNSUPPORTEDOPERATION. Vous devez intercepter cette exception et réessayer l’encodage avec la génération de miniatures désactivée. Si votre application encode uniquement les formats d’image qui prennent en charge les miniatures, vous pouvez ignorer cette étape.

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();
 }