Share via


Como criar e aplicar um recurso

Os estilos e modelos de elementos são armazenados em entidades reutilizáveis chamadas recursos. Os estilos permitem que você defina propriedades de elemento e reutilize essas configurações para obter uma aparência consistente entre vários elementos. Um ControlTemplate define a aparência de um controle e também pode ser aplicado como recurso. Para saber mais, veja os tópicos sobre como estilizar controles e modelos de controle.

Sempre que você cria um novo recurso a partir de uma propriedade existente, Estilo ou ControlTemplate, a caixa de diálogo Criar Recurso permite definir o recurso no nível do aplicativo, no nível do documento ou no nível do elemento. Esses níveis determinam onde você pode usar o recurso. Por exemplo, se você definir o recurso no nível de elemento, o recurso só poderá ser aplicado ao elemento no qual ele foi criado. Você também pode optar por armazenar o recurso em um dicionário de recurso, que é um arquivo separado que pode ser usado novamente em outro projeto.

Para criar um novo recurso

  1. Com um arquivo XAML aberto no Designer XAML, crie um elemento ou selecione um elemento na janela Estrutura de Tópicos de Documento.

  2. Na janela Propriedades, clique no marcador de propriedade à direita de um valor de propriedade, exibido como um símbolo de caixa, e clique em Converter em Novo Recurso. Um símbolo de caixa branca indica um valor padrão, e um símbolo de caixa preta normalmente indica que um recurso local foi aplicado

    A caixa de diálogo apropriada para criar um recurso é exibida. Esta caixa de diálogo é exibida quando você cria um recurso com um pincel:

    Create Resource Dialog Box

  3. Na caixa Nome (Chave), insira um nome de chave. Este é o nome que você pode usar quando quer que outros elementos façam referência ao recurso.

  4. Em Definir em, clique na opção que especifica onde você deseja que o recurso seja definido:

    • Para disponibilizar o recurso para qualquer documento em seu aplicativo, clique em Aplicativo.

    • Para disponibilizar o recurso somente para o documento atual, clique Este documento.

    • Para disponibilizar o recurso somente para o elemento a partir do qual você criou o recurso ou para seus elementos filho, clique em Este Documento. Na lista suspensa, selecione elemento: nome.

    • Para definir o recurso em um arquivo de dicionário de recurso que pode ser reutilizado em outros projetos, clique em Dicionário de recurso e selecione um arquivo de dicionário de recurso existente, como StandardStyles.xaml na lista suspensa.

  5. Clique em OK para criar o recurso e aplicá-lo ao elemento a partir do qual você o criou.

Para aplicar um recurso a um elemento ou propriedade

  1. Na janela Estrutura de Tópicos de Documento, selecione o elemento ao qual você deseja aplicar um recurso.

  2. Siga um destes procedimentos:

    • Aplique um recurso a uma propriedade. Na janela Propriedades, clique no marcador de propriedade ao lado do valor de propriedade, aponte para Recurso Local ou Recurso do Sistema e clique em um recurso disponível na lista que é exibida.

      Se você não vir um recurso que esperava ver, é possível que o tipo do recurso não corresponda ao tipo da propriedade.

    • Aplique um estilo ou recurso de modelo de controle a um controle. Clique com o botão direito do mouse em um controle na janela Estrutura de Tópicos de Documento, aponte para Editar Modelo ou Editar Modelos Adicionais, aponte para Aplicar Recurso e clique no nome do modelo de controle na lista que é exibida.

      Dica

      A opção Editar Modelo é usada para aplicar modelos de controle.A opção Editar Modelos Adicionais é usada para aplicar outros tipos de modelo.

    Os recursos podem ser aplicados onde quer que sejam compatíveis. Por exemplo, um recurso de pincel pode ser aplicado à propriedade Primeiro Plano de um controle TextBox.

Para editar um recurso

  1. Selecione um elemento no artboard ou na janela Estrutura de Tópicos de Documento.

  2. Clique no marcador de propriedade Padrão ou Local à direita da propriedade na janela Propriedades e clique em Editar Recurso para abrir a caixa de diálogo Editar Recurso.

  3. Modifique as opções do recurso.

Consulte também

Conceitos

Criando uma interface de usuário usando o Designer XAML