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
入力時に、このフィールドは初期化フラグと作成フラグを指定します。 終了時に、ユーザーの選択肢を指定します。 以下のフラグの組み合わせであってもよい。
hWndOwner
ダイアログ ボックスを所有するウィンドウ。 このメンバーは NULL にすることはできません。
lpszCaption
ダイアログ ボックスのタイトルとして使用する文字列へのポインター。 NULL の場合、ライブラリは Convert を使用します。
lpfnHook
ダイアログ ボックス用のメッセージを処理するフック関数へのポインター。 フック関数は、処理されなかったというメッセージをライブラリのダイアログ ボックス プロシージャに渡すには、0 を返す必要があります。 フック関数は、ライブラリのダイアログ ボックス プロシージャが既に処理したメッセージを処理できないように、0 以外の値を返す必要があります。
lCustData
ライブラリが lpfnHook メンバーが指すフック関数に渡すアプリケーション定義データ。 ライブラリは、WM_INITDIALOG メッセージの lParam パラメーターで OLEUICONVERT 構造体へのポインターを渡します。このポインターを使用して、lCustData メンバーを取得できます。
hInstance
lpszTemplate メンバーによって指定されたダイアログ ボックス テンプレートを含む インスタンス。 lpszTemplate メンバーが NULL または無効な場合、このメンバーは無視されます。
lpszTemplate
ライブラリの [変換 ] ダイアログ ボックス テンプレートに置き換えるダイアログ ボックス テンプレートのリソース ファイルの名前を指定する null で終わる文字列へのポインター。
hResource
カスタム ダイアログ ボックスのリソース ハンドル。 このメンバーが NULL の場合、ライブラリは標準の [変換 ] ダイアログ ボックス テンプレートを使用するか、有効な場合は lpszTemplate メンバーによって名前が付けられたテンプレートを使用します。
clsid
変換またはアクティブ化されるオブジェクトの CLSID。 このメンバーは入力時に設定されます。
clsidConvertDefault
[変換対象] が選択されている場合に既定のクラスとして使用 する CLSID。 dwFlags メンバーにCF_SETCONVERTDEFAULTが含まれていない場合、このメンバーは無視されます。 このメンバーは入力時に設定されます。
clsidActivateDefault
[Activate As]\(アクティブ化\) が選択されている場合に既定のクラスとして使用する CLSID。 dwFlags メンバーにCF_SETACTIVATEDEFAULTが含まれていない場合、このメンバーは無視されます。 このメンバーは入力時に設定されます。
clsidNew
選択したクラスの CLSID。 このメンバーは出力時に設定されます。
dvAspect
オブジェクトの側面。 これは、DVASPECT_CONTENTまたはDVASPECT_ICONである必要があります。 入力時に dvAspect がDVASPECT_ICONされている場合は、[ アイコンとして表示 ] ボックスがオンになり、オブジェクトのアイコンが表示されます。 このメンバーは、入出力時に設定されます。 詳細については、「 DVASPECT」を参照してください。
wFormat
変換またはアクティブ化するオブジェクトのデータ形式。
fIsLinkedObject
オブジェクト がリンクされている場合は TRUE。 このメンバーは入力時に設定されます。
hMetaPict
象徴的な側面を含む METAFILEPICT 。 このメンバーは、入出力時に設定されます。
lpszUserType
変換またはアクティブ化するオブジェクトの User Type 名へのポインター。 この値が NULL の場合、ダイアログ ボックスはレジストリからユーザーの種類の名前を取得します。 この文字列は終了時に解放されます。
fObjectsIconChanged
オブジェクト のアイコンが変更された場合は TRUE。 (つまり、 OleUIChangeIcon が呼び出され、取り消されなかった場合)。 このメンバーは出力時に設定されます。
lpszDefLabel
アイコンに使用する既定のラベルへのポインター。 NULL の場合は、短いユーザー型名が使用されます。 オブジェクトがリンクの場合、呼び出し元はリンク ソースの表示名を渡す必要があります。 これは終了時に解放されます。
cClsidExclude
lpClsidExclude 内の CLSID の数。
lpClsidExclude
リストから除外する CLSID のリストへのポインター。
注釈
注意
oledlg.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして OLEUICONVERT を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
Header | oledlg.h |