Compartilhar via


Calendar controlar

Um controle usado para inserir valores de data.

Nota

Documentação completa e código-fonte encontrados no repositório de componentes de código GitHub.

Controle de calendário.

Descrição

Este componente de código fornece um wrapper em torno do controle Calendar da Interface do Usuário do Fluent associado a um botão para uso em aplicativos de tela e páginas personalizadas.

Propriedades

Principais propriedades

Propriedade Description
SelectedDateValue O valor de data a ser pré-selecionado ou selecionado após o evento de alteração. Por exemplo: Data de hoje: Today(), Data com base no idioma: DateValue("24/7/2022",Language()), idioma regional específico: DateValue("24/07/2022","en-GB")
ShowGoToToday Se a opção "Ir para Hoje" estiver visível
MonthPickerVisible Se o seletor de mês estiver visível
DayPickerVisible Se o seletor de dia estiver visível
HighlightSelectedMonth Se o mês selecionado estiver destacado no calendário
HighlightCurrentMonth Se o mês atual estiver destacado no calendário
ShowWeekNumbers Se os números da semana estiverem visíveis
ShowSixWeeksByDefault Se a sexta semana estiver visível por padrão.
MinDate Se for especificado um valor de data, a navegação além dessa data não será permitida. Para o formato correto, consulte o exemplo fornecido para Data Selecionada.
MaxDate Se for especificado um valor de data, a navegação além dessa data não será permitida. Para o formato correto, consulte o exemplo fornecido para Data Selecionada.
FirstDayOfWeek Selecione o dia a ser exibido como primeiro dia da semana no calendário.

Propriedades de Estilo

Propriedade Descrição
Theme Aceita uma string JSON que é gerada usando Fluent UI Theme Designer (windows.net). Deixar em branco usará o tema padrão definido pelo Power Apps. Consulte os temas para obter orientação sobre como configurar.
BackgroundColor Cor de fundo do componente. por exemplo, Branco ou #ffffff
AccessibilityLabel Rótulo Aria do leitor de tela

Propriedades do Evento

Propriedade Descrição
InputEvent Um evento para enviar ao controle. Por exemplo, SetFocus. Consulte abaixo.

Comportamental

Oferece suporte a SetFocus como um InputEvent.

Usando OnChange

Quando uma data é selecionada, o valor pode ser obtido pela propriedade de saída selectedDate. Abaixo está um conjunto de código de exemplo que pode ser adicionado na propriedade 'OnChange', dependendo de como a saída precisa ser visualizada.

Set(var_SelectedDate, If(!IsBlank(Self.selectedDateValue), Text(Self.selectedDateValue, ShortDate, Language())));
// Example - Output: 7/14/2022
Set(var_SelectedDate, If(!IsBlank(Self.selectedDateValue), Text(Self.selectedDateValue, LongDate, Language())));
// Example - Output: Sunday, July 3, 2022

Set(var_SelectedDate, If(!IsBlank(Self.selectedDateValue), Text(Self.selectedDateValue, ShortDate, "en-GB")));
// Example - Output: 14/07/2022

Como configurar o foco no controle

Quando um novo diálogo for mostrado e o foco padrão tiver que estar no controle, um foco definido explícito será necessário.

Para fazer chamadas para o evento de entrada, você pode definir uma variável de contexto vinculada à propriedade Evento de Entrada para uma string que começa com SetFocus e é seguida por um elemento aleatório para garantir que o aplicativo a detecte como uma alteração.

Fórmula Power Fx do exemplo:

UpdateContext({ctxResizableTextareaEvent:"SetFocus" & Text(Rand())}));

A variável de contexto ctxResizableTextareaEvent seria então vinculada à propriedade InputEvent.

Limitações

Esse componente de código só pode ser usado em aplicativos de tela e páginas personalizadas.