Метод UI2.ShowModalDialog

Статья
04/27/2010

Отображает настраиваемое модальное диалоговое окно в форме Microsoft Office InfoPath 2007.

Этот метод несовместим с CLS.

Пространство имен: Microsoft.Office.Interop.InfoPath.SemiTrust
Сборка: Microsoft.Office.Interop.InfoPath.SemiTrust (в microsoft.office.interop.infopath.semitrust.dll)

Синтаксис

'Декларация
<DispIdAttribute(2)> _
Function ShowModalDialog ( _
    bstrName As String, _
    varArguments As Object, _
    varHeight As Object, _
    varWidth As Object, _
    varTop As Object, _
    varLeft As Object _
) As Object
'Применение
Dim instance As UI2
Dim bstrName As String
Dim varArguments As Object
Dim varHeight As Object
Dim varWidth As Object
Dim varTop As Object
Dim varLeft As Object
Dim returnValue As Object

returnValue = instance.ShowModalDialog(bstrName, varArguments, varHeight, varWidth, varTop, varLeft)

[DispIdAttribute(2)] 
Object ShowModalDialog (
    string bstrName,
    Object varArguments,
    Object varHeight,
    Object varWidth,
    Object varTop,
    Object varLeft
)

Параметры

bstrName
Имя файла .html, используемого для модального диалогового окна.

varArguments
Указывает аргументы для использования при отображении модального диалогового окна. Значение может быть любого типа, включая массив значений.

varHeight
Задает высоту модального диалогового окна.

varWidth
Задает ширину модального диалогового окна.

varTop
Задает верхнюю границу модального диалогового окна относительно левого верхнего угла рабочего стола.

varLeft
Задает левую границу модального диалогового окна относительно левого верхнего угла рабочего стола

Возвращаемое значение

object), указывающий способ отображения модального диалогового окна.

Заметки

Метод ShowModalDialog позволяет отображать настраиваемые диалоговые окна по мере заполнения пользователем полностью доверенных форм. Настраиваемые диалоговые окна реализуются как файлы .html, созданные в любом редакторе HTML, например, Microsoft FrontPage. В настраиваемом диалоговом окне можно использовать программу сценариев, которая взаимодействует с объектной моделью InfoPath при передаче объектов диалоговому окну с помощью параметра varArguments.

Для использования настраиваемого диалогового окна в форме InfoPath необходимо сначала добавить файл .html этого диалогового окна к набору файлов ресурсов формы, используя диалоговое окно "Файлы ресурсов". Диалоговое окно "Файлы ресурсов" доступно в меню "Сервис" в режиме конструктора. После добавления диалогового окна к форме можно использовать метод ShowModalDialog для его отображения.

Хотя метод ShowModalDialog использовать только для полностью доверенных форм, можно создавать настраиваемые диалоговые окна в стандартных формах, используя метод showModalDialog объектной модели динамического HTML (DHTML), если в форме указана область задач HTML, или используя форму Windows.

Внимание!
Доступ к этому члену имеется только у форм, открытых из шаблона формы, настроенного в разделе "Безопасность и доверие" диалогового окна "Параметры формы" на работу с полным доверием. Этот член требует для текущего вызова полного доверия и не может быть использован программой с частичным доверием. Дополнительные сведения см. в статье "Использование библиотек из программ с частичным доверием" на MSDN.

Доступ к этому члену имеется только у форм, открытых из шаблона формы, настроенного в разделе "Безопасность и доверие" диалогового окна "Параметры формы" на работу с полным доверием. Этот член требует для текущего вызова полного доверия и не может быть использован программой с частичным доверием. Дополнительные сведения см. в статье "Использование библиотек из программ с частичным доверием" на MSDN.

Пример

В следующем примере метод ShowModalDialog объекта UIObject используется для отображения настраиваемого диалогового окна. Обратите внимание, что объект XDocument передается диалоговому окну с помощью параметра varArguments.

thisXDocument.UI.ShowModalDialog("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.

См. также

Ссылка

Интерфейс UI2
Члены UI2
Пространство имен Microsoft.Office.Interop.InfoPath.SemiTrust

Поделиться через