PictureFormat.IncrementBrightness-Methode (Herausgeber)PictureFormat.IncrementBrightness Method (Publisher)

Ändert die Helligkeit des Bildes um den angegebenen Wert.Changes the brightness of the picture by the specified amount.

SyntaxSyntax

expression.expression. IncrementBrightness (Inkrement)IncrementBrightness(Increment)

Ausdruck Eine Variable, die ein PictureFormat -Objekt darstellt.expression A variable that represents a PictureFormat object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
IncrementIncrement ErforderlichRequired SingleSingle Gibt an, wie viel den Wert der Brightness -Eigenschaft für das Bild zu ändern.Specifies how much to change the value of the Brightness property for the picture. Ein positiver Wert wird das Bild heller; ein negativer Wert macht es dunkler.A positive value makes the picture brighter; a negative value makes the picture darker. Gültige Werte liegen zwischen - 1 und 1.Valid values are between - 1 and 1.

HinweiseRemarks

Sie können die Helligkeit einer Grafik über der oberen oder unteren Begrenzung für die Brightness -Eigenschaft nicht anpassen.You cannot adjust the brightness of a picture past the upper or lower limit for the Brightness property. Beispielsweise die Brightness -Eigenschaft gesetzt ist 0,9 und Sie geben 0,3 für das Argument Inkrement , die resultierende Helligkeit Ebene 1.0, die obere Grenze für die Brightness -Eigenschaft nicht 1,2.For example, if the Brightness property is initially set to 0.9 and you specify 0.3 for the Increment argument, the resulting brightness level will be 1.0, which is the upper limit for the Brightness property, instead of 1.2.

Verwenden Sie die Brightness -Eigenschaft, um die absolute Helligkeit des Bildes festzulegen.Use the Brightness property to set the absolute brightness of the picture.

BeispielExample

Dieses Beispiel erstellt ein Duplikat der ersten Form in der aktiven Publikation, verschiebt das Duplikat und gestaltet es dunkler.This example creates a duplicate of the first shape in the active publication and then moves and darkens the duplicate. Damit das Beispiel funktioniert, muss es sich bei der Form entweder um ein Bild oder um ein OLE-Objekt, das ein Bild darstellt, handeln.For the example to work, the shape must be either a picture or an OLE object representing a picture.

With ActiveDocument.Pages(1).Shapes(1).Duplicate 
 .PictureFormat.IncrementBrightness Increment:=-0.2 
 .IncrementLeft Increment:=50 
 .IncrementTop Increment:=50 
End With