Shell.UI.Pivots.js

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Fornece métodos para gerir links de rotação numa página de extensão.

Os pivôs são os links sob o título principal de uma página de extensão que são usados para navegar para sub-páginas.

Widgets

Nenhum.

Enumerações

Nenhum.

Tipos

Shell.UI.Pivot (id, displayName, modelo, ativado, imagem, visível, navFiltro)

Nome	Tipo	Descrição
ID	Objeto	O identificador de pivô
displayName	String	O nome do visor do pivô.
modelo	Objeto	O modelo de pivô.
ativado	Função	A função de retorno ativado pelo pivô ativou.
image	Objeto	A imagem do pivô.
visível	Booleano	A visibilidade do pivô.
navFilter	Objeto	O filtro de navegação pivot.

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

Nome	Tipo	Description
url	String	URL para a imagem.
urlHover	String	URL para a imagem hover.
altText	String	O texto alternativo de imagem.

Propriedades

Nome	Tipo	Description
Shell.UI.Pivot.displayName	String	O nome do visor do pivô.
Shell.UI.Pivot.id	Objeto	O identificador de pivô.
Shell.UI.Pivot.image	Objeto	A imagem pivô.
Shell.UI.Pivot.navFilter	Objeto	O filtro de navegação pivot.
Shell.UI.Pivot.template	Objeto	O modelo de pivô.
Shell.UI.Pivot.visível	Booleano	A visibilidade do pivô. verdade se o Pivô é visível, caso contrário falso.
Shell.UI.PivotImageDescriptor.altText	String	O texto alternativo para a imagem do pivô.
Shell.UI.PivotImageDescriptor.url	String	O URL de imagem de pivô.
Shell.UI.PivotImageDescriptor.urlHover	String	O URL de imagem de pivô para a imagem do hover.

Métodos

Nome	Descrição	Devoluções	Parâmetros
Shell.UI.Pivôs.add	Adiciona a lista de pivôs à lista especificada de pivôs.	Nenhumas	extensionId (String): O id da extensão para os pivôs estão sendo adicionados. pivô (Matriz): Os pivôs a serem adicionados. Também pode levar um único Shell.UI.Pivot também.
Shell.UI.Pivôs.clear	Remove todos os pivôs para a extensão ativa.	Nenhumas	extensionId: A extensão a que o Pivô pertence.
Shell.UI.Pivots.getPivotContentArea	Obtém a área de conteúdo do Pivot.	Objeto	Nenhum.
Shell.UI.PivotImageDescriptor.getQuickStartIcon	Obtém o ícone de início rápido do descritor de imagem. Devolve um objeto PivotImageDescriptor que contém o URL de imagem, url de imagem hover e texto alternativo.	Objeto	Nenhuma
Shell.UI.Pivôs.inserem	Insere um pivô na posição especificada.	Nenhumas	extensionId (String): O id da extensão para os pivôs estão sendo adicionados. pivô (Shell.UI.Pivot): Os pivôs a serem inseridos. posição (Número): posição para inserir o pivô em.
Shell.UI.Pivots.registerExtension	Regista a extensão.	Nenhumas	Extensão: A extensão a registar. inicializeCallback: A função de retorno para a inicialização.
Shell.UI.Pivôs.removem	Remove o pivô especificado da lista de pivôs.	Nenhumas	pivô (Shell.UI.Pivot): O pivô a ser removido.
Shell.UI.Pivôs.set	Define os pivôs.	Nenhumas	extensionId (String): O id da extensão para os pivôs estão sendo adicionados. pivô (Matriz): os pivôs a definir. Também pode levar um único Shell.UI.Pivot também.
Shell.UI.Pivots.update	Atualizações a Lista de Pivôs	Nenhumas	extensãoID: O identificador de extensão de pivô.

Exemplos

O primeiro passo é criar o objeto de separadores.

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

Como a comutação de página é comum na interface do utilizador, é uma boa ideia criar uma função reutilizável que re-inicialize os pivôs sempre que a página é navegada.

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

Consulte também

Windows referência da biblioteca da extensão do pacote Azure

Partilhar via