如何使用 Sitecore ShowControlPopup 与用户进行对话交互？

Question

我根据 Data Definition Cookbook 中的内容创建了一些简单的命令，其中用户交互是右键单击某个项目 ->插入-> MyCommand 后跟一个简单的对话框，显示“您真的想这样做吗”。那太棒了。

现在我想要一个命令，允许我在对话框中与用户进行更多交互。我需要添加几个单选按钮列表，以便用户可以选择选项，然后选择一个按钮来运行命令。我想我需要为此使用 ShowControlPopup 。我创建了一个控件 (ascx) 来定义弹出窗口的外观（并发布了一个测试版本以查看它是否可以作为 Sitecore 中的基本控件运行）。但是，我不确定 ShowControlPopup 的参数到底是什么。

第一个参数称为“Id” - 我在此处放置什么 Id？使用弹出控件的项目的 id？

第二个参数称为“where” - 我猜这是弹出窗口将具有的 URL。这里是否需要存在内容项，或者它只是一个虚拟 URL？

第三个参数称为“controlId” - 我在此处放置什么 id？我已经尝试了定义弹出窗口的控件的 id，但收到一条错误消息，指出找不到该控件。

当用户在对话框中选择选项并单击“确定”时，什么处理该事件？命令类的 Run 方法或弹出控件代码隐藏中的事件处理程序？

这是我到目前为止的代码。如果尝试创建控件时失败，并出现无法找到具有提供的 id 的项目的错误。我刚刚猜测了弹出控件想要了解哪些项目。

protected void Run(Sitecore.Web.UI.Sheer.ClientPipelineArgs args)
{
 if (args.IsPostBack)
 {
  if (args.HasResult)
  { // normally code here would run when the dialog box is completed by the user.  Is that so in this case?

  }
 }
 else
 {
  Sitecore.Context.ClientPage.ClientResponse.ShowControlPopup("F3684C4C-D9EF-4796-A471-5B05553119B6",
                 "http://mysite/dummy.aspx",
                 "B8D503D0-AEBE-43AE-B924-C3849F03E90D");

  args.WaitForPostBack();
 }
}

干杯，

詹姆斯。

Sitecore 6.2 rev 091012 / Win7 32bit / IIS7 / SQLExpress 2008（仅限本地开发）

Answer 1

仅作为记录，Sitecore 支持返回了一些答案

1)“Id”是触发弹出窗口的项目的 ID

2)“Where”是相对于“Id”的位置。例如，上方、下方、右下方

3) “controlId”是弹出项目的 ID

Sitecore 中使用 ShowPopupControl 的示例是主菜单和上下文菜单。

此外，SheerUI 仍然没有文档记录，我被告知只需在 Sitecore 代码库中查找示例即可。很高兴我们可以查看 Sitecore 代码，但如果有一点指导就更好了。即使 doco 只是说“对于 ShowPopupControl 的使用，UI 示例 x 可以在 dll z 的类 y 中找到”。

命令和命令的生命周期弹出窗口可以使用弹出窗口中的代码隐藏或命令本身来完成。这取决于最终的args.WaitForPostBack()，它也可以是“args.WaitForPostBack(true)”或“args.WaitForPostBack(false)”。

最后我选择了 ShowModalDialog()，因为这实际上是我想要的，而不是用户可以点击离开的弹出窗口。

所以我的代码最终看起来像这样

protected void Run(Sitecore.Web.UI.Sheer.ClientPipelineArgs args)
{
    if (args.IsPostBack)
    {
        ;// we never come here becuase we have set waitforpostback to false.  all processing is handled by the popup control
    }
    else
    {
        Sitecore.Text.UrlString popUpUrl = new Sitecore.Text.UrlString("/sitecore/content/MYSITE/MyControlPageItem.aspx");
        popUpUrl.Append("id", args.Parameters["id"]);
        popUpUrl.Append("database", args.Parameters["database"]);
        popUpUrl.Append("language", args.Parameters["language"]);
        Sitecore.Context.ClientPage.ClientResponse.ShowModalDialog(popUpUrl.ToString(),"400", "600", "", true);

        args.WaitForPostBack(false);    // if this is true this command will wait for the modal dialog created above to close
                                        // at which time the Run method will check for postback & args
    }
}