OLEUICHANGESOURCEW 構造体 (oledlg.h)
標準の [ソースの変更 ] ダイアログ ボックスの初期化に使用される情報が含まれます。 これにより、ユーザーはリンクの宛先またはソースを変更できます。 リンクに別のファイル名を選択したり、ファイル内の項目参照を変更したりする必要がある場合があります。たとえば、リンク先のスプレッドシート内のセル範囲を変更する場合があります。
構文
typedef struct tagOLEUICHANGESOURCEW {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCWSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCWSTR lpszTemplate;
HRSRC hResource;
OPENFILENAMEW *lpOFN;
DWORD dwReserved1[4];
LPOLEUILINKCONTAINERW lpOleUILinkContainer;
DWORD dwLink;
LPWSTR lpszDisplayName;
ULONG nFileLength;
LPWSTR lpszFrom;
LPWSTR lpszTo;
} OLEUICHANGESOURCEW, *POLEUICHANGESOURCEW, *LPOLEUICHANGESOURCEW;
メンバー
cbStruct
この構造体のサイズ (バイト単位)。
dwFlags
入力時に、このフィールドは初期化フラグと作成フラグを指定します。 終了時に、ユーザーの選択肢を指定します。 以下のフラグの組み合わせであってもよい。
値 | 意味 |
---|---|
|
[ヘルプ] ボタンを有効または表示します。 |
|
リンクが検証されたことを示します。 |
|
ユーザーが [OK] を押したときにリンク ソースの自動検証を無効にします。 このフラグを指定した場合は、ダイアログ ボックスで [OK] が返されたときにソースを検証する必要があります。 |
hWndOwner
ダイアログ ボックスを所有するウィンドウ。
lpszCaption
ダイアログ ボックスのタイトルとして使用する文字列へのポインター。 NULL の場合、ライブラリは Change Source を使用します。
lpfnHook
ダイアログ ボックス用のメッセージを処理するフック関数へのポインター。 フック関数は、処理されなかったというメッセージをライブラリのダイアログ ボックス プロシージャに渡すには、0 を返す必要があります。 フック関数は、ライブラリのダイアログ ボックス プロシージャが既に処理したメッセージを処理できないように、0 以外の値を返す必要があります。
lCustData
WM_INITDIALOG メッセージの lParam パラメーターの OLEUICHANGEICON 構造体が指すフック関数にライブラリが渡すアプリケーション定義データ。このポインターを使用して、lCustData メンバーを取得できます。
hInstance
lpszTemplate メンバーによって指定されたダイアログ ボックス テンプレートを含む インスタンス。 lpszTemplate メンバーが NULL または無効な場合、このメンバーは無視されます。
lpszTemplate
ライブラリの [変換 ] ダイアログ ボックス テンプレートに置き換えるダイアログ ボックス テンプレートのリソース ファイルの名前を指定する null で終わる文字列へのポインター。
hResource
カスタム ダイアログ ボックスのリソース ハンドル。 このメンバーが NULL の場合、ライブラリは標準の [変換 ] ダイアログ ボックス テンプレートを使用するか、有効な場合は lpszTemplate メンバーによって名前が付けられたテンプレートを使用します。
lpOFN
OPENFILENAME 構造体へのポインター。オペレーティング システムがシステム定義の [開く] または [名前を付けて保存] ダイアログ ボックスを初期化するために使用する情報を含みます。
dwReserved1[4]
このメンバーは予約されています。
lpOleUILinkContainer
リンク ソースの検証に使用される IOleUILinkContainer インターフェイスのコンテナーの実装へのポインター。 [ リンクの編集] ダイアログ ボックスでは、これを使用してコンテナーがリンクを操作できるようにします。
dwLink
リンク ソースの検証に使用されるコンテナー定義の一意のリンク識別子。 lpOleUILinkContainer によって使用されます。
lpszDisplayName
完全なソース表示名へのポインター。
nFileLength
lpszDisplayName のファイル モニカー部分。
lpszFrom
変更元のソースのプレフィックスへのポインター。
lpszTo
変更先のソースのプレフィックスへのポインター。
注釈
注意
oledlg.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして OLEUICHANGESOURCE を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
Header | oledlg.h |