UI2.ShowModalDialog(String, Object, Object, Object, Object, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отображает пользовательское модальное диалоговое окно в форме Microsoft InfoPath.
public:
System::Object ^ ShowModalDialog(System::String ^ bstrName, System::Object ^ varArguments, System::Object ^ varHeight, System::Object ^ varWidth, System::Object ^ varTop, System::Object ^ varLeft);
public object ShowModalDialog (string bstrName, object varArguments, object varHeight, object varWidth, object varTop, object varLeft);
abstract member ShowModalDialog : string * obj * obj * obj * obj * obj -> obj
Public Function ShowModalDialog (bstrName As String, varArguments As Object, varHeight As Object, varWidth As Object, varTop As Object, varLeft As Object) As Object
Параметры
- bstrName
- String
Имя HTML-файла, используемого для модального диалогового окна.
- varArguments
- Object
Указывает аргументы для использования при отображении модального диалогового окна. Значение может быть любого типа, включая массив значений.
- varHeight
- Object
Задает высоту модального диалогового окна.
- varWidth
- Object
Задает ширину модального диалогового окна.
- varTop
- Object
Задает верхнюю границу модального диалогового окна относительно левого верхнего угла рабочего стола.
- varLeft
- Object
Задает левую границу модального диалогового окна относительно левого верхнего угла рабочего стола
Возвращаемое значение
object), указывающий способ отображения модального диалогового окна.
Реализации
Примеры
В следующем примере метод UIObjectShowModalDialog объекта используется для отображения настраиваемого диалогового окна. Обратите внимание, что XDocument объект передается в пользовательское диалоговое varArguments
окно с помощью параметра .
thisXDocument.UI.<span class="label">ShowModalDialog</span>("show.htm",(object)thisXDocument,100,100,10,10);
В следующем примере приведен код HTML, используемый для реализации простого диалогового окна. Обратите внимание на использование свойства dialogArguments объекта окна DHTML для получения значений, переданных диалоговому окну, которым в данном случае является объект XDocument объектной модели InfoPath из метода ShowModalDialog. Когда пользователь нажимает кнопку Отобразить предупреждение в настраиваемом диалоговом окне, в окне сообщения отображается исходный XML базового документа XML формы.
<html>
<head>
<script language="jscript">
var gobjXDocument = null;
function Initialize()
{
// Save a reference to the XDocument object.
if (typeof window.dialogArguments == "object")
gobjXDocument = window.dialogArguments;
}
</script>
<title>A Simple Custom Dialog Box</title>
</head>
<body style="BACKGROUND-COLOR: window" onLoad="Initialize()">
<strong>Click one of the following buttons:</strong>
<br/>
<br/>
<div id="divButtons" tyle="align:center">
<input id="btnShowAlert" style="WIDTH: 106px; HEIGHT: 24px"
onclick='gobjXDocument.UI.Alert(gobjXDocument.DOM.xml);'
type="button" size="21" value="Show Alert"></input>
<input id="btnCancel" style="WIDTH: 106px; HEIGHT: 24px"
onclick="window.close();" type="button" size="21"
value="Cancel"></input>
</div>
</body>
</html>
Сведения об использовании метода Поля ShowModalDialog см. в статье Практическое руководство. Отображение оповещений и диалоговых окон (объектная модель InfoPath 2003).
Комментарии
Метод ShowModalDialog позволяет отображать настраиваемые диалоговые окна по мере заполнения пользователем полностью доверенных форм. Настраиваемые диалоговые окна реализуются как HTML-файлы, созданные в любом редакторе HTML, например, Microsoft FrontPage. Код скриптов можно использовать в настраиваемом диалоговом окне, которое взаимодействует с объектной моделью InfoPath, если вы передаете объекты в пользовательское диалоговое varArguments
окно с помощью параметра .
Для использования настраиваемого диалогового окна в форме InfoPath необходимо сначала добавить файл HTML этого диалогового окна к набору файлов ресурсов формы, используя диалоговое окно "Файлы ресурсов". Диалоговое окно "Файлы ресурсов" доступно в меню "Сервис" в режиме конструктора. После добавления диалогового окна к форме можно использовать метод ShowModalDialog для его отображения.
Хотя метод ShowModalDialog использовать только для полностью доверенных форм, можно создавать настраиваемые диалоговые окна в стандартных формах, используя метод showModalDialog объектной модели динамического HTML (DHTML), если в форме указана область задач HTML, или используя форму Windows.
Важно! Доступ к этому участнику можно получить только с помощью форм, открытых из шаблона формы, настроенного для запуска с полным доверием с помощью категории Безопасность и доверие диалогового окна Параметры формы. Этому элементу необходимо полное доверие для непосредственного вызывающего объекта и он не может использоваться в коде с частичным доверием. Дополнительные сведения см. в библиотеке "Использование библиотек из не вполне надежного кода" на веб-сайте MSDN.