| 套件 | flash.display |
| 類別 | public final class GraphicsStroke |
| 繼承 | GraphicsStroke  Object |
| 實作 | IGraphicsStroke, IGraphicsData |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
與 Graphics.drawGraphicsData() 方法搭配使用 GraphicsStroke 物件。繪製 GraphicsStroke 物件相當於呼叫用來設定線段樣式之 Graphics 類別的方法之一，如 Graphics.lineStyle() 方法、Graphics.lineBitmapStyle() 方法或 Graphics.lineGradientStyle() 方法。
相關 API 元素
flash.display.Graphics.lineBitmapStyle()
flash.display.Graphics.lineGradientStyle()
flash.display.Graphics.drawGraphicsData()
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
| caps : String
指定線段終點的端點類型。 | GraphicsStroke | ||
 | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| fill : IGraphicsFill
指定包含筆畫填色資料的實體。 | GraphicsStroke | ||
| joints : String
指定用於角度的接合外觀類型。 | GraphicsStroke | ||
| miterLimit : Number
指出尖角遭到切斷的限制。 | GraphicsStroke | ||
| pixelHinting : Boolean
指定是否要提示筆畫使用完整的像素。 | GraphicsStroke | ||
| scaleMode : String
指定筆畫粗細的縮放。 | GraphicsStroke | ||
| thickness : Number
指出線條的粗細 (以點數為單位)，有效值從 0 到 255。 | GraphicsStroke | ||
| 方法 | 定義自 | ||
|---|---|---|---|
GraphicsStroke(thickness:Number = NaN, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = "none", joints:String = "round", miterLimit:Number = 3.0, fill:IGraphicsFill = null)
建立新的 GraphicsStroke 物件。 | GraphicsStroke | ||
|
指出物件是否有已定義的指定屬性。 | Object | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
|
會傳回指定之物件的基本值。 | Object | |
caps | 屬性 |
caps:String| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
指定線段終點的端點類型。有效值為：CapsStyle.NONE、CapsStyle.ROUND，以及 CapsStyle.SQUARE。 如果沒有指定值，Flash 會使用圓形端點。
例如，下列圖例會示範不同的 capsStyle 設定。 針對每一個設定，圖例都會示範一條粗細為 30 的藍色線條 (對它套用 capsStyle)，以及一條粗細為 1 並且疊在上面的黑色線條 (沒有套用 capsStyle)：
實作
public function get caps():String public function set caps(value:String):void相關 API 元素
fill | 屬性 |
public var fill:IGraphicsFill| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
指定包含筆畫填色資料的實體。IGraphicsFill 實體可以代表一連串的填色命令。
相關 API 元素
joints | 屬性 |
joints:String| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
指定用於角度的接合外觀類型。有效值為：JointStyle.BEVEL、JointStyle.MITER，以及JointStyle.ROUND。 如果沒有指定值，Flash 會使用圓角連接。
例如，下列圖例會示範不同的 joints 設定。 針對每一個設定，圖例都會示範一條粗細為 30 的折角藍色線條 (對它套用 jointStyle)，以及一條粗細為 1 並且疊在上面的折角黑色線條 (沒有套用 jointStyle)：
注意： 若要將 joints 設為 JointStyle.MITER，您可以使用 miterLimit 參數來限制尖角長度。
實作
public function get joints():String public function set joints(value:String):void相關 API 元素
miterLimit | 屬性 |
public var miterLimit:Number| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
指出尖角遭到切斷的限制。有效值介於 1 到 255 之間 (超出此範圍的值會捨入為 1 或 255)。只有當 jointStyle 是設為 "miter" 時才會使用這個值。 miterLimit 值代表尖角可以超出線段交會點的長度。 這個值可表示線條 thickness 的某個倍數。 例如，如果 miterLimit 倍數是 2.5，而 thickness 是 10 像素，則會在 25 像素的地方切割尖角。
再者，請看下列折角線條，每一條都是以 thickness 為 20 所繪製，但 miterLimit 則分別設為 1、2 和 4。 疊在上方的黑色參考線會顯示轉角處的交會點：
請注意，如果指定了 miterLimit 值，則切割尖角時會有一個特定的最大角度。 下表列出一些範例：
miterLimit 值： | 若小於這個角度，就會加以切斷 |
|---|---|
| 1.414 | 90 度 |
| 2 | 60 度 |
| 4 | 30 度 |
| 8 | 15 度 |
pixelHinting | 屬性 |
public var pixelHinting:Boolean| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
指定是否要提示筆畫使用完整的像素。這個值會影響曲線錨點的位置以及它本身的線段筆畫大小。 當您將 pixelHinting 設為 true，Flash Player 會提示線條寬度使用完整像素寬度。 當您將 pixelHinting 設為 false 時，曲線與直線當中可能會出現斷裂現象。例如，下列圖例說明 Flash Player 如何呈現兩個完全相同的圓角矩形 (除了 lineStyle() 方法中使用的 pixelHinting 參數不同之外，影像也將以 200% 的比例縮放來強調差異)：
scaleMode | 屬性 |
scaleMode:String| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
指定筆畫粗細的縮放。有效值為：
-
LineScaleMode.NORMAL-- 當縮放物件時 (預設值)，永遠可以調整線段粗細。 -
LineScaleMode.NONE-- 一律不調整線段粗細。 -
LineScaleMode.VERTICAL-- 如果物件只垂直縮放，就不縮放線段粗細。 以下面的圓形為例，這些圓形的線段都是以 1 像素來繪製，每一條線段的scaleMode參數都設為LineScaleMode.VERTICAL。 左邊的圓形只會垂直縮放，而右邊的圓形則可以同時水平與垂直縮放。
-
LineScaleMode.HORIZONTAL-- 如果物件只水平縮放，就不縮放線段粗細。 以下面的圓形為例，這些圓形的線段都是以 1 像素來繪製，每一條線段的scaleMode參數都設為LineScaleMode.HORIZONTAL。 左邊的圓形只會水平縮放，而右邊的圓形則可以同時水平與垂直縮放：
實作
public function get scaleMode():String public function set scaleMode(value:String):void相關 API 元素
thickness | 屬性 |
public var thickness:Number| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
指出線條的粗細 (以點數為單位)，有效值從 0 到 255。如果沒有指定數字，或是未定義參數，則不會繪製線條。 如果傳遞的值小於 0，則預設為 0。 0 這個值表示為極細線，而最大值為 255。 如果傳遞的值大於 255，則預設為 255。
GraphicsStroke | () | 建構函式 |
public function GraphicsStroke(thickness:Number = NaN, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = "none", joints:String = "round", miterLimit:Number = 3.0, fill:IGraphicsFill = null)| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
建立新的 GraphicsStroke 物件。
參數thickness:Number (default = NaN) | |||||||||||
pixelHinting:Boolean (default = false)pixelHinting 設為 true，Flash Player 會提示線條寬度使用完整像素寬度。 當您將 pixelHinting 設為 false 時，曲線與直線當中可能會出現斷裂現象。例如，下列圖例說明 Flash Player 如何呈現兩個完全相同的圓角矩形 (除了 lineStyle() 方法中使用的 pixelHinting 參數不同之外，影像也將以 200% 的比例縮放來強調差異)：
如果沒有提供值，線段就不會使用像素提示功能。 | |||||||||||
scaleMode:String (default = "normal")
| |||||||||||
caps:String (default = "none")CapsStyle.NONE、CapsStyle.ROUND，以及 CapsStyle.SQUARE。 如果沒有指定值，Flash 會使用圓形端點。
例如，下列圖例會示範不同的
| |||||||||||
joints:String (default = "round")JointStyle.BEVEL、JointStyle.MITER，以及JointStyle.ROUND。 如果沒有指定值，Flash 會使用圓角連接。
例如，下列圖例會示範不同的
注意： 若要將 | |||||||||||
miterLimit:Number (default = 3.0)jointStyle 是設為 "miter" 時才會使用這個值。 miterLimit 值代表尖角可以超出線段交會點的長度。 這個值可表示線條 thickness 的某個倍數。 例如，如果 miterLimit 倍數是 2.5，而 thickness 是 10 像素，則會在 25 像素的地方切割尖角。
再者，請看下列折角線條，每一條都是以
請注意，如果指定了
| |||||||||||
fill:IGraphicsFill (default = null) |
相關 API 元素
Tue Jun 12 2018, 03:47 PM Z