Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Bitmap.LockBits (Rectangle, ImageLockMode, PixelFormat, BitmapData)

 

Data di pubblicazione: ottobre 2016

Blocca un Bitmap nella memoria di sistema

Spazio dei nomi:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

[SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)]
public BitmapData LockBits(
	Rectangle rect,
	ImageLockMode flags,
	PixelFormat format,
	BitmapData bitmapData
)

Parametri

rect
Type: System.Drawing.Rectangle

Struttura rettangolare che specifica la parte di Bitmap a blocco.

flags
Type: System.Drawing.Imaging.ImageLockMode

Uno del ImageLockMode valori che specifica il livello di accesso (lettura/scrittura) per il Bitmap.

format
Type: System.Drawing.Imaging.PixelFormat

Uno del PixelFormat valori che specifica il formato dei dati di Bitmap.

bitmapData
Type: System.Drawing.Imaging.BitmapData

Oggetto BitmapData che contiene informazioni sull'operazione di blocco.

Valore restituito

Type: System.Drawing.Imaging.BitmapData

Oggetto BitmapData che contiene informazioni sull'operazione di blocco.

Exception Condition
ArgumentException

PixelFormat valore non è un valore di bit per pixel specifico.

-oppure-

L'errata PixelFormat viene passato per una bitmap.

Exception

Operazione non riuscita.

Utilizzare il LockBits metodo per bloccare una bitmap esistente nella memoria di sistema in modo che può essere modificata a livello di codice. È possibile modificare il colore di un'immagine con il SetPixel (metodo), sebbene il LockBits metodo offre prestazioni migliori per le modifiche su larga scala.

Quando si chiama questo metodo, è necessario utilizzare un membro del System.Drawing.Imaging.PixelFormat enumerazione che contiene un valore specifico bit per pixel (BPP). Utilizzando System.Drawing.Imaging.PixelFormat valori, ad esempio Indexed e Gdi, genererà un System.ArgumentException. Inoltre, passando il formato non corretto per una bitmap verrà generata una System.ArgumentException.

Questa versione di LockBits metodo è destinato a essere utilizzato con un flags valore ImageLockMode.UserInputBuffer.

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: