WTS_FLAGS

列挙型フラグ

基底型i4

メンバー 17

名前	10進	16進	説明
WTS_NONE	0	0x0	0x00000000。Windows 8 で導入。以下のオプションはいずれも設定されません。
WTS_EXTRACT	0	0x0	既定値。0x00000000。サムネイルがキャッシュされていない場合は抽出します。
WTS_INCACHEONLY	1	0x1	0x00000001。サムネイルがキャッシュされている場合のみ返します。
WTS_FASTEXTRACT	2	0x2	0x00000002。キャッシュされていない場合、EXIF 形式で埋め込まれているサムネイル (通常は 96x96) のみを抽出します。
WTS_FORCEEXTRACTION	4	0x4	0x00000004。キャッシュを無視して、ソースファイルからサムネイルを抽出します。
WTS_SLOWRECLAIM	8	0x8	0x00000008。サムネイルの有効期間が延長されます。固定ディスク以外のような、オフラインになる可能性のあるボリュームに使用します。
WTS_EXTRACTDONOTCACHE	32	0x20	0x00000020。抽出は行いますが、サムネイルをキャッシュに追加しません。
WTS_SCALETOREQUESTEDSIZE	64	0x40	0x00000040。Windows 7 で導入。cxyRequestedThumbSize パラメーターで要求した特定のサムネイルサイズが利用できない場合、サムネイルを要求されたサイズにリサイズします。可能であれば、より大きなビットマップを縦横比を保ったまま、必要な幅と高さに縮小します。利用可能なキャッシュ済みサムネイルが要求されたサイズよりも小さい場合は、最近傍法アルゴリズムを使用して拡大されます。
WTS_SKIPFASTEXTRACT	128	0x80	0x00000080。Windows 7 で導入。EXIF 画像のメタデータに埋め込まれたサムネイルを抽出しません。
WTS_EXTRACTINPROC	256	0x100	0x00000100。Windows 7 で導入。サムネイルハンドラーが呼び出し元と同じプロセスに読み込まれるようにします。このフラグを指定しない場合、ハンドラーはサロゲートプロセスに読み込まれ、対象ファイルの処理によって発生する予期しないクラッシュから呼び出し元を保護します。サムネイル抽出機能をデバッグするときにこの値を使用します。
WTS_CROPTOSQUARE	512	0x200	0x00000200。Windows 8 で導入。必要に応じて、ビットマップが正方形になるようにその寸法を切り取ります。最も短い辺の長さが、すべての辺の長さになります。
WTS_INSTANCESURROGATE	1024	0x400	0x00000400。Windows 8 で導入。共有の DLLHost サロゲートを使用するのではなく、このキャッシュのインスタンス用のサロゲートを作成します。
WTS_REQUIRESURROGATE	2048	0x800	0x00000800。Windows 8 で導入。抽出をサロゲート内で実行することを必須にします。
WTS_APPSTYLE	8192	0x2000	0x00002000。Windows 8 以降。プロバイダーがサポートしている場合に、WTSCF_APPSTYLE フラグを IThumbnailSettings::SetContext に渡します。
WTS_WIDETHUMBNAILS	16384	0x4000	0x00004000。Windows 8 以降。高さが幅の 0.7 倍になるように、ビットマップを引き伸ばして切り取ります。
WTS_IDEALCACHESIZEONLY	32768	0x8000	0x00008000。Windows 8 以降。理想的なキャッシュのスナップサイズからのみ返します。返される画像はより大きくなる場合がありますが、正しいキャッシュエントリから取得されます。
WTS_SCALEUP	65536	0x10000	0x00010000。Windows 8 以降。必要に応じて、指定されたサイズに高さと幅が収まるように画像を引き伸ばします。

公式ドキュメント

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

解説(Remarks)

有効な組み合わせは次のとおりです。

WTS_INCACHEONLY

WTS_FASTEXTRACT

WTS_EXTRACT

WTS_EXTRACT | WTS_SLOWRECLAIM

WTS_FORCEEXTRACTION

WTS_FORCEEXTRACTION | WTS_SLOWRECLAIM

WTS_EXTRACTDONOTCACHE

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum WTS_FLAGS : int {
    WTS_NONE = 0,
    WTS_EXTRACT = 0,
    WTS_INCACHEONLY = 1,
    WTS_FASTEXTRACT = 2,
    WTS_FORCEEXTRACTION = 4,
    WTS_SLOWRECLAIM = 8,
    WTS_EXTRACTDONOTCACHE = 32,
    WTS_SCALETOREQUESTEDSIZE = 64,
    WTS_SKIPFASTEXTRACT = 128,
    WTS_EXTRACTINPROC = 256,
    WTS_CROPTOSQUARE = 512,
    WTS_INSTANCESURROGATE = 1024,
    WTS_REQUIRESURROGATE = 2048,
    WTS_APPSTYLE = 8192,
    WTS_WIDETHUMBNAILS = 16384,
    WTS_IDEALCACHESIZEONLY = 32768,
    WTS_SCALEUP = 65536
} WTS_FLAGS;

[Flags]
public enum WTS_FLAGS : int
{
    WTS_NONE = 0,
    WTS_EXTRACT = 0,
    WTS_INCACHEONLY = 1,
    WTS_FASTEXTRACT = 2,
    WTS_FORCEEXTRACTION = 4,
    WTS_SLOWRECLAIM = 8,
    WTS_EXTRACTDONOTCACHE = 32,
    WTS_SCALETOREQUESTEDSIZE = 64,
    WTS_SKIPFASTEXTRACT = 128,
    WTS_EXTRACTINPROC = 256,
    WTS_CROPTOSQUARE = 512,
    WTS_INSTANCESURROGATE = 1024,
    WTS_REQUIRESURROGATE = 2048,
    WTS_APPSTYLE = 8192,
    WTS_WIDETHUMBNAILS = 16384,
    WTS_IDEALCACHESIZEONLY = 32768,
    WTS_SCALEUP = 65536,
}

<Flags>
Public Enum WTS_FLAGS As Integer
    WTS_NONE = 0
    WTS_EXTRACT = 0
    WTS_INCACHEONLY = 1
    WTS_FASTEXTRACT = 2
    WTS_FORCEEXTRACTION = 4
    WTS_SLOWRECLAIM = 8
    WTS_EXTRACTDONOTCACHE = 32
    WTS_SCALETOREQUESTEDSIZE = 64
    WTS_SKIPFASTEXTRACT = 128
    WTS_EXTRACTINPROC = 256
    WTS_CROPTOSQUARE = 512
    WTS_INSTANCESURROGATE = 1024
    WTS_REQUIRESURROGATE = 2048
    WTS_APPSTYLE = 8192
    WTS_WIDETHUMBNAILS = 16384
    WTS_IDEALCACHESIZEONLY = 32768
    WTS_SCALEUP = 65536
End Enum

import enum

class WTS_FLAGS(enum.IntFlag):
    WTS_NONE = 0
    WTS_EXTRACT = 0
    WTS_INCACHEONLY = 1
    WTS_FASTEXTRACT = 2
    WTS_FORCEEXTRACTION = 4
    WTS_SLOWRECLAIM = 8
    WTS_EXTRACTDONOTCACHE = 32
    WTS_SCALETOREQUESTEDSIZE = 64
    WTS_SKIPFASTEXTRACT = 128
    WTS_EXTRACTINPROC = 256
    WTS_CROPTOSQUARE = 512
    WTS_INSTANCESURROGATE = 1024
    WTS_REQUIRESURROGATE = 2048
    WTS_APPSTYLE = 8192
    WTS_WIDETHUMBNAILS = 16384
    WTS_IDEALCACHESIZEONLY = 32768
    WTS_SCALEUP = 65536

// WTS_FLAGS (flags)
pub const WTS_NONE: i32 = 0;
pub const WTS_EXTRACT: i32 = 0;
pub const WTS_INCACHEONLY: i32 = 1;
pub const WTS_FASTEXTRACT: i32 = 2;
pub const WTS_FORCEEXTRACTION: i32 = 4;
pub const WTS_SLOWRECLAIM: i32 = 8;
pub const WTS_EXTRACTDONOTCACHE: i32 = 32;
pub const WTS_SCALETOREQUESTEDSIZE: i32 = 64;
pub const WTS_SKIPFASTEXTRACT: i32 = 128;
pub const WTS_EXTRACTINPROC: i32 = 256;
pub const WTS_CROPTOSQUARE: i32 = 512;
pub const WTS_INSTANCESURROGATE: i32 = 1024;
pub const WTS_REQUIRESURROGATE: i32 = 2048;
pub const WTS_APPSTYLE: i32 = 8192;
pub const WTS_WIDETHUMBNAILS: i32 = 16384;
pub const WTS_IDEALCACHESIZEONLY: i32 = 32768;
pub const WTS_SCALEUP: i32 = 65536;

// WTS_FLAGS
const (
	WTS_NONE int32 = 0
	WTS_EXTRACT int32 = 0
	WTS_INCACHEONLY int32 = 1
	WTS_FASTEXTRACT int32 = 2
	WTS_FORCEEXTRACTION int32 = 4
	WTS_SLOWRECLAIM int32 = 8
	WTS_EXTRACTDONOTCACHE int32 = 32
	WTS_SCALETOREQUESTEDSIZE int32 = 64
	WTS_SKIPFASTEXTRACT int32 = 128
	WTS_EXTRACTINPROC int32 = 256
	WTS_CROPTOSQUARE int32 = 512
	WTS_INSTANCESURROGATE int32 = 1024
	WTS_REQUIRESURROGATE int32 = 2048
	WTS_APPSTYLE int32 = 8192
	WTS_WIDETHUMBNAILS int32 = 16384
	WTS_IDEALCACHESIZEONLY int32 = 32768
	WTS_SCALEUP int32 = 65536
)

const
  WTS_NONE = 0;
  WTS_EXTRACT = 0;
  WTS_INCACHEONLY = 1;
  WTS_FASTEXTRACT = 2;
  WTS_FORCEEXTRACTION = 4;
  WTS_SLOWRECLAIM = 8;
  WTS_EXTRACTDONOTCACHE = 32;
  WTS_SCALETOREQUESTEDSIZE = 64;
  WTS_SKIPFASTEXTRACT = 128;
  WTS_EXTRACTINPROC = 256;
  WTS_CROPTOSQUARE = 512;
  WTS_INSTANCESURROGATE = 1024;
  WTS_REQUIRESURROGATE = 2048;
  WTS_APPSTYLE = 8192;
  WTS_WIDETHUMBNAILS = 16384;
  WTS_IDEALCACHESIZEONLY = 32768;
  WTS_SCALEUP = 65536;

// WTS_FLAGS
pub const WTS_NONE: i32 = 0;
pub const WTS_EXTRACT: i32 = 0;
pub const WTS_INCACHEONLY: i32 = 1;
pub const WTS_FASTEXTRACT: i32 = 2;
pub const WTS_FORCEEXTRACTION: i32 = 4;
pub const WTS_SLOWRECLAIM: i32 = 8;
pub const WTS_EXTRACTDONOTCACHE: i32 = 32;
pub const WTS_SCALETOREQUESTEDSIZE: i32 = 64;
pub const WTS_SKIPFASTEXTRACT: i32 = 128;
pub const WTS_EXTRACTINPROC: i32 = 256;
pub const WTS_CROPTOSQUARE: i32 = 512;
pub const WTS_INSTANCESURROGATE: i32 = 1024;
pub const WTS_REQUIRESURROGATE: i32 = 2048;
pub const WTS_APPSTYLE: i32 = 8192;
pub const WTS_WIDETHUMBNAILS: i32 = 16384;
pub const WTS_IDEALCACHESIZEONLY: i32 = 32768;
pub const WTS_SCALEUP: i32 = 65536;

const
  WTS_NONE* = 0
  WTS_EXTRACT* = 0
  WTS_INCACHEONLY* = 1
  WTS_FASTEXTRACT* = 2
  WTS_FORCEEXTRACTION* = 4
  WTS_SLOWRECLAIM* = 8
  WTS_EXTRACTDONOTCACHE* = 32
  WTS_SCALETOREQUESTEDSIZE* = 64
  WTS_SKIPFASTEXTRACT* = 128
  WTS_EXTRACTINPROC* = 256
  WTS_CROPTOSQUARE* = 512
  WTS_INSTANCESURROGATE* = 1024
  WTS_REQUIRESURROGATE* = 2048
  WTS_APPSTYLE* = 8192
  WTS_WIDETHUMBNAILS* = 16384
  WTS_IDEALCACHESIZEONLY* = 32768
  WTS_SCALEUP* = 65536

enum WTS_FLAGS : int {
    WTS_NONE = 0,
    WTS_EXTRACT = 0,
    WTS_INCACHEONLY = 1,
    WTS_FASTEXTRACT = 2,
    WTS_FORCEEXTRACTION = 4,
    WTS_SLOWRECLAIM = 8,
    WTS_EXTRACTDONOTCACHE = 32,
    WTS_SCALETOREQUESTEDSIZE = 64,
    WTS_SKIPFASTEXTRACT = 128,
    WTS_EXTRACTINPROC = 256,
    WTS_CROPTOSQUARE = 512,
    WTS_INSTANCESURROGATE = 1024,
    WTS_REQUIRESURROGATE = 2048,
    WTS_APPSTYLE = 8192,
    WTS_WIDETHUMBNAILS = 16384,
    WTS_IDEALCACHESIZEONLY = 32768,
    WTS_SCALEUP = 65536,
}

#define global WTS_NONE                 0x0
#define global WTS_EXTRACT              0x0
#define global WTS_INCACHEONLY          0x1
#define global WTS_FASTEXTRACT          0x2
#define global WTS_FORCEEXTRACTION      0x4
#define global WTS_SLOWRECLAIM          0x8
#define global WTS_EXTRACTDONOTCACHE    0x20
#define global WTS_SCALETOREQUESTEDSIZE 0x40
#define global WTS_SKIPFASTEXTRACT      0x80
#define global WTS_EXTRACTINPROC        0x100
#define global WTS_CROPTOSQUARE         0x200
#define global WTS_INSTANCESURROGATE    0x400
#define global WTS_REQUIRESURROGATE     0x800
#define global WTS_APPSTYLE             0x2000
#define global WTS_WIDETHUMBNAILS       0x4000
#define global WTS_IDEALCACHESIZEONLY   0x8000
#define global WTS_SCALEUP              0x10000
; ※フラグ列挙型。ビットORで組み合わせ可(例: FOO|BAR)。