DrawingAttributes.Transparency-Eigenschaft

Artikel
11/26/2008

Ruft einen Wert ab, der die Transparenz der Freihandeingabe angibt, oder legt diesen Wert fest.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Property Transparency As Byte
'Usage
Dim instance As DrawingAttributes
Dim value As Byte

value = instance.Transparency

instance.Transparency = value

public byte Transparency { get; set; }

public:
property unsigned char Transparency {
    unsigned char get ();
    void set (unsigned char value);
}

/** @property */
public byte get_Transparency()
/** @property */
public  void set_Transparency(byte value)

public function get Transparency () : byte
public function set Transparency (value : byte)

Eigenschaftenwert

Typ: System.Byte
Ein Wert, der die Transparenz der Freihandeingabe angibt.

Wert	Bedeutung
0	Standardwert. Die Freihandeingaben sind nicht transparent.
0-255	Der Wert für die Transparenz kann zwischen nicht transparent (0) und vollkommen transparent (255) liegen.

Hinweise

Hinweis

Der Effekt des transparenten Renderings kann beim dynamischen Rendering anders sein als beim statischen Rendering. Beim dynamischen Rendering wird das Stroke-Objekt so gerendert, wie es gezeichnet wird, beispielsweise so, wie es in der InkCollector.DynamicRendering-Eigenschaft festgelegt ist. Beim statischen Rendering verwenden Sie die Draw-Methode des Renderer-Objekts, um das Stroke-Objekt zu rendern.

Beispiele

In diesem C#-Beispiel werden Ereignishandler für Menüelemente erstellt, die die Transparency-Eigenschaft eines DrawingAttributes-Objekts ändern.

using Microsoft.Ink;
//...
    private System.Windows.Forms.MenuItem menuInkTransparencyOpaque;
    private System.Windows.Forms.MenuItem menuInkTransparencyLight;
    private InkCollector theInkCollector;
    private System.Windows.Forms.MenuItem checkedTransparency;

//...
    private void menuInkTransparencyOpaque_Click(
    object sender, System.EventArgs e)
    {
        checkedTransparency.Checked = false;
        // Set the transparency to opaque
        theInkCollector.DefaultDrawingAttributes.Transparency = 0;
        checkedTransparency = menuInkTransparencyOpaque;
        checkedTransparency.Checked = true;
        Refresh();
    }

    private void menuInkTransparencyLight_Click(
    object sender, System.EventArgs e)
    {
        checkedTransparency.Checked = false;
        // Set the transparency to about 90%
        theInkCollector.DefaultDrawingAttributes.Transparency = 220;
        checkedTransparency = menuInkTransparencyLight;
        checkedTransparency.Checked = true;
        Refresh();
    }

In diesem Microsoft® Visual Basic® .NET-Beispiel werden Ereignishandler für Menüelemente erstellt, die die Transparency-Eigenschaft eines DrawingAttributes-Objekts ändern.

Imports Microsoft.Ink
'...
    Dim MenuInkTransparencyOpaque As System.Windows.Forms.MenuItem
    Dim MenuInkTransparencyLight As System.Windows.Forms.MenuItem
    Dim CheckedTransparency As System.Windows.Forms.MenuItem
    Dim theInkCollector As InkCollector
'...
    Private Sub MenuInkTransparencyOpaque_Click( _
    ByVal sender As Object, ByVal e As System.EventArgs)
        CheckedTransparency.Checked = False
        'Set the transparency to opaque
        theInkCollector.DefaultDrawingAttributes.Transparency = 0
        CheckedTransparency = MenuInkTransparencyOpaque
        CheckedTransparency.Checked = True
        Refresh()
    End Sub

    Private Sub MenuInkTransparencyLight_Click( _
    ByVal sender As Object, ByVal e As System.EventArgs)
        CheckedTransparency.Checked = False
        'Set the transparency to about 90%
        theInkCollector.DefaultDrawingAttributes.Transparency = 220
        CheckedTransparency = MenuInkTransparencyLight
        CheckedTransparency.Checked = True
        Refresh()
    End Sub

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.