Compartilhar via


trackContainerResize

Determina o dimensionamento do contêiner se o componente precisa reagir. O componente obterá allocatedWidth ou allocatedHeight se a entrada for verdadeira..

Quando você chamar o trackContainerResize(true) método, ele context.mode.allocatedWidthcontext.mode.allocatedHeight será fornecido dentro do updateView método do componente de código. Os valores dessas propriedades são diferentes dependendo de onde o componente de código está hospedado. Um valor indica que o componente de -1 código pode definir regras de estilo CSS para preencher o espaço disponível conforme necessário.

A tabela a seguir mostra os valores de allocatedWidth e allocatedHeight nas diferentes combinações de métodos de ciclo de vida de componente de host e código.

Host Método de ciclo de vida allocatedWidth allocatedHeight
Aplicativos baseados em modelo e tela init -1 -1
Aplicativos baseados em modelo updateView -1 se trackContainerResize(false) ou
largura em pixels se trackContainerResize(true)
A largura será alterada à medida que a janela do navegador for redimensionada e o formulário se ajustar ao espaço disponível.
-1
Aplicativos de tela updateView Definido pelo criador de aplicativos.
Pode ser alterado dinamicamente se a largura estiver definida como uma fórmula do Power FX.
Definido pelo criador de aplicativos.
Pode ser alterado dinamicamente se a largura estiver definida como uma fórmula do Power FX.

Observação

No arreio de teste (iniciado a usar npm start), o allocatedHeight e allocatedWidth será retornado como cadeias de caracteres em vez de números. Quando nenhum valor for fornecido, eles retornarão uma cadeia de caracteres vazia em vez de -1 ou indefinida. Além disso, depois que a largura ou a altura estiver definida, você não poderá desfazer as alterações sem atualizar o navegador, em vez disso, um valor em branco será interpretado como um tamanho de 1.

Em geral, os aplicativos controlados por modelos não restringem a altura e a largura de um componente, portanto, o acompanhamento do tamanho do contêiner não é necessário. Em vez disso, os componentes de código podem crescer para usar 100% do espaço para componentes de grade ou para uma altura específica exigida pelo conteúdo ao renderizar um field componente. Em aplicativos de tela, no entanto, o contexto pai sempre fornece a altura e a largura do componente por natureza do editor de arrastar e soltar.

A tabela a seguir mostra as estratégias que você pode usar para controlar a altura e a largura do conteúdo HTML de seus controles:

Host Tipo de componente de código Estratégia de tamanho de altura do CSS Estratégia de tamanho da largura do CSS
Aplicativos baseados em modelo dataset height: "100%" width: "100%"
Aplicativos baseados em modelo field Crescer até uma altura máxima
(O formulário de hospedagem também crescerá para acomodar).
width: "100%"
Aplicativos baseados em modelo field (modo de tela inteira) height: "100%" width: "100%"
Aplicativos de tela dataset & field height: allocatedWidth width: allocatedHeight
Aplicativos de tela dataset & field (modo de tela inteira) height: "100%" width: "100%"

Se os valores de allocatedWidth e allocatedHeight alteração após o primeiro updateView for chamado, um subsequente updateView será chamado com "layout" adicionado ao context.updatedProperties. Mais informações: UpdatedProperties.

Disponível para

Aplicativos baseados em modelo, aplicativos de tela e portais.

Sintaxe

context.mode.trackContainerResize(value)

Parâmetros

Nome do parâmetro Tipo Obrigatório Description
value Boolean Yes True se os controles precisarem controlar o tamanho do contêiner, o componente receberá allocatedWidth ou allocatedHeight.

Modo
Referência da API da estrutura de componentes do Power Apps
Visão geral da estrutura de componentes do Power Apps