次の方法で共有

OLEUICONVERTA 構造体 (oledlg.h)

  • [アーティクル]

OLE ユーザー インターフェイス ライブラリが [変換] ダイアログ ボックスを初期化するために使用する情報と、ダイアログ ボックスを閉じるときにライブラリが情報を返す領域を格納します。

構文

typedef struct tagOLEUICONVERTA {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCSTR        lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCSTR        lpszTemplate;
  HRSRC         hResource;
  CLSID         clsid;
  CLSID         clsidConvertDefault;
  CLSID         clsidActivateDefault;
  CLSID         clsidNew;
  DWORD         dvAspect;
  WORD          wFormat;
  BOOL          fIsLinkedObject;
  HGLOBAL       hMetaPict;
  LPSTR         lpszUserType;
  BOOL          fObjectsIconChanged;
  LPSTR         lpszDefLabel;
  UINT          cClsidExclude;
  LPCLSID       lpClsidExclude;
} OLEUICONVERTA, *POLEUICONVERTA, *LPOLEUICONVERTA;

メンバーズ

cbStruct

構造体のサイズ (バイト単位)。 このメンバーは入力時に入力する必要があります。

dwFlags

入力時に、このフィールドは初期化フラグと作成フラグを指定します。 終了時に、ユーザーの選択肢を指定します。 以下のフラグの組み合わせであってもよい。

価値 意味
CF_SHOWHELPBUTTON
 ダイアログ ボックスに ヘルプ ボタンが表示されます。 このフラグは入力時に設定されます。
CF_SETCONVERTDEFAULT
 clsidConvertDefault によって CLSID が指定 クラスが既定の選択として使用されます。 この選択は、[ 変換] ラジオ ボタンが選択されている場合に、クラス リスト ボックスに表示されます。 このフラグは入力時に設定されます。
CF_SETACTIVATEDEFAULT
 clsidActivateDefault によって CLSID が指定 クラスが既定の選択として使用されます。 この選択は、[ としてアクティブ化]オプション ボタンが選択されている場合に、クラス リスト ボックスに表示されます。 このフラグは入力時に設定されます。
CF_SELECTCONVERTTO
 入力時に、このフラグは、変換 が最初に選択されることを指定します (既定の動作)。 このフラグは、ユーザーがダイアログ ボックスを閉じるときに 変換 が選択されている場合に出力時に設定されます。
CF_SELECTACTIVATEAS
 入力時に、このフラグは、アクティブ化 が最初に選択されることを指定します。 このフラグは、ユーザーがダイアログ ボックス 閉じたとき アクティブ化が選択されている場合に出力時に設定されます。
CF_DISABLEDISPLAYASICON
 初期化時に アイコン ボタンが無効になります。
CF_DISABLEACTIVATEAS
 初期化時に [ アクティブ化]オプション ボタンが無効になります。
CF_HIDECHANGEICON
 [変更アイコン] ボタンは、[変換] ダイアログ ボックスに表示されません。
CF_CONVERTONLY
 [ としてアクティブ化]オプション ボタンは、[変換]ダイアログ ボックスで無効になります。

hWndOwner

ダイアログ ボックスを所有するウィンドウ。 このメンバーは NULLしないでください。

lpszCaption

ダイアログ ボックスのタイトルとして使用する文字列へのポインター。 NULL場合、ライブラリは Convertを使用します。

lpfnHook

ダイアログ ボックス用のメッセージを処理するフック関数へのポインター。 hook 関数は、ライブラリのダイアログ ボックス プロシージャに処理されなかったというメッセージを渡すために 0 を返す必要があります。 フック関数は、ライブラリのダイアログ ボックス プロシージャが既に処理しているメッセージを処理しないように、0 以外の値を返す必要があります。

lCustData

lpfnHook メンバーが指すフック関数にライブラリが渡すアプリケーション定義データ。 ライブラリは、WM_INITDIALOG メッセージの lParam パラメーター内の OLEUICONVERT 構造体へのポインターを渡します。このポインターを使用して、lCustData メンバーを取得できます。

hInstance

lpszTemplate メンバーによって指定されたダイアログ ボックス テンプレートを含むインスタンス。 lpszTemplate メンバーが NULL または無効 場合、このメンバーは無視されます。

lpszTemplate

ライブラリの Convert ダイアログ ボックス テンプレートに置き換えるダイアログ ボックス テンプレートのリソース ファイルの名前を指定する null で終わる文字列へのポインター。

hResource

カスタム ダイアログ ボックスのリソース ハンドル。 このメンバーが NULL場合、ライブラリは標準の 変換 ダイアログ ボックス テンプレートを使用します。有効な場合は、lpszTemplate によって名前が付けられたテンプレート メンバーです。

clsid

変換またはアクティブ化されるオブジェクトの CLSID。 このメンバーは入力時に設定されます。

clsidConvertDefault

[変換] が選択されているときに既定のクラスとして使用する CLSID 。 dwFlags メンバーにCF_SETCONVERTDEFAULTが含まれていない場合、このメンバーは無視されます。 このメンバーは入力時に設定されます。

clsidActivateDefault

としてアクティブ化 選択されている場合に、既定のクラスとして使用する CLSID。 dwFlags メンバーにCF_SETACTIVATEDEFAULTが含まれていない場合、このメンバーは無視されます。 このメンバーは入力時に設定されます。

clsidNew

選択したクラスの CLSID。 このメンバーは出力時に設定されます。

dvAspect

オブジェクトの側面。 これは、DVASPECT_CONTENTまたはDVASPECT_ICONである必要があります。 dvAspect 入力時にDVASPECT_ICONされている場合は、[アイコンとして表示] ボックスがオンになり、オブジェクトのアイコンが表示されます。 このメンバーは、入力と出力に設定されます。 詳細については、DVASPECTを参照してください。

wFormat

変換またはアクティブ化するオブジェクトのデータ形式。

fIsLinkedObject

オブジェクトがリンクされている場合は TRUE を します。 このメンバーは入力時に設定されます。

hMetaPict

METAFILEPICT アイコン的な側面が含まれています。 このメンバーは、入力と出力に設定されます。

lpszUserType

変換またはアクティブ化するオブジェクトのユーザー型名へのポインター。 この値が NULL場合、ダイアログ ボックスはレジストリからユーザーの種類の名前を取得します。 この文字列は終了時に解放されます。

fObjectsIconChanged

オブジェクトのアイコンが変更された場合 TRUE を します。 (つまり、OleUIChangeIcon が呼び出され、取り消されなかった場合)。 このメンバーは出力時に設定されます。

lpszDefLabel

アイコンに使用する既定のラベルへのポインター。 NULL場合は、短いユーザー型名が使用されます。 オブジェクトがリンクの場合、呼び出し元はリンク ソースの表示名を渡す必要があります。 これは終了時に解放されます。

cClsidExclude

lpClsidExclude内の CLSID の数。

lpClsidExclude

リストから除外する CLSID のリストへのポインター。

備考

手記

oledlg.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして OLEUICONVERT を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー oledlg.h

関連項目

OleUIChangeIcon

OleUIConvert