Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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. |
Artigos relacionados
Modo
Referência da API da estrutura do componente Power Apps
Visão geral da estrutura do componente Power Apps