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.4x801.4=112x112 물리적 픽셀입니다. 대상 앱을 작성하는 경우 최소 및 최대 크기를 권장하지만 이러한 크기는 적용되지 않습니다. 앱에는 예기치 않은 크기인 축소판 그림을 처리하는 코드(예: 필요에 따라 스케일 업 또는 축소)가 있어야 합니다. 그러나 이미지의 가로 세로 비율을 변경하지 않도록 주의하세요.

축소판 그림에 모든 데이터 형식(JPG, GIF 등)을 사용할 수 있습니다. 디스크에서 썸네일을 로드하거나 즉시 만들 수도 있습니다.