Partilhar via


trackContainerResize

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

Quando você chama o trackContainerResize(true) método, o context.mode.allocatedWidth e context.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 de indica que o componente de código pode definir regras de -1 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 do host e do componente de código.

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

Observação

No chicote de teste (começou a usar npm start), o allocatedHeight e allocatedWidth será retornado como cadeias de caracteres em vez de números. Quando nenhum valor é fornecido, eles retornarão uma cadeia de caracteres vazia em vez de -1 ou indefinida. Além disso, uma vez que a largura ou altura é definida, você não pode 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 orientados por modelo não restringem a altura e a largura de um componente, portanto, não é necessário rastrear o tamanho do contêiner. 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 dos controles:

Host Tipo de componente de código Estratégia de tamanho de altura CSS Estratégia de tamanho de largura CSS
Aplicações condicionadas por modelos dataset height: "100%" width: "100%"
Aplicações condicionadas por modelos field Cresça até uma altura máxima
(O formulário de hospedagem também crescerá para acomodar).
width: "100%"
Aplicações condicionadas por modelos field (modo de tela cheia) height: "100%" width: "100%"
Aplicações de tela dataset & field height: allocatedWidth width: allocatedHeight
Aplicações de tela dataset & field (modo de tela cheia) height: "100%" width: "100%"

Se os valores de allocatedWidth e allocatedHeight mudam após o primeiro updateView é chamado, então um subsequente updateView é chamado com "layout" adicionado ao context.updatedProperties. Para obter mais informações: UpdatedProperties.

Disponível para

Aplicativos orientados a modelos, aplicativos de tela, portais Ads.

Sintaxe

context.mode.trackContainerResize(value)

Parâmetros

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

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