Shell.UI.Pivots.js

 

Dotyczy: Windows Azure Pack

Udostępnia metody zarządzania łączami przestawnym na stronie rozszerzenia.

Pivots to linki pod głównym tytułem strony rozszerzenia, które są używane do przechodzenia do podstron.

Widżety

Brak.

Wyliczenia

Brak.

Typy

Shell.UI.Pivot(id, displayName, template, activated, image, visible, navFilter)

Nazwa	Typ	Opis
identyfikator	Obiekt	Identyfikator tabeli przestawnej
displayName	Ciąg	Nazwa wyświetlana tabeli przestawnej.
szablon	Obiekt	Szablon przestawny.
aktywowano	Funkcja	Funkcja wywołania zwrotnego aktywowana przez element Pivot.
image (obraz)	Obiekt	Obraz przestawny.
Widoczne	Wartość logiczna	Widoczność tabeli przestawnej.
navFilter	Obiekt	Filtr nawigacji przestawnej.

Shell.UI.PivotImageDescriptor(url, urlHover, altText)

Nazwa	Typ	Opis
url	Ciąg	Adres URL obrazu.
urlHover	Ciąg	Adres URL obrazu aktywowania.
altText	Ciąg	Alternatywny tekst obrazu.

Właściwości

Nazwa	Typ	Opis
Shell.UI.Pivot.displayName	Ciąg	Nazwa wyświetlana tabeli przestawnej.
Shell.UI.Pivot.id	Obiekt	Identyfikator tabeli przestawnej.
Shell.UI.Pivot.image	Obiekt	Obraz przestawny.
Shell.UI.Pivot.navFilter	Obiekt	Filtr nawigacji przestawnej.
Shell.UI.Pivot.template	Obiekt	Szablon przestawny.
Shell.UI.Pivot.visible	Wartość logiczna	Widoczność tabeli przestawnej. wartość true , jeśli element przestawny jest widoczny, w przeciwnym razie wartość false.
Shell.UI.PivotImageDescriptor.altText	Ciąg	Alternatywny tekst obrazu przestawnego.
Shell.UI.PivotImageDescriptor.url	Ciąg	Adres URL obrazu przestawnego.
Shell.UI.PivotImageDescriptor.urlHover	Ciąg	Adres URL obrazu przestawnego dla obrazu aktywowania.

Metody

Nazwa	Opis	Zwraca	Parametry
Shell.UI.Pivots.add	Dodaje listę przestawnych do określonej listy przestawnych.	Nothing	extensionId (ciąg): identyfikator rozszerzenia, dla których są dodawane przestawne. pivot (Tablica): przestawne, które mają zostać dodane. Można również stosować pojedynczy element przestawny Shell.UI.Pivot.
Shell.UI.Pivots.clear	Usuwa wszystkie pivots dla aktywnego rozszerzenia.	Nothing	extensionId: rozszerzenie, do którego należy Pivot.
Shell.UI.Pivots.getPivotContentArea	Pobiera obszar zawartości przestawnej.	Obiekt	Brak.
Shell.UI.PivotImageDescriptor.getQuickStartIcon	Pobiera deskryptor obrazu ikonę szybkiego startu. Zwraca obiekt PivotImageDescriptor zawierający adres URL obrazu, umieść kursor nad adresem URL obrazu i tekstem alternatywnym.	Obiekt	Brak
Shell.UI.Pivots.insert	Wstawia element przestawny w określonej pozycji.	Nothing	extensionId (ciąg): identyfikator rozszerzenia, dla których są dodawane przestawne. pivot (Shell.UI.Pivot): przestawne, które mają zostać wstawione. position (Liczba): pozycja do wstawienia tabeli przestawnej.
Shell.UI.Pivots.registerExtension	Rejestruje rozszerzenie.	Nothing	Rozszerzenie: rozszerzenie do zarejestrowania. initializeCallback: funkcja wywołania zwrotnego na potrzeby inicjowania.
Shell.UI.Pivots.remove	Usuwa określony element przestawny z listy przestawnych.	Nothing	pivot (Shell.UI.Pivot): przestawny do usunięcia.
Shell.UI.Pivots.set	Ustawia pivots.	Nothing	extensionId (ciąg): identyfikator rozszerzenia, dla których są dodawane przestawne. pivot (Tablica): przestawne, które mają być ustawione. Można również stosować pojedynczy element przestawny Shell.UI.Pivot.
Shell.UI.Pivots.update	Aktualizacje listy przestawnej	Nothing	extensionID: identyfikator rozszerzenia przestawnego.

Przykłady

Pierwszym krokiem jest utworzenie obiektu tabulatorów.

tabs: [
    {
        id: "timeZoneList",
        displayName: "Time Zones",
        template: "tzsTimeZoneList",
        activated: tzs_opened
    },
    {
        id: "secondTab",
        displayName: "Another Tab",
        template: "tzsSecondTab"
    }
]

Ponieważ przełączanie stron jest powszechne w interfejsie użytkownika, dobrym pomysłem jest utworzenie funkcji wielokrotnego użytku, która będzie ponownie inicjować elementy przestawne za każdym razem, gdy strona jest nawigowana.

initializePivots: function() {
    Shell.UI.Pivots.clear(this.name);
    Shell.UI.Pivots.add(this.name, this.tabs);

    // Another way to add is to add the tabs individually
    // Shell.UI.Pivots.add(new Shell.UI.Pivot("timeZoneList", "Time Zones", "tzsTimeZoneList", tzs_opened));
    // Shell.UI.Pivots.add(new Shell.UI.Pivot("secondTab", "Another Tab", "tzsSecondTab"));
    Shell.UI.Pivots.update(this.name);
}

Zobacz też

dokumentacja biblioteki powłoki rozszerzeń Windows Azure Pack