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

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

値 意味
CSF_SHOWHELP
 [ヘルプ] ボタンを有効または表示します。
CSF_VALIDSOURCE
 リンクが検証されたことを示します。
CSF_ONLYGETSOURCE
 ユーザーが [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

こちらもご覧ください

IOleUILinkContainer

OleUIChangeSource