DesktopWindowXamlSource.ShouldConstrainPopupsToWorkArea Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Hosting

Obtém ou define um valor que indica se os controles com comportamento semelhante a pop-up devem ser restritos à área de trabalho.

public:
 property bool ShouldConstrainPopupsToWorkArea { bool get(); void set(bool value); };

bool ShouldConstrainPopupsToWorkArea();

void ShouldConstrainPopupsToWorkArea(bool value);

public bool ShouldConstrainPopupsToWorkArea { get; set; }

var boolean = desktopWindowXamlSource.shouldConstrainPopupsToWorkArea;
desktopWindowXamlSource.shouldConstrainPopupsToWorkArea = boolean;

Public Property ShouldConstrainPopupsToWorkArea As Boolean

Valor da propriedade

Boolean

bool

true para restringir controles com comportamento semelhante a pop-up para a área de trabalho; caso contrário, false. O valor padrão é true.

Comentários

A área de trabalho de uma exibição é a parte da exibição da área de trabalho que exclui barras de tarefas, janelas encaixadas e barras de ferramentas encaixadas. Normalmente, os aplicativos se restringem à área de trabalho, incluindo todos os controles abertos pelo aplicativo com comportamento semelhante a pop-up; como Pop-up, Submenu, Dica de Ferramenta ou uma lista suspensa comboBox.

Se uma janela do aplicativo for destinada a ser posicionada fora da área de trabalho (como uma barra de ferramentas encaixada), seus pop-ups não devem se restringir à área de trabalho; caso contrário, eles seriam abertos muito longe dos elementos de interface do usuário aos quais estão associados. Isso pode criar situações como Dicas de Ferramentas que se abrem longe do controle que descrevem ou listas suspensas do ComboBox que se abrem longe do botão ComboBox.

A ShouldConstrainPopupsToWorkArea propriedade permite especificar se os pop-ups devem ser restritos à área de trabalho. O padrão é true; você pode especificar false se seu aplicativo tem controles que devem aparecer fora da área de trabalho.

Essa propriedade não se aplica retroativamente a controles semelhantes a pop-ups que já estão abertos.

Observação

Se um controle for restrito aos limites raiz definindo sua propriedade ShouldConstrainToRootBounds como true, a restrição de limites raiz terá prioridade sobre a restrição de área de trabalho, conforme mostrado nesta tabela.

ShouldConstrainPopupsToWorkArea	ShouldConstrainToRootBounds	Restrição real
false	false	Limites de exibição
false	true	Limites raiz
true	false	Área de trabalho
true	true	Limites raiz