Color Struct

Definizione

Descrive un colore in termini di canali alfa, rosso, verde e blu.Describes a color in terms of alpha, red, green, and blue channels.

public value class Color : IEquatable<System::Windows::Media::Color>, IFormattable
[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.ColorConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public struct Color : IEquatable<System.Windows.Media.Color>, IFormattable
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Media.ColorConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type Color = struct
    interface IFormattable
Public Structure Color
Implements IEquatable(Of Color), IFormattable
Ereditarietà
Attributi
Implementazioni

Esempio

In questo esempio viene illustrato come utilizzare i valori sRGB, ScRGB e del profilo colori per creare il colore blu.This example shows how to use sRGB, ScRGB, and color profile values to create the color blue.

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" >
<StackPanel Margin="20">
  
  <!-- This rectangle fill uses a Color with ScRGB values to
       create a completely opaque blue. -->
  <Rectangle Width="50" Height="50"  Margin="10">
     <Rectangle.Fill>
       <SolidColorBrush>
         <SolidColorBrush.Color>

           <!-- Describes the brush's color using
                ScRGB values. Each value has a range of 0-1.  -->
           <Color ScA="1.0" ScR="0.0" ScG="0.0" ScB="1.0" />
        </SolidColorBrush.Color>
      </SolidColorBrush>
    </Rectangle.Fill>
  </Rectangle>

  <!-- This rectangle fill uses a Color with sRGB values to
       create a completely opaque blue. -->
  <Rectangle Width="50" Height="50"  Margin="10">
     <Rectangle.Fill>
       <SolidColorBrush>
         <SolidColorBrush.Color>

           <!-- Describes the brush's color using
                sRGB values. Each value is a byte with range of 0-255.  -->
           <Color A="255" R="0" G="0" B="255" />
        </SolidColorBrush.Color>
      </SolidColorBrush>
    </Rectangle.Fill>
  </Rectangle>

  <!-- This rectangle fill uses the sRGB color profile and values to
       create a complete opaque blue. -->
  <Rectangle Width="50" Height="50"  Margin="10">
    <Rectangle.Fill>
      <SolidColorBrush Color="ContextColor 
       file://C:/WINDOWS/system32/spool/drivers/color/sRGB%20Color%20Space%20Profile.icm
       1.0,0.0,0.0,1.0"/>
    </Rectangle.Fill>
  </Rectangle>

</StackPanel>
</Page>

Commenti

Uso della sintassi XAML per gli attributiXAML Attribute Usage

<object property="predefinedColor"/>  
- or -  
<object property="#rgb"/>  
- or -  
<object property="#argb"/>  
- or -  
<object property="#rrggbb"/>  
- or -  
<object property="#aarrggbb"/>  
- or -  
<object property="sc# scA,scR,scG,scB"/>  
- or -  
<object property="ContextColor profileUri alphaValue,colorValue"/>  

Valori XAMLXAML Values

predefinedColorpredefinedColor
Uno dei colori predefiniti dalla Colors classe.One of the colors predefined by the Colors class.

RGBrgb
Numero esadecimale a tre cifre.A three-digit hexadecimal number. La prima cifra specifica il valore del colore R , la seconda cifra specifica il valore G e la terza cifra specifica il B valore.The first digit specifies the color's R value, the second digit specifies the G value, and the third digit specifies the B value. Ad esempio: 00F.For example, 00F.

ARGBargb
Numero esadecimale a quattro cifre.A four-digit hexadecimal number. La prima cifra specifica il valore del colore A , la seconda cifra ne specifica il R valore, la cifra successiva specifica il G valore e la cifra finale ne specifica il B valore.The first digit specifies the color's A value, the second digit specifies its R value, the next digit specifies the G value, and the final digit specifies its B value. Ad esempio: F00F.For example, F00F.

RRGGBBrrggbb
Numero esadecimale a sei cifre.A six-digit hexadecimal number. Le prime due cifre specificano il valore del colore R , le due successive ne specificano il valore G e le due finali ne specificano il B valore.The first two digits specify the color's R value, the next two specify its G value, and the final two specify its B value. Ad esempio: 0000FF.For example, 0000FF.

aarrggbbaarrggbb
Numero esadecimale a otto cifre.An eight-digit hexadecimal number. Le prime due cifre specificano il valore del colore A , le due successive ne specificano il valore, R le due successive ne specificano il valore G e le due finali ne specificano il B valore.The first two digits specify the color's A value, the next two specify its R value, the next two specify its G value, and the final two specify its B value. Ad esempio: FF0000FF.For example, FF0000FF.

scAscA
System.Single

Valore del colore ScA .The color's ScA value.

scRscR
System.Single

Valore del colore ScR .The color's ScR value.

scGscG
System.Single

Valore del colore ScG .The color's ScG value.

scBscB
System.Single

Valore del colore ScB .The color's ScB value.

profileUriprofileUri
System.Uri

International Color Consortium (ICC)International Color Consortium (ICC) Gestione colori immagine (ICM)Image Color Management (ICM) Profilo colori o.The International Color Consortium (ICC)International Color Consortium (ICC) or Gestione colori immagine (ICM)Image Color Management (ICM) color profile.

alphaValuealphaValue
System.Single

Valore del colore del canale alfa.The alpha channel color value. L'intervallo di valori è compreso tra 0,0 e 1,0.The value range is 0.0 to 1.0.

colorValuecolorValue
System.Single

Elenco delimitato da virgole da tre a otto valori che rappresentano i canali dei colori del profilo colori.A comma-delimited list of three to eight values that represent the color channels of the color profile. L'intervallo di valori è compreso tra 0,0 e 1,0.The value range is 0.0 to 1.0.

Proprietà

A

Ottiene o imposta il valore del canale alfa di sRGB del colore.Gets or sets the sRGB alpha channel value of the color.

B

Ottiene o imposta il valore del canale blu di sRGB del colore.Gets or sets the sRGB blue channel value of the color.

ColorContext

Ottiene il profilo colori International Color Consortium (ICC)International Color Consortium (ICC) o Gestione colori immagine (ICM)Image Color Management (ICM) del colore.Gets the International Color Consortium (ICC)International Color Consortium (ICC) or Gestione colori immagine (ICM)Image Color Management (ICM) color profile of the color.

G

Ottiene o imposta il valore del canale verde di sRGB del colore.Gets or sets the sRGB green channel value of the color.

R

Ottiene o imposta il valore del canale rosso di sRGB del colore.Gets or sets the sRGB red channel value of the color.

ScA

Ottiene o imposta il valore del canale alfa di ScRGB del colore.Gets or sets the ScRGB alpha channel value of the color.

ScB

Ottiene o imposta il valore del canale blu di ScRGB del colore.Gets or sets the ScRGB blue channel value of the color.

ScG

Ottiene o imposta il valore del canale verde di ScRGB del colore.Gets or sets the ScRGB green channel value of the color.

ScR

Ottiene o imposta il valore del canale rosso di ScRGB del colore.Gets or sets the ScRGB red channel value of the color.

Metodi

Add(Color, Color)

Somma due strutture Color.Adds two Color structures.

AreClose(Color, Color)

Confronta strutture Color per verificarne l'uguaglianza fuzzy.Compares two Color structures for fuzzy equality.

Clamp()

Imposta i canali di ScRGB del colore su un valore compreso tra 0 e 1, se sono esterni a tale intervallo.Sets the ScRGB channels of the color to within the gamut of 0 to 1, if they are outside that range.

Equals(Color)

Esegue un test per verificare se la struttura Color specificata è identica a questo colore.Tests whether the specified Color structure is identical to this color.

Equals(Color, Color)

Esegue un test per verificare se due strutture Color sono identiche o meno.Tests whether two Color structures are identical.

Equals(Object)

Verifica se l'oggetto specificato è una struttura Color ed è equivalente a questo colore.Tests whether the specified object is a Color structure and is equivalent to this color.

FromArgb(Byte, Byte, Byte, Byte)

Crea una nuova struttura Color utilizzando i valori specificati del canale alfa e dei canali di colori sRGB.Creates a new Color structure by using the specified sRGB alpha channel and color channel values.

FromAValues(Single, Single[], Uri)

Crea una nuova struttura Color utilizzando il profilo colori e i valori del canale alfa e dei canali di colori specificati.Creates a new Color structure by using the specified alpha channel, color channel values, and color profile.

FromRgb(Byte, Byte, Byte)

Crea una nuova struttura Color utilizzando i valori specificati dei canali di colori sRGB.Creates a new Color structure by using the specified sRGB color channel values.

FromScRgb(Single, Single, Single, Single)

Crea una nuova struttura Color utilizzando i valori specificati del canale alfa e dei canali di colori ScRGB.Creates a new Color structure by using the specified ScRGB alpha channel and color channel values.

FromValues(Single[], Uri)

Crea una nuova struttura Color utilizzando il profilo colori e i valori dei canali di colori specificati.Creates a new Color structure by using the specified color channel values and color profile.

GetHashCode()

Ottiene un codice hash per questa struttura Color.Gets a hash code for this Color structure.

GetNativeColorValues()

Ottiene i valori dei canali di colori del colore.Gets the color channel values of the color.

Multiply(Color, Single)

Moltiplica i canali alfa, rosso, blu e verde della struttura Color specificata per il valore determinato.Multiplies the alpha, red, blue, and green channels of the specified Color structure by the specified value.

Subtract(Color, Color)

Sottrae una struttura Color da una struttura Color.Subtracts a Color structure from a Color structure.

ToString()

Crea una rappresentazione di stringa del colore utilizzando i canali di sRGB.Creates a string representation of the color using the sRGB channels.

ToString(IFormatProvider)

Crea una rappresentazione di stringa del colore utilizzando i canali di sRGB e il provider del formato specificato.Creates a string representation of the color by using the sRGB channels and the specified format provider.

Operatori

Addition(Color, Color)

Somma due strutture Color.Adds two Color structures.

Equality(Color, Color)

Esegue un test per verificare se due strutture Color sono identiche o meno.Tests whether two Color structures are identical.

Inequality(Color, Color)

Esegue un test per verificare se due strutture Color sono identiche o meno.Tests whether two Color structures are not identical.

Multiply(Color, Single)

Moltiplica i canali alfa, rosso, blu e verde della struttura Color specificata per il valore determinato.Multiplies the alpha, red, blue, and green channels of the specified Color structure by the specified value.

Subtraction(Color, Color)

Sottrae una struttura Color da una struttura Color.Subtracts a Color structure from a Color structure.

Implementazioni dell'interfaccia esplicita

IFormattable.ToString(String, IFormatProvider)

Formatta il valore dell'istanza corrente utilizzando il formato specificato.Formats the value of the current instance using the specified format.

Si applica a