HTMLTaskPane-objektet

Microsoft Office InfoPath

Vis alt Vis alt

HTMLTaskPane-objektet

HTMLTaskPane

Representerer en egendefinert oppgaverute i et Microsoft Office InfoPath 2003-skjema som er knyttet til et vindu. HTMLTaskPane-objektet inneholder en rekke egenskaper og metoder for å arbeide med den egendefinerte oppgaveruten i InfoPath, samt egenskaper og metoder som arves av TaskPane-objektet.

Merknader

Egenskapene og metodene som er tilgjengelige for en InfoPath-oppgaverute, avhenger av hva slags oppgaverute du arbeider med. Hvis Type-egenskapen for TaskPane-objektet returnerer 0, er oppgaveruten en egendefinert oppgaverute, og de tilgjengelige egenskapene og metodene angis av HTMLTaskPane-objektet. Hvis Type-egenskapen returnerer en annen verdi, er oppgaveruten en innebygd oppgaverute, og egenskapene angis direkte av TaskPane-objektet.

Type-egenskapen er basert på XdTaskPaneType-nummereringen. Disse tallverdiene brukes også som argumenter til Item-egenskapen for TaskPanes-samlingen for å returnere en referanse til en angitt type oppgaverute.

Obs!  Egenskapene og metodene for HTMLTaskPane-objektet kan ikke kalles under en OnLoad-hendelse fordi visningen ennå ikke er lastet inn når hendelsen inntreffer og det er knyttet oppgaveruter til visningen.

Bruke HTMLTaskPane-objektet

I eksemplet fra eksempelskjemaet User Interface nedenfor brukes Item-egenskapen for TaskPanes-samlingen til å angi en global referanse til TaskPane-objektet som representerer den egendefinerte oppgaveruten. Deretter kalles en skriptfunksjon som er definert i HTML-koden for den egendefinerte oppgaveruten, ved hjelp av HTMLDocument-egenskapen for HTMLTaskPane-objektet, som arves av TaskPane-objektet.

    function SetTaskPaneState()
{

   // Ensure View has loaded before trying to access the task pane.
   if (XDocument.View)
   {
      // Get a reference to the custom task pane.  It is always the 0-th
      // task pane in the TaskPanes collection.
      if (gobjTaskPane == null)
         gobjTaskPane = XDocument.View.Window.TaskPanes.Item(0);

      // Ensure that the task pane is completely loaded.
      if (gobjTaskPane.HTMLDocument.readyState == "complete")
      {
         var strTaskPaneViewId = "TP_" + XDocument.View.Name.replace(/\W+/g, "");

         // Call a script function defined in the task pane HTML page.
         gobjTaskPane.HTMLDocument.parentWindow.SelectView(strTaskPaneViewId);
      }
   }
}