BitmapPalette 類別

定義

命名空間:

System.Windows.Media.Imaging

組件:

PresentationCore.dll

定義受支援影像類型可用的色彩調色盤。

public ref class BitmapPalette sealed : System::Windows::Threading::DispatcherObject

public sealed class BitmapPalette : System.Windows.Threading.DispatcherObject

type BitmapPalette = class
    inherit DispatcherObject

Public NotInheritable Class BitmapPalette
Inherits DispatcherObject

繼承

Object

DispatcherObject

BitmapPalette

範例

下列範例示範如何定義自訂 BitmapPalette ，並將其套用至新的 BitmapSource 。

int width = 128;
int height = width;
int stride = width/8;
byte[] pixels = new byte[height*stride];

// Try creating a new image with a custom palette.
List<System.Windows.Media.Color> colors = new List<System.Windows.Media.Color>();
colors.Add(System.Windows.Media.Colors.Red);
colors.Add(System.Windows.Media.Colors.Blue);
colors.Add(System.Windows.Media.Colors.Green);
BitmapPalette myPalette = new BitmapPalette(colors);

// Creates a new empty image with the pre-defined palette

BitmapSource image = BitmapSource.Create(
    width,
    height,
    96,
    96,
    PixelFormats.Indexed1,
    myPalette, 
    pixels, 
    stride);

FileStream stream = new FileStream("empty.tif", FileMode.Create);
TiffBitmapEncoder encoder = new TiffBitmapEncoder();
TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString();
encoder.Frames.Add(BitmapFrame.Create(image));
MessageBox.Show(myPalette.Colors.Count.ToString());
encoder.Save(stream);

Dim width As Integer = 128
Dim height As Integer = width
Dim stride As Integer = CType(width / 8, Integer)
Dim pixels(height * stride) As Byte

' Try creating a new image with a custom palette.
Dim colors As New List(Of System.Windows.Media.Color)()
colors.Add(System.Windows.Media.Colors.Red)
colors.Add(System.Windows.Media.Colors.Blue)
colors.Add(System.Windows.Media.Colors.Green)
Dim myPalette As New BitmapPalette(colors)

' Creates a new empty image with the pre-defined palette
Dim image As BitmapSource = System.Windows.Media.Imaging.BitmapSource.Create(width, height, 96, 96, PixelFormats.Indexed1, myPalette, pixels, stride)
Dim stream As New FileStream("empty.tif", FileMode.Create)
Dim encoder As New TiffBitmapEncoder()
Dim myTextBlock As New TextBlock()
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString()
encoder.Frames.Add(BitmapFrame.Create(image))
MessageBox.Show(myPalette.Colors.Count.ToString())
encoder.Save(stream)

下列範例示範如何從影像擷取 BitmapPalette 。

// Get the palette from an image
BitmapImage image2 = new BitmapImage();
image2.BeginInit();
image2.UriSource = new Uri("tulipfarm.tif", UriKind.RelativeOrAbsolute);
image2.EndInit();
BitmapPalette myPalette3 = new BitmapPalette(image2, 256);

//Draw the third Image
Image myImage2 = new Image();
myImage2.Source = image2;
myImage2.Stretch = Stretch.None;
myImage2.Margin = new Thickness(20);

' Get the palette from an image
Dim image2 As New BitmapImage()
image2.BeginInit()
image2.UriSource = New Uri("tulipfarm.tif", UriKind.RelativeOrAbsolute)
image2.EndInit()
Dim myPalette3 As New BitmapPalette(image2, 256)

'Draw the third Image
Dim myImage2 As New Image()
myImage2.Source = image2
myImage2.Stretch = Stretch.None
myImage2.Margin = New Thickness(20)

備註

只有標記的影像檔案格式 (TIFF) 和圖形交換格式 (GIF) 影像格式支援影像選擇區。 不過，其他映射類型可用來定義 BitmapPalette 。 嘗試為不支援的點陣圖格式定義 BitmapPalette ，不會產生例外狀況;只會忽略指定的 BitmapPalette 。

Windows Presentation Foundation (WPF) 支援 類別所 BitmapPalettes 定義的自訂調色盤和預先定義的調色盤。

建構函式

BitmapPalette(BitmapSource, Int32)	根據指定的 BitmapSource，初始化 BitmapPalette 類別的新執行個體。 新的 BitmapPalette 限制為指定的最大色彩計數。
BitmapPalette(IList<Color>)	使用指定的色彩，初始化 BitmapPalette 類別的新執行個體。

屬性

Colors	取得調色盤中定義的色彩。
Dispatcher	取得與這個 Dispatcher 關聯的 DispatcherObject。 (繼承來源 DispatcherObject)

方法

CheckAccess()	判斷呼叫的執行是否可以存取這個 DispatcherObject。 (繼承來源 DispatcherObject)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
VerifyAccess()	請強制執行可以存取這個 DispatcherObject 的呼叫執行緒。 (繼承來源 DispatcherObject)

另請參閱

• BitmapPalettes