FrameworkCompatibilityPreferences.ShouldThrowOnCopyOrCutFailure Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Obtém ou define um valor que indica se uma operação de recorte ou cópia com falha em uma instância de TextBoxBase resulta em um ExternalException.

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

public static bool ShouldThrowOnCopyOrCutFailure { get; set; }

static member ShouldThrowOnCopyOrCutFailure : bool with get, set

Public Shared Property ShouldThrowOnCopyOrCutFailure As Boolean

Valor da propriedade

Boolean

true se uma operação de cópia ou corte com falha em uma TextBoxBase instância resultar em um ExternalException; caso contrário, false.

Comentários

Se uma operação de área de transferência falhar, como com um erro hresult 0x800401D0 (CLIPBRD_E_CANT_OPEN), um correspondente ExternalException (que é um tipo de ExternalException) será gerado.

Como a API do Win32 OpenClipboard atua globalmente, aplicativos bem escritos devem chamar a API correspondente CloseClipboard assim que tiverem concluído suas operações de área de transferência. Caso contrário, outros aplicativos em execução na mesma sessão não poderão acessar as funções da área de transferência.

No WPF, essa negação de acesso à área de transferência normalmente é ignorada silenciosamente. No entanto, os aplicativos podem optar por receber um ExternalException após a falha definindo o ShouldThrowOnCopyOrCutFailure sinalizador truecomo . No entanto, optar por receber exceções também exige que o aplicativo manipule Cut e Copy RoutedUICommands por meio de um CommandBindinge, em seguida, aplique essa associação a todos os controles TextBoxBase (TextBox e RichTextBox) no aplicativo. O aplicativo deve garantir que ele manipule ExternalExceptions resultantes de operações de cópia e corte no manipulador Executado do CommandBinding.