WTS_FLAGS列挙 (thumbcache.h)

  • [アーティクル]

サムネイル画像の抽出と表示のオプションを指定するために IThumbnailCache::GetThumbnail によって使用される値。

構文

typedef enum WTS_FLAGS {
  WTS_NONE = 0,
  WTS_EXTRACT = 0,
  WTS_INCACHEONLY = 0x1,
  WTS_FASTEXTRACT = 0x2,
  WTS_FORCEEXTRACTION = 0x4,
  WTS_SLOWRECLAIM = 0x8,
  WTS_EXTRACTDONOTCACHE = 0x20,
  WTS_SCALETOREQUESTEDSIZE = 0x40,
  WTS_SKIPFASTEXTRACT = 0x80,
  WTS_EXTRACTINPROC = 0x100,
  WTS_CROPTOSQUARE = 0x200,
  WTS_INSTANCESURROGATE = 0x400,
  WTS_REQUIRESURROGATE = 0x800,
  WTS_APPSTYLE = 0x2000,
  WTS_WIDETHUMBNAILS = 0x4000,
  WTS_IDEALCACHESIZEONLY = 0x8000,
  WTS_SCALEUP = 0x10000
} ;

定数

 
WTS_NONE
値: 0
0x00000000。 Windows 8で導入されました。 次のオプションは設定しません。
WTS_EXTRACT
値: 0
既定値。 0x00000000。 サムネイルがキャッシュされていない場合は抽出します。
WTS_INCACHEONLY
値: 0x1
0x00000001。 サムネイルがキャッシュされている場合にのみ、サムネイルを返します。
WTS_FASTEXTRACT
値: 0x2
0x00000002。 キャッシュされていない場合は、EXIF 形式 (通常は 96x96) で埋め込まれている場合にのみサムネイルを抽出します。
WTS_FORCEEXTRACTION
値: 0x4
0x00000004。 キャッシュを無視し、ソース ファイルからサムネイルを抽出します。
WTS_SLOWRECLAIM
値: 0x8
0x00000008。 サムネイルの有効期間が長くなっています。 非固定ディスクなど、オフラインになる可能性があるボリュームに使用します。
WTS_EXTRACTDONOTCACHE
値: 0x20
0x00000020。 抽出しますが、サムネイルはキャッシュに追加しません。
WTS_SCALETOREQUESTEDSIZE
値: 0x40
0x00000040。 Windows 7 で導入されました。 cxyRequestedThumbSize パラメーターで要求された特定のサムネイル サイズが使用できない場合は、サムネイルのサイズを要求されたサイズに変更します。 可能であれば、必要な幅と高さに対する縦横比を維持しながら、大きなビットマップをスケールで縮小します。 使用可能なキャッシュされたサムネイルのみが要求されたサイズよりも小さい場合は、最近隣アルゴリズムを使用してスケールアップされます。
WTS_SKIPFASTEXTRACT
値: 0x80
0x00000080。 Windows 7 で導入されました。 EXIF イメージのメタデータに埋め込まれたサムネイルを抽出しないでください。
WTS_EXTRACTINPROC
値: 0x100
0x00000100。 Windows 7 で導入されました。 サムネイル ハンドラーが呼び出し元と同じプロセスで読み込まれるようにします。 このフラグが指定されていない場合、ハンドラーはサロゲート プロセスに読み込まれ、ターゲット ファイルの処理によって発生する予期しないクラッシュから呼び出し元を保護します。 サムネイル抽出器をデバッグする場合は、この値を使用します。
WTS_CROPTOSQUARE
値: 0x200
0x00000200。 Windows 8で導入されました。 必要に応じて、ビットマップの寸法を四角形にトリミングします。 最短辺の長さは、すべての辺の長さになります。
WTS_INSTANCESURROGATE
値: 0x400
0x00000400。 Windows 8で導入されました。 共有 DLLHost サロゲートを使用するのではなく、キャッシュのこのインスタンスのサロゲートを作成します。
WTS_REQUIRESURROGATE
値: 0x800
0x00000800。 Windows 8で導入されました。 サロゲートで抽出を行う必要があります。
WTS_APPSTYLE
値: 0x2000
0x00002000。 Windows 8 以降。 プロバイダーで サポート されている場合は、WTSCF_APPSTYLE フラグを IThumbnailSettings::SetContext に渡します。
WTS_WIDETHUMBNAILS
値: 0x4000
0x00004000。 Windows 8 以降。 ビットマップの高さが幅の 0.7 倍になるように拡大およびトリミングします。
WTS_IDEALCACHESIZEONLY
値: 0x8000
0x00008000。 Windows 8 以降。 理想的なキャッシュ スナップ サイズからのみ返します。 返されるイメージは大きくなる可能性がありますが、正しいキャッシュ エントリからプルされます。
WTS_SCALEUP
値: 0x10000
0x00010000。 Windows 8 以降。 必要に応じて、高さと幅が指定したサイズに収まるようにイメージを拡大します。

注釈

次の組み合わせが有効です。

WTS_INCACHEONLY
WTS_FASTEXTRACT
WTS_EXTRACT
WTS_EXTRACT |WTS_SLOWRECLAIM
WTS_FORCEEXTRACTION
WTS_FORCEEXTRACTION |WTS_SLOWRECLAIM
WTS_EXTRACTDONOTCACHE

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header thumbcache.h

こちらもご覧ください

IThumbnailCache::GetThumbnail

IThumbnailSettings::SetContext