TaskbarItemInfo TaskbarItemInfo TaskbarItemInfo TaskbarItemInfo Class

Definição

Representa informações sobre como a miniatura da barra de tarefas é exibida.Represents information about how the taskbar thumbnail is displayed.

public ref class TaskbarItemInfo sealed : System::Windows::Freezable
public sealed class TaskbarItemInfo : System.Windows.Freezable
type TaskbarItemInfo = class
    inherit Freezable
Public NotInheritable Class TaskbarItemInfo
Inherits Freezable
Herança

Exemplos

O exemplo a seguir mostra como criar um TaskbarItemInfo na marcação.The following example shows how to create a TaskbarItemInfo in markup. O TaskbarItemInfo contém uma coleção de ThumbButtonInfo objetos que fornecem acesso aos comandos Play e parada do item de barra de tarefas.The TaskbarItemInfo contains a collection of ThumbButtonInfo objects that provide access to the Play and Stop commands from the taskbar item.

<Window.TaskbarItemInfo>
    <TaskbarItemInfo x:Name="taskBarItemInfo1" 
                     Overlay="{StaticResource ResourceKey=StopImage}"
                     ThumbnailClipMargin="80,0,80,140"
                     Description="Taskbar Item Info Sample">
        <TaskbarItemInfo.ThumbButtonInfos>
            <ThumbButtonInfoCollection>
                <ThumbButtonInfo
                    DismissWhenClicked="False"
                    Command="MediaCommands.Play"
                    CommandTarget="{Binding ElementName=btnPlay}"
                    Description="Play"
                    ImageSource="{StaticResource ResourceKey=PlayImage}"/>
                <ThumbButtonInfo
                    DismissWhenClicked="True"
                    Command="MediaCommands.Stop"
                    CommandTarget="{Binding ElementName=btnStop}"
                    Description="Stop"
                    ImageSource="{StaticResource ResourceKey=StopImage}"/>
            </ThumbButtonInfoCollection>
        </TaskbarItemInfo.ThumbButtonInfos>
    </TaskbarItemInfo>
</Window.TaskbarItemInfo>

A marcação e código a seguir mostra o exemplo anterior em seu contexto completo.The following markup and code shows the previous example in its full context. O aplicativo usa um BackgroundWorker para contar de 0 a 100 e exibe o andamento na interface do usuário.The application uses a BackgroundWorker to count from 0 to 100 and displays its progress in the user interface. A tarefa pode ser iniciada e interrompida da versão prévia da barra de tarefas.The task can be started and stopped from the taskbar preview. O progresso é exibido no botão da barra de tarefas.The progress is displayed in the taskbar button.

<Window x:Class="Shell_TaskbarItemSample.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="MainWindow" Height="300" Width="300">
    <Window.Resources>
        <DrawingImage x:Key="PlayImage">
            <DrawingImage.Drawing>
                <DrawingGroup>
                    <DrawingGroup.Children>
                        <GeometryDrawing Brush="Green" Geometry="F1 M 50,25L 0,0L 0,50L 50,25 Z "/>
                    </DrawingGroup.Children>
                </DrawingGroup>
            </DrawingImage.Drawing>
        </DrawingImage>
        <DrawingImage x:Key="StopImage">
            <DrawingImage.Drawing>
                <DrawingGroup>
                    <DrawingGroup.Children>
                        <GeometryDrawing Brush="Gray" Geometry="F1 M 0,0L 50,0L 50,50L 0,50L 0,0 Z "/>
                    </DrawingGroup.Children>
                </DrawingGroup>
            </DrawingImage.Drawing>
        </DrawingImage>
    </Window.Resources>
    <Window.CommandBindings>
        <CommandBinding Command="MediaCommands.Play"
                  Executed="StartCommand_Executed"
                  CanExecute="StartCommand_CanExecute"/>
        <CommandBinding Command="MediaCommands.Stop"
                  Executed="StopCommand_Executed"
                  CanExecute="StopCommand_CanExecute"/>
    </Window.CommandBindings>
    <Window.TaskbarItemInfo>
        <TaskbarItemInfo x:Name="taskBarItemInfo1" 
                         Overlay="{StaticResource ResourceKey=StopImage}"
                         ThumbnailClipMargin="80,0,80,140"
                         Description="Taskbar Item Info Sample">
            <TaskbarItemInfo.ThumbButtonInfos>
                <ThumbButtonInfoCollection>
                    <ThumbButtonInfo
                        DismissWhenClicked="False"
                        Command="MediaCommands.Play"
                        CommandTarget="{Binding ElementName=btnPlay}"
                        Description="Play"
                        ImageSource="{StaticResource ResourceKey=PlayImage}"/>
                    <ThumbButtonInfo
                        DismissWhenClicked="True"
                        Command="MediaCommands.Stop"
                        CommandTarget="{Binding ElementName=btnStop}"
                        Description="Stop"
                        ImageSource="{StaticResource ResourceKey=StopImage}"/>
                </ThumbButtonInfoCollection>
            </TaskbarItemInfo.ThumbButtonInfos>
        </TaskbarItemInfo>
    </Window.TaskbarItemInfo>

    <Grid>
        <StackPanel>
            <TextBlock x:Name="tbCount" FontSize="72" HorizontalAlignment="Center"/>
            <StackPanel Orientation="Horizontal">
                <Button x:Name="btnPlay" Content="Play" Command="MediaCommands.Play" />
                <Button x:Name="btnStop" Content="Stop" Command="MediaCommands.Stop" />
            </StackPanel>    
        </StackPanel>
    </Grid>
</Window>
// MainWindow.xaml.cs
using System.ComponentModel;
using System.Windows;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Shell;

namespace Shell_TaskbarItemSample
{
    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    public partial class MainWindow : Window
    {
        private BackgroundWorker _backgroundWorker = new BackgroundWorker();

        public MainWindow()
        {
            InitializeComponent();

            // Set up the BackgroundWorker.
            this._backgroundWorker.WorkerReportsProgress = true;
            this._backgroundWorker.WorkerSupportsCancellation = true;
            this._backgroundWorker.DoWork += new DoWorkEventHandler(bw_DoWork);
            this._backgroundWorker.ProgressChanged += new ProgressChangedEventHandler(bw_ProgressChanged);
            this._backgroundWorker.RunWorkerCompleted += new RunWorkerCompletedEventHandler(bw_RunWorkerCompleted);
        }

        private void StartCommand_CanExecute(object sender, CanExecuteRoutedEventArgs e)
        {
            e.CanExecute = true;
            e.Handled = true;
        }
        
        private void StartCommand_Executed(object sender, ExecutedRoutedEventArgs e)
        {
            if (this._backgroundWorker.IsBusy == false)
            {
                this._backgroundWorker.RunWorkerAsync();
                // When the task is started, change the ProgressState and Overlay
                // of the taskbar item to indicate an active task.
                this.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.Normal;
                this.taskBarItemInfo1.Overlay = (DrawingImage)this.FindResource("PlayImage");
            }
            e.Handled = true;
        }

        private void StopCommand_CanExecute(object sender, CanExecuteRoutedEventArgs e)
        {
            e.CanExecute = this._backgroundWorker.WorkerSupportsCancellation;
            e.Handled = true;
        }

        private void StopCommand_Executed(object sender, ExecutedRoutedEventArgs e)
        {
            this._backgroundWorker.CancelAsync();
            e.Handled = true;
        }

        void bw_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
        {
            // When the task ends, change the ProgressState and Overlay
            // of the taskbar item to indicate a stopped task.
            if (e.Cancelled == true)
            {
                // The task was stopped by the user. Show the progress indicator
                // in the paused state.
                this.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.Paused;
            }
            else if (e.Error != null)
            {
                // The task ended with an error. Show the progress indicator
                // in the error state.
                this.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.Error;
            }
            else
            {
                // The task completed normally. Remove the progress indicator.
                this.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.None;
            }
            // In all cases, show the 'Stopped' overlay.
            this.taskBarItemInfo1.Overlay = (DrawingImage)this.FindResource("StopImage");
        }

        void bw_ProgressChanged(object sender, ProgressChangedEventArgs e)
        {
            this.tbCount.Text = e.ProgressPercentage.ToString();
            // Update the value of the task bar progress indicator.
            this.taskBarItemInfo1.ProgressValue = (double)e.ProgressPercentage / 100;
        }

        void bw_DoWork(object sender, DoWorkEventArgs e)
        {        
            BackgroundWorker _worker = sender as BackgroundWorker;
            if (_worker != null)
            {
                for (int i = 1; i <= 100; i++)
                {
                    if (_worker.CancellationPending == true)
                    {
                        e.Cancel = true;
                        break;
                    }
                    else
                    {
                        System.Threading.Thread.Sleep(25);
                        _worker.ReportProgress(i);
                    }
                }
            }
        }
    
    }   
}
' MainWindow.xaml.vb
Imports System.ComponentModel
Imports System.Windows.Shell

Class MainWindow
    Private _backgroundWorker As New BackgroundWorker

    Public Sub New()
        InitializeComponent()

        ' Set up the BackgroundWorker
        Me._backgroundWorker.WorkerReportsProgress = True
        Me._backgroundWorker.WorkerSupportsCancellation = True
        AddHandler Me._backgroundWorker.DoWork, AddressOf bw_DoWork
        AddHandler Me._backgroundWorker.ProgressChanged, AddressOf bw_ProgressChanged
        AddHandler Me._backgroundWorker.RunWorkerCompleted, AddressOf bw_RunWorkerCompleted
    End Sub

    Private Sub StartCommand_CanExecute(ByVal sender As System.Object, ByVal e As System.Windows.Input.CanExecuteRoutedEventArgs)
        e.CanExecute = True
        e.Handled = True
    End Sub

    Private Sub StartCommand_Executed(ByVal sender As System.Object, ByVal e As System.Windows.Input.ExecutedRoutedEventArgs)
        If Me._backgroundWorker.IsBusy = False Then
            Me._backgroundWorker.RunWorkerAsync()
            ' When the task is started, change the ProgressState and Overlay
            ' of the taskbar item to indicate an active task.
            Me.taskBarItemInfo1.ProgressState = Shell.TaskbarItemProgressState.Normal
            Me.taskBarItemInfo1.Overlay = Me.FindResource("PlayImage")
        End If
        e.Handled = True
    End Sub

    Private Sub StopCommand_CanExecute(ByVal sender As System.Object, ByVal e As System.Windows.Input.CanExecuteRoutedEventArgs)
        e.CanExecute = Me._backgroundWorker.WorkerSupportsCancellation
        e.Handled = True
    End Sub

    Private Sub StopCommand_Executed(ByVal sender As System.Object, ByVal e As System.Windows.Input.ExecutedRoutedEventArgs)
        Me._backgroundWorker.CancelAsync()
        e.Handled = True
    End Sub

    Private Sub bw_RunWorkerCompleted(ByVal sender As Object, ByVal e As RunWorkerCompletedEventArgs)
        ' When the task ends, change the ProgressState and Overlay
        ' of the taskbar item to indicate a stopped task.
        If e.Cancelled = True Then
            ' The task was stopped by the user. Show the progress indicator
            ' in the paused state.
            Me.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.Paused
        ElseIf e.Error IsNot Nothing Then
            ' The task ended with an error. Show the progress indicator
            ' in the error state.
            Me.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.Error
        Else
            ' The task completed normally. Remove the progress indicator.
            Me.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.None
            ' In all cases, show the 'Stopped' overlay.
            Me.taskBarItemInfo1.Overlay = Me.FindResource("StopImage")
        End If
    End Sub

    Private Sub bw_ProgressChanged(ByVal sender As Object, ByVal e As ProgressChangedEventArgs)
        Me.tbCount.Text = e.ProgressPercentage.ToString()
        ' Update the value of the task bar progress indicator.
        Me.taskBarItemInfo1.ProgressValue = e.ProgressPercentage / 100
    End Sub

    Private Sub bw_DoWork(ByVal sender As Object, ByVal e As DoWorkEventArgs)
        Dim _worker As BackgroundWorker = CType(sender, BackgroundWorker)
        If _worker IsNot Nothing Then
            For i As Integer = 1 To 100 Step 1
                If _worker.CancellationPending = True Then
                    e.Cancel = True
                    Return
                Else
                    System.Threading.Thread.Sleep(25)
                    _worker.ReportProgress(i)
                End If
            Next
        End If
    End Sub
End Class

Comentários

O TaskbarItemInfo classe fornece um wrapper gerenciado para Windows 7Windows 7 funcionalidade de barra de tarefas.The TaskbarItemInfo class provides a managed wrapper for Windows 7Windows 7 taskbar functionality. Para obter mais informações sobre o shell do Windows e a barra de tarefas APIs nativa, consulte extensões da barra de tarefas.For more information about the Windows shell and native taskbar APIs, see Taskbar Extensions. TaskbarItemInfo é exposto como o Window.TaskbarItemInfo propriedade de dependência em um Window.TaskbarItemInfo is exposed as the Window.TaskbarItemInfo dependency property on a Window.

O Windows 7Windows 7 na barra de tarefas oferece funcionalidade aprimorada que permite que você use o item da barra de tarefas para comunicar o status a um usuário e expor as tarefas comuns quando a janela é minimizada ou oculta.The Windows 7Windows 7 taskbar provides enhanced functionality that enables you to use the taskbar item to communicate status to a user and expose common tasks when the window is minimized or hidden. A funcionalidade que é exposta pelo TaskbarItemInfo classe não está disponível em versões anteriores do Windows que Windows 7Windows 7.The functionality that is exposed by the TaskbarItemInfo class is unavailable in versions of Windows earlier than Windows 7Windows 7. Aplicativos que usam o TaskbarItemInfo classe ainda pode executar em versões anteriores do Windows; no entanto, esses aprimoramentos de barra de tarefas não estão disponíveis em versões anteriores.Applications that use the TaskbarItemInfo class can still run in earlier versions of Windows; however, these taskbar enhancements are unavailable in the earlier versions.

No Windows 7Windows 7, algumas funcionalidades de barra de tarefas podem estar indisponíveis, dependendo das configurações do usuário.In Windows 7Windows 7, some taskbar functionality might be unavailable, depending on the user's settings. Por exemplo, a funcionalidade de barra de tarefas está indisponível se Windows AeroWindows Aero está desabilitado ou se o aplicativo é iniciado com permissões elevadas.For example, taskbar functionality is unavailable if Windows AeroWindows Aero is disabled or if the application is started with elevated permissions. Seu aplicativo deve fornecer outras maneiras de interagir com o usuário que não dependem da funcionalidade avançada da barra de tarefas no Windows 7Windows 7.Your application should provide other ways to interact with the user that do not depend on the enhanced taskbar functionality in Windows 7Windows 7.

Ícones de programa na área de notificação, que está na extremidade direita da barra de tarefas, geralmente são usados para comunicar o status do aplicativo a um usuário.Program icons in the notification area, which is at the far right of the taskbar, are typically used to communicate application status to a user. Por padrão, o Windows 7Windows 7 na barra de tarefas oculta os ícones de programa na área de notificação.By default, the Windows 7Windows 7 taskbar hides program icons in the notification area. No entanto, você pode definir o Overlay propriedade para adicionar uma imagem para o botão de barra de tarefas para comunicar o status, como o status online em um aplicativo de mensagens.However, you can set the Overlay property to add an image to the taskbar button to communicate status, such as online status in a messaging application. A imagem de sobreposição permite aos usuários ver o status do aplicativo, mesmo se eles não podem ver o ícone de programa na área de notificação.The overlay image lets users see the application status even if they cannot see the program icon in the notification area. Você também pode exibir o andamento das tarefas em execução no botão da barra de tarefas, definindo o ProgressState e ProgressValue propriedades.You can also display the progress of running tasks in the taskbar button by setting the ProgressState and ProgressValue properties.

O Windows 7Windows 7 na barra de tarefas exibe uma miniatura do aplicativo quando você move o ponteiro do mouse sobre o botão de barra de tarefas.The Windows 7Windows 7 taskbar displays a thumbnail of the application when you move the mouse pointer over the taskbar button. Por padrão, a janela de todo o aplicativo é mostrada.By default the whole application window is shown. Você pode especificar uma parte específica da janela para exibir na miniatura definindo o ThumbnailClipMargin propriedade.You can specify a particular part of the window to display in the thumbnail by setting the ThumbnailClipMargin property. Você também pode especificar um Description que é exibido em uma dica de ferramenta acima a miniatura da barra de tarefas.You can also specify a Description that is displayed in a tooltip above the taskbar thumbnail. A dica de ferramenta é exibida mesmo quando a miniatura não pode ser vista devido às configurações do usuário.The tooltip is displayed even when the thumbnail cannot be seen because of user settings.

Você pode adicionar botões para a miniatura da barra de tarefas para fornecer acesso a tarefas comuns sem alternar para a janela do aplicativo.You can add buttons to the taskbar thumbnail to provide access to common tasks without switching to the application window. Por exemplo, janela Media Player fornece reproduzir, pausar, Avançar, e Back botões que permitem que você controlam a reprodução de mídia da miniatura de barra de tarefas quando o aplicativo é minimizado.For example, Window Media Player provides Play, Pause, Forward, and Back buttons that let you control media playback from the taskbar thumbnail when the application is minimized. Botões em miniatura da barra de tarefas são representados por ThumbButtonInfo objetos e estão contidas no ThumbButtonInfos coleção.Buttons in the taskbar thumbnail are represented by ThumbButtonInfo objects and are contained in the ThumbButtonInfos collection.

A ilustração a seguir mostra os recursos aprimorados do Windows 7Windows 7 na barra de tarefas.The following illustration shows the enhanced features of the Windows 7Windows 7 taskbar.

Exemplo de informações do Item da barra de tarefasTaskbar Item Info Sample
Recursos aprimorados de barra de tarefas do WindowsWindows Taskbar Enhanced Features

Construtores

TaskbarItemInfo() TaskbarItemInfo() TaskbarItemInfo() TaskbarItemInfo()

Inicializa uma nova instância da classe TaskbarItemInfo.Initializes a new instance of the TaskbarItemInfo class.

Campos

DescriptionProperty DescriptionProperty DescriptionProperty DescriptionProperty

Identifica a propriedade de dependência Description.Identifies the Description dependency property.

OverlayProperty OverlayProperty OverlayProperty OverlayProperty

Identifica a propriedade de dependência Overlay.Identifies the Overlay dependency property.

ProgressStateProperty ProgressStateProperty ProgressStateProperty ProgressStateProperty

Identifica a propriedade de dependência ProgressState.Identifies the ProgressState dependency property.

ProgressValueProperty ProgressValueProperty ProgressValueProperty ProgressValueProperty

Identifica a propriedade de dependência ProgressValue.Identifies the ProgressValue dependency property.

ThumbButtonInfosProperty ThumbButtonInfosProperty ThumbButtonInfosProperty ThumbButtonInfosProperty

Identifica a propriedade de dependência ThumbButtonInfos.Identifies the ThumbButtonInfos dependency property.

ThumbnailClipMarginProperty ThumbnailClipMarginProperty ThumbnailClipMarginProperty ThumbnailClipMarginProperty

Identifica a propriedade de dependência ThumbnailClipMargin.Identifies the ThumbnailClipMargin dependency property.

Propriedades

CanFreeze CanFreeze CanFreeze CanFreeze

Obtém um valor que indica se o objeto pode se tornar não modificável.Gets a value that indicates whether the object can be made unmodifiable.

(Inherited from Freezable)
DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Obtém o DependencyObjectType que encapsula o tipo CLRCLR dessa instância.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Description Description Description Description

Obtém ou define o texto da dica de ferramenta do item da barra de tarefas.Gets or sets the text for the taskbar item tooltip.

Dispatcher Dispatcher Dispatcher Dispatcher

Obtém o Dispatcher ao qual este DispatcherObject está associado.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
IsFrozen IsFrozen IsFrozen IsFrozen

Obtém um valor que indica se o objeto pode ser modificado no momento.Gets a value that indicates whether the object is currently modifiable.

(Inherited from Freezable)
IsSealed IsSealed IsSealed IsSealed

Obtém um valor que indica se essa instância está validada no momento (somente leitura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
Overlay Overlay Overlay Overlay

Obtém ou define a imagem que é exibida sobre o ícone de programa no botão da barra de tarefas.Gets or sets the image that is displayed over the program icon in the taskbar button.

ProgressState ProgressState ProgressState ProgressState

Obtém ou define um valor que indica como o indicador de progresso é exibido no botão da barra de tarefas.Gets or sets a value that indicates how the progress indicator is displayed in the taskbar button.

ProgressValue ProgressValue ProgressValue ProgressValue

Obtém ou define um valor que indica o preenchimento do indicador de progresso no botão da barra de tarefas.Gets or sets a value that indicates the fullness of the progress indicator in the taskbar button.

ThumbButtonInfos ThumbButtonInfos ThumbButtonInfos ThumbButtonInfos

Obtém ou define a coleção de objetos ThumbButtonInfo associados ao Window.Gets or sets the collection of ThumbButtonInfo objects that are associated with the Window.

ThumbnailClipMargin ThumbnailClipMargin ThumbnailClipMargin ThumbnailClipMargin

Obtém ou define um valor que especifica a parte da área de cliente da janela do aplicativo exibida na miniatura da barra de tarefas.Gets or sets a value that specifies the part of the application window's client area that is displayed in the taskbar thumbnail.

Métodos

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Determina se o thread de chamada tem acesso a este DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade.Clears the local value of a property. A propriedade a ser limpa é especificada por um identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade somente leitura.Clears the local value of a read-only property. A propriedade a ser limpa é especificada por um DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
Clone() Clone() Clone() Clone()

Cria um clone modificável do Freezable, fazendo cópias em profundidade dos valores do objeto.Creates a modifiable clone of the Freezable, making deep copies of the object's values. Ao copiar as propriedades de dependência do objeto, esse método copia as expressões (que talvez não possam mais ser resolvidas), mas não as animações nem seus valores atuais.When copying the object's dependency properties, this method copies expressions (which might no longer resolve) but not animations or their current values.

(Inherited from Freezable)
CloneCore(Freezable) CloneCore(Freezable) CloneCore(Freezable) CloneCore(Freezable)

Faz com que a instância seja um clone (cópia em profundidade) do Freezable especificado usando valores de propriedade base (não animados).Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(Inherited from Freezable)
CloneCurrentValue() CloneCurrentValue() CloneCurrentValue() CloneCurrentValue()

Cria um clone modificável (cópia profunda) do Freezable usando seus valores atuais.Creates a modifiable clone (deep copy) of the Freezable using its current values.

(Inherited from Freezable)
CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable) CloneCurrentValueCore(Freezable)

Torna a instância um clone modificável (cópia em profundidade) do Freezable especificado usando os valores de propriedade atuais.Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(Inherited from Freezable)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

Converte o valor da propriedade de dependência especificada.Coerces the value of the specified dependency property. Isso é feito invocando qualquer função CoerceValueCallback especificada nos metadados de propriedade para a propriedade de dependência, visto que ela existe na chamada a DependencyObject.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
CreateInstance() CreateInstance() CreateInstance() CreateInstance()

Inicializa uma nova instância da classe Freezable.Initializes a new instance of the Freezable class.

(Inherited from Freezable)
CreateInstanceCore() CreateInstanceCore() CreateInstanceCore() CreateInstanceCore()

Quando implementado em uma classe derivada, cria uma nova instância da classe derivada Freezable.When implemented in a derived class, creates a new instance of the Freezable derived class.

(Inherited from Freezable)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
Freeze() Freeze() Freeze() Freeze()

Torna o objeto atual não modificável e define sua propriedade IsFrozen para true.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Inherited from Freezable)
FreezeCore(Boolean) FreezeCore(Boolean) FreezeCore(Boolean) FreezeCore(Boolean)

Torna o objeto Freezable não modificável ou testa se ele pode ser transformado em não modificável.Makes the Freezable object unmodifiable or tests whether it can be made unmodifiable.

(Inherited from Freezable)
GetAsFrozen() GetAsFrozen() GetAsFrozen() GetAsFrozen()

Cria uma cópia congelada o Freezable usando valores de propriedade base (não animadas).Creates a frozen copy of the Freezable, using base (non-animated) property values. Já que a cópia está congelada, quaisquer subobjetos congelados são copiados por referência.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Inherited from Freezable)
GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable) GetAsFrozenCore(Freezable)

Torna a instância um clone congelado do Freezable especificado usando valores de propriedade base (não animados).Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Inherited from Freezable)
GetCurrentValueAsFrozen() GetCurrentValueAsFrozen() GetCurrentValueAsFrozen() GetCurrentValueAsFrozen()

Cria uma cópia congelada do Freezable usando valores de propriedade atuais.Creates a frozen copy of the Freezable using current property values. Já que a cópia está congelada, quaisquer subobjetos congelados são copiados por referência.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Inherited from Freezable)
GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable) GetCurrentValueAsFrozenCore(Freezable)

Torna a instância atual um clone congelado do Freezable especificado.Makes the current instance a frozen clone of the specified Freezable. Se o objeto tiver propriedades de dependência animadas, seus valores animados atuais serão copiados.If the object has animated dependency properties, their current animated values are copied.

(Inherited from Freezable)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Obtém o código hash para esse DependencyObject.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

Reavalia o valor efetivo para a propriedade de dependência especificadaRe-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnChanged() OnChanged() OnChanged() OnChanged()

Chamado quando o objeto Freezable atual é modificado.Called when the current Freezable object is modified.

(Inherited from Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject) OnFreezablePropertyChanged(DependencyObject, DependencyObject) OnFreezablePropertyChanged(DependencyObject, DependencyObject) OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Garante que os ponteiros de contexto apropriados sejam estabelecidos para um membro de dados DependencyObjectType que foi recém-definido.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Inherited from Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Este membro dá suporte à infraestrutura Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) e não se destina a ser usado diretamente do código.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Inherited from Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Substitui a implementação DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) para também invocar quaisquer manipuladores Changed em resposta à alteração de uma propriedade de dependência do tipo Freezable.Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Inherited from Freezable)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Retorna o valor local de uma propriedade de dependência, local, se houver.Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
ReadPreamble() ReadPreamble() ReadPreamble() ReadPreamble()

Garante que o Freezable esteja sendo acessado de um thread válido.Ensures that the Freezable is being accessed from a valid thread. Herdeiros do Freezable devem chamar esse método no início de qualquer APIAPI que lê membros de dados que não são propriedades de dependência.Inheritors of Freezable must call this method at the beginning of any APIAPI that reads data members that are not dependency properties.

(Inherited from Freezable)
SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

Define o valor da propriedade de dependência sem alterar a origem do valor.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência.Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Impõe que o thread de chamada tenha acesso a este DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
WritePostscript() WritePostscript() WritePostscript() WritePostscript()

Aciona o evento Changed para o Freezable e invoca o respectivo método OnChanged().Raises the Changed event for the Freezable and invokes its OnChanged() method. Classes que derivam de Freezable devem chamar este método no final de qualquer API que modifica os membros de classe que não são armazenados como propriedades de dependência.Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(Inherited from Freezable)
WritePreamble() WritePreamble() WritePreamble() WritePreamble()

Verifica se o Freezable não está congelado e está sendo acessado de um contexto de threading válido.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Herdeiros do Freezable devem chamar esse método no início de qualquer APIAPI que grava em membros de dados que não são propriedades de dependência.Freezable inheritors should call this method at the beginning of any APIAPI that writes to data members that are not dependency properties.

(Inherited from Freezable)

Eventos

Changed Changed Changed Changed

Ocorre quando o Freezable ou um objeto nele contido é modificado.Occurs when the Freezable or an object it contains is modified.

(Inherited from Freezable)

Aplica-se a