DataPackagePropertySet.Thumbnail 屬性

定義

命名空間:

Windows.ApplicationModel.DataTransfer

取得或設定 DataPackage的縮圖影像。

public:
 property IRandomAccessStreamReference ^ Thumbnail { IRandomAccessStreamReference ^ get(); void set(IRandomAccessStreamReference ^ value); };

IRandomAccessStreamReference Thumbnail();

void Thumbnail(IRandomAccessStreamReference value);

public IRandomAccessStreamReference Thumbnail { get; set; }

var iRandomAccessStreamReference = dataPackagePropertySet.thumbnail;
dataPackagePropertySet.thumbnail = iRandomAccessStreamReference;

Public Property Thumbnail As IRandomAccessStreamReference

屬性值

IRandomAccessStreamReference

代表縮圖影像的 IRandomAccessStreamReference 。

範例

此範例示範如何在與目標應用程式共用影像時，將縮圖影像新增至 DataPackage 。

void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequestDeferral deferral = e.Request.GetDeferral();
    e.Request.Data.Properties.Title = "Hello World!";
    e.Request.Data.Properties.Description = "This example shows how to share files and images.";
    if (this.dataPackageThumbnail != null)
    {
        e.Request.Data.Properties.Thumbnail = this.dataPackageThumbnail;
    }
    e.Request.Data.SetBitmap(imageStreamRef);
    deferral.Complete();
}

備註

建議您隨時建立包含影像的 DataPackage ，您也會指派縮圖影像。 這麼做可讓目標應用程式有機會在共用作業完成時，向使用者顯示所共用影像的視覺標記法。

建議的大小下限為 80x80。 大小上限為 240x160。 這些大小是以裝置無關的圖元，因此，如果系統穩定設定不是 1.0，則應該使用適當的乘數。 例如，1.4 平移的建議大小下限為 801.4x80 1.4=112x112 實體圖元。 如果您要撰寫目標應用程式，請記住，雖然我們建議大小下限和上限，但不會強制執行這些大小。 您的應用程式應該要有程式碼來處理非預期大小的縮圖，例如視需要相應增加或減少縮圖。 不過，請小心，不要改變影像的外觀比例。

您可以針對縮圖使用任何資料格式 (JPG、GIF 等) 。 您也可以選擇從磁片載入縮圖，或即時建立縮圖。