FrameworkCompatibilityPreferences.ShouldThrowOnCopyOrCutFailure Proprietà

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Ottiene o imposta un valore che indica se un'operazione di copia o di taglio non riuscita in un'istanza di TextBoxBase restituisce un oggetto 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

Valore della proprietà

Boolean

true se un'operazione di copia o di taglio non riuscita in un'istanza di TextBoxBase restituisce un oggetto ExternalException; in caso contrario, false.

Commenti

Se un'operazione degli Appunti ha esito negativo, ad esempio con un errore di 0x800401D0 HRESULT (CLIPBRD_E_CANT_OPEN), viene generato un oggetto corrispondente ExternalException (ovvero un tipo di ExternalException).

Poiché l'API Win32 OpenClipboard agisce a livello globale, le applicazioni ben scritte devono chiamare l'API corrispondente CloseClipboard non appena hanno completato le operazioni degli Appunti. In caso contrario, altre applicazioni in esecuzione nella stessa sessione non potranno accedere alle funzioni degli Appunti.

In WPF, tale negazione dell'accesso agli Appunti viene normalmente ignorata in modo invisibile all'utente. Tuttavia, le applicazioni possono scegliere di ricevere un ExternalException errore impostando il ShouldThrowOnCopyOrCutFailure flag su true. Tuttavia, se si sceglie di ricevere eccezioni, l'applicazione deve gestire Cut e indirizzare RoutedUICommands tramite un CommandBindingoggetto e quindi applicare tale associazione a tutti i controlli TextBoxBase (TextBox e CopyRichTextBox) nell'applicazione. L'applicazione deve assicurarsi che gestisca ExternalExceptions risultanti da operazioni di copia e taglio nel gestore Eseguiti di CommandBinding.