IVsTrackProjectDocumentsEvents2.OnQueryAddFiles 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
当项目请求添加文件时,此方法将通知客户端。
public:
int OnQueryAddFiles(Microsoft::VisualStudio::Shell::Interop::IVsProject ^ pProject, int cFiles, cli::array <System::String ^> ^ rgpszMkDocuments, cli::array <Microsoft::VisualStudio::Shell::Interop::VSQUERYADDFILEFLAGS> ^ rgFlags, cli::array <Microsoft::VisualStudio::Shell::Interop::VSQUERYADDFILERESULTS> ^ pSummaryResult, cli::array <Microsoft::VisualStudio::Shell::Interop::VSQUERYADDFILERESULTS> ^ rgResults);
public:
int OnQueryAddFiles(Microsoft::VisualStudio::Shell::Interop::IVsProject ^ pProject, int cFiles, Platform::Array <Platform::String ^> ^ rgpszMkDocuments, Platform::Array <Microsoft::VisualStudio::Shell::Interop::VSQUERYADDFILEFLAGS> ^ rgFlags, Platform::Array <Microsoft::VisualStudio::Shell::Interop::VSQUERYADDFILERESULTS> ^ pSummaryResult, Platform::Array <Microsoft::VisualStudio::Shell::Interop::VSQUERYADDFILERESULTS> ^ rgResults);
int OnQueryAddFiles(Microsoft::VisualStudio::Shell::Interop::IVsProject const & pProject, int cFiles, std::Array <std::wstring const &> const & rgpszMkDocuments, std::Array <Microsoft::VisualStudio::Shell::Interop::VSQUERYADDFILEFLAGS> const & rgFlags, std::Array <Microsoft::VisualStudio::Shell::Interop::VSQUERYADDFILERESULTS> const & pSummaryResult, std::Array <Microsoft::VisualStudio::Shell::Interop::VSQUERYADDFILERESULTS> const & rgResults);
public int OnQueryAddFiles (Microsoft.VisualStudio.Shell.Interop.IVsProject pProject, int cFiles, string[] rgpszMkDocuments, Microsoft.VisualStudio.Shell.Interop.VSQUERYADDFILEFLAGS[] rgFlags, Microsoft.VisualStudio.Shell.Interop.VSQUERYADDFILERESULTS[] pSummaryResult, Microsoft.VisualStudio.Shell.Interop.VSQUERYADDFILERESULTS[] rgResults);
abstract member OnQueryAddFiles : Microsoft.VisualStudio.Shell.Interop.IVsProject * int * string[] * Microsoft.VisualStudio.Shell.Interop.VSQUERYADDFILEFLAGS[] * Microsoft.VisualStudio.Shell.Interop.VSQUERYADDFILERESULTS[] * Microsoft.VisualStudio.Shell.Interop.VSQUERYADDFILERESULTS[] -> int
Public Function OnQueryAddFiles (pProject As IVsProject, cFiles As Integer, rgpszMkDocuments As String(), rgFlags As VSQUERYADDFILEFLAGS(), pSummaryResult As VSQUERYADDFILERESULTS(), rgResults As VSQUERYADDFILERESULTS()) As Integer
参数
- pProject
- IVsProject
中请求添加文件的项目。
- cFiles
- Int32
中要添加的文件数。
- rgpszMkDocuments
- String[]
中要添加到项目中的文件的数组。
- rgFlags
- VSQUERYADDFILEFLAGS[]
中与每个文件关联的标志的数组。 有关值的列表 rgFlags ,请参阅 VSQUERYADDFILEFLAGS 。
- pSummaryResult
- VSQUERYADDFILERESULTS[]
弄Summary result 对象。 此对象是传递的文件数组的 "是" 和 "无" 结果的总和 rgpszMkDocuments 。 如果数组中的单个文件的结果为 "否",则 pSummaryResult 等于 VSQUERYADDFILERESULTS_AddNotOK ; 如果所有文件的结果都是 "是",则 pSummaryResult 等于 VSQUERYADDFILERESULTS_AddOK 。 有关值的列表 pSummaryResult ,请参阅 VSQUERYADDFILERESULTS 。
- rgResults
- VSQUERYADDFILERESULTS[]
弄每个文件的结果数组。 有关值的列表 rgResults ,请参阅 VSQUERYADDFILERESULTS 。
返回
如果该方法成功,则它会返回 S_OK。 如果该方法失败,则会返回错误代码。
注解
COM 签名
从 IVsTrackProjectDocumentsEvents2
HRESULT IVsTrackProjectDocumentsEvents2::OnQueryAddFiles(
[in] IVsProject *pProject,
[in] int cFiles,
[in, size_is(cFiles)] const LPCOLESTR rgpszMkDocuments[],
[in, size_is(cFiles)] const VSQUERYADDFILEFLAGS rgFlags[],
[out] VSQUERYADDFILERESULTS *pSummaryResult,
[out, size_is(cFiles)] VSQUERYADDFILERESULTS rgResults[]
);
使用 IVsTrackProjectDocumentEvents2.OnQueryAddFiles 指示是否可将指定的文件添加到项目。 仅在允许该操作破坏稳定状态时才拒绝查询。 例如,如果要添加的文件与已在源代码管理下的现有文件冲突,则源代码管理将拒绝添加查询。