Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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. |
Artigos relacionados
Modo
Referência da API da estrutura de componentes do Power Apps
Visão geral da estrutura de componentes do Power Apps