次の方法で共有


CImage::GetExporterFilterString

検索のイメージを保存するために使用できるイメージを書式設定します。

static HRESULT GetExporterFilterString(
   CSimpleString& strExporters,
   CSimpleArray< GUID >& aguidFileTypes,
   LPCTSTR pszAllFilesDescription = NULL,
   DWORD dwExclude = excludeDefaultSave,
   TCHAR chSeparator = _T( '|' )
);

パラメーター

  • strExporters
    CSimpleString のオブジェクトへの参照。詳細については、[コメント] を参照してください。

  • aguidFileTypes
    文字列のファイルの種類の 1 種類に対応する各要素の GUID の配列。pszAllFilesDescription 次の例では、aguidFileTypes[0] GUID_NULL、残りの配列の値が現在のオペレーティング システムでサポートされるイメージ ファイル形式です。

    [!メモ]

    定数の一覧については、Windows SDKの イメージ ファイル形式の定数 を参照してください。

  • pszAllFilesDescription
    このパラメーターが nullである、フィルター文字列に一覧の先頭に 1 個の追加のフィルターがあります。このフィルターについての pszAllFilesDescription の現在の値があり、一覧から他のエクスポーターによってサポートされる拡張機能のファイルを受け取ります。

    以下はその例です。

    //First filter in the list will be titled "All Image Files", and
    //will accept files with any extension supported by any exporter.
    CImage::GetExporterFilterString( strExporters, aguidFileTypes, 
       _T("All Image Files"));
    
  • dwExclude
    リストから除外するためにどのファイルの種類を指定するビット フラグのセット。有効なフラグは次のとおりです:

    • excludeGIF = 0x01 は、GIF のファイルを除外します。

    • excludeBMP = (0x02 は、BMP Windows のビットマップ) ファイルを除外します。

    • excludeEMF = 0x04 では、EMF ファイル (拡張メタファイル) を除外します。

    • excludeWMF = 0x08 は、WMF (Windows メタファイル) ファイルを除外します。

    • excludeJPEG = 0x10 は JPEG ファイルを除外します。

    • excludePNG = 0x20 は、PNG ファイルは含まれません。

    • excludeTIFF = 0x40 は、TIFF ファイルを除外します。

    • excludeIcon = 0x80 は ICO (Windows のアイコン) のファイルを除外します。

    • excludeOther = 0x80000000 は上記の他のファイルの種類は含まれません。

    • excludeDefaultLoad は = 読み込みの 0、すべてのファイルの種類既定で含まれています

    • 通常、特別な要件があるためexcludeDefaultSave = 保存するための excludeIcon | excludeEMF | excludeWMF これらのファイルは、既定で除外されます。

  • chSeparator
    イメージ形式の間で使用される区切り記号。詳細については、[コメント] を参照してください。

戻り値

標準の HRESULT を返します。

解説

MFC の CFileDialog のオブジェクトに名前を付けて保存]ダイアログ ボックスで使用できるイメージ形式のファイル拡張子を公開するために発生した書式指定文字列を渡すことができます。

パラメーターの strExporter という形式です:

ファイル description0|*.ext0|filedescription1|*.ext1|…ファイルの descriptionn|*.extn||

「。|」 chSeparatorで指定された区切り記号です。以下はその例です。

"Bitmap format|*.bmp|JPEG format|*.jpg|GIF format|*.gif|PNG format|*.png||"

使用する既定の区切りを「|」MFC CFileDialog のオブジェクトにこの文字列を渡します。共通ファイルの保存]ダイアログ ボックスにこの文字列を渡す場合は null の区切りの「\ 0 "を使用します。

必要条件

ヘッダー: atlimage.h

参照

関連項目

CImage クラス

CImage::GetImporterFilterString

CFileDialog::m_ofn

CFileDialog::GetFileExt

OPENFILENAME

CFileDialog::SetDefExt