Vis alt

TaskPane-objektet

Representerer en oppgaverute i et Microsoft Office InfoPath 2003-skjema som er knyttet til et vindu. TaskPane-objektet inneholder en rekke egenskaper for arbeid med innebygde InfoPath-oppgaveruter, og HTMLTaskPane-objektet arver disse egenskapene og metodene for arbeid med en egendefinert oppgaverute.

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 av direkte TaskPane-objektet.

Obs!  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.

Bruke TaskPane-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);
      }
   }
}