MATLAB Function Reference

set

設定物件屬性

Syntax

set(H,'PropertyName',PropertyValue,...)
set(H,a)
set(H,pn,pv...)
set(H,pn,<m-by-n cell array>)
a= set(h)
a= set(0,'Factory')
a= set(0,'FactoryObjectTypePropertyName')
a= set(h,'Default')
a= set(h,'DefaultObjectTypePropertyName')
<cell array> = set(h,'PropertyName')

Description

set(H,'PropertyName',PropertyValue,...) 在參數 H 所辨識的物件上，將指名的屬性設成指定的值。 H 可以是一個握把向量（vector of handles），在此情形下， set 會對所有物件設定這些屬性的值。

set(H,a) 在參數 H 所辨識的物件上，將指名的屬性設成指定的值。 a 是一個結構陣列（structure array），其欄位名稱是該物件的屬性名稱，且其欄位值是該對應屬性的值。

set(H,pn,pv,...) 對 H 中辨識的所有物件，將結構陣列（cell array） pn 中所指定的屬性設定成在異質陣列（cell array） pv 中的對應值。

set(H,pn,<m-by-n cell array>) 對 m 個圖形物件中的每一個設定 n 個屬性值，其中 m = length(H) 且 n 等於包含於異質陣列（cell array ）pn 中的屬性名稱個數。這使得你可以將一給定的屬性群，在每一個物件上設成不同的值。

a = set(h) 對 h 所辨識的物件，回傳使用者所設定的屬性（user-settable properties）以及可能的值。a 是一個結構陣列（structure array），其欄位名稱是該物件的屬性名稱，且其欄位值是該對應屬性可能值。若你不指定一個輸出參數， MATLAB 會在螢幕上顯示該資訊。參數 h 必須是純量（scalar）。

a = set(0,'Factory') 會對所有的物件回傳其預設值為使用者指定的屬性，並對每一個屬性列出可能的值。a 是一個結構陣列，其欄位名稱是該物件的屬性名稱，且其欄位值是該對應屬性的可能值。若你不指定一個輸出參數，MATLAB 會在螢幕上顯示該資訊。

a = set(0,'FactoryObjectTypePropertyName') 對所指定的物件型態回傳所指名屬性的可能值，若此值是字串。參數 FactoryObjectTypePropertyName 是將單字 Factory 與物件型態（例如， axes）和屬性名稱（例如，CameraPosition）串接而成。

a = set(h,'Default') 回傳設定於參數 h 所辨識的物件之具有預設值的屬性名稱。 set 亦會回傳可能的值，若它們是字串的話。h 必須是純量（scalar）。

a = set(h,'DefaultObjectTypePropertyName') 對所指定的物件型態回傳所指名屬性的可能值，若此值是字串。參數 DefaultObjectTypePropertyName 是將單字 Default 與物件型態（例如， axes）與屬性名稱（例如， CameraPosition）串接而成。例如，DefaultAxesCameraPosition。h 必須是純量（scalar）。

pv = set(h,'PropertyName') 回傳所指名屬性的可能值。若可能的值為字串， set 函式會將它們每一個回傳至異質陣列（cell array）pv 中的一個細格（cell）。對其他的屬性而言，set 函式會回傳一個空的異質陣列。若你不指定一個輸出參數，MATLAB 會在螢幕上顯示該資訊。參數 h 必須是純量（scalar）。

Remarks

你可以在一個 set 呼叫中使用屬性名稱/屬性值對（property name/property value pairs）、結構陣列及異質陣列的任一組合方式。

Examples

將目前圖軸的 Color 屬性設成藍色。

set(gca,'Color','b')

將一繪圖中的所有 lines 物件改變為黑色。

plot(peaks)
set(findobj('Type','line'),'Color','k')

你可以用一個結構來定義一群相關的屬性，來將你的程式碼作較佳的組織。例如，下列這些敘述定義了一個稱作 active 的結構，其內包含了在一特定的圖形視窗中用於 uicontrol 物件的一組屬性定義。當該圖形視窗變成目前的圖形視窗，MATLAB 會改變顏色並使該控制有效。

active.BackgroundColor = [.7 .7 .7];
active.Enable = 'on';
active.ForegroundColor = [0 0 0];

if gcf == control_fig_handle
    set(findobj(control_fig_handle,'Type','uicontrol'),active)
end

你可以使用異質陣列（cell arrays）來將每一個物件的屬性設成不同的值。例如，下列這些敘述定義了一個異質陣列以設定三個屬性，

PropName(1) = {'BackgroundColor'};
PropName(2) = {'Enable'};
PropName(3) = {'ForegroundColor'};

下列這些敘述定義了一個異質陣列，該異質陣列對三個物件中的每一個包含了三個值（意即，一個 3 × 3 的異質陣列）。

PropVal(1,1) = {[.5 .5 .5]}; 
PropVal(1,2) = {'off'}; 
PropVal(1,3) = {[.9 .9 .9]};
PropVal(2,1) = {[1 0 0]}; 
PropVal(2,2) = {'on'}; 
PropVal(2,3) = {[1 1 1]};
PropVal(3,1) = {[.7 .7 .7]}; 
PropVal(3,2) = {'on'}; 
PropVal(3,3) = {[0 0 0]};

現在傳遞參數至 set，

set(H,PropName,PropVal)

其中， length(H) = 3 ，且每一元素是一個 uicontrol 物件的握把（handle）。

See Also

findobj, gca, gcf, gco, gcbo, get

serialbreak

set (activex)