microsoft/CsWin32

Inherited COM methods do not have documentation comments

已關閉

#1,391 建立於 2025年3月23日

 (0 則留言) (0 個反應) (0 位負責人)C# (123 個分叉)github user discovery
buggood first issue

倉庫指標

星標
 (2,515 顆星)
PR 合併指標
 (平均合併 16天 2小時) (30 天內合併 19 個 PR)

描述

Create the following NativeMethods.txt:

IShellDispatch2

Then open the generated Windows.Win32.IShellDispatch2.g.cs. Note that the methods defined originally in IShellDispatch2 have documentation:

/// <summary>IShellDispatch2.IsRestricted method - Retrieves a group's restriction setting from the registry.</summary>
/// <returns></returns>
/// <remarks>
/// <para>This method is implemented and accessed through the [**Shell.IsRestricted**](./shell-isrestricted.md) method. **IsRestricted** first looks for a subkey name that matches *sGroup* under the following key. </para>
/// <para>This doc was truncated.</para>
/// <para><see href="https://learn.microsoft.com/windows/win32/shell/ishelldispatch2-isrestricted#">Read more on docs.microsoft.com</see>.</para>
/// </remarks>
int IsRestricted(winmdroot.Foundation.BSTR Group, winmdroot.Foundation.BSTR Restriction);

But the methods which are defined originally in IShellDispatch and redefined in IShellDispatch2 have no documentation:

new void FileRun();

Open the generated Windows.Win32.IShellDispatch.g.cs, confirming that the original FileRun has documentation:

/// <summary>Displays the Run dialog to the user.</summary>
/// <returns>This method has no parameters.</returns>
/// <remarks>This method is implemented and accessed through the [**Shell.FileRun**](shell-filerun.md) method.</remarks>
void FileRun();

The documentation should also be generated on the re-defined methods in derived interfaces.

Context

  • CsWin32 version: 0.3.183
  • Target Framework: net9.0

貢獻者指南