HTMLTaskPane-objektet
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);
}
}
}