guidata (MATLAB Function Reference)

(translator=roro, ChineseSource=roro-20020613-2\guidata.html, EnglishSource=c:\matlabr12\help\techdoc\ref\guidata.html)

放置或接收應用資料

Syntax

guidata(object_handle,data)
data = guidata(object_handle)

Description

guidata(object_handle,data) 放置設定的資料至圖像應用資料中。若 object_handle 不是圖表頭銜，則物件的母圖表為已使用的。

data = guidata(object_handle) 回傳之前存放的資料，若無欲存放的資料，則回傳一空矩陣。

guidata 供應針對圖表應用資料有方便介面的應用開發：

在原始碼中對於應用資料並不需要開啟並維持一 hard-coded 性質的名稱。
可經由使用元件頭銜的子函式回傳程序接收資料（藉由 gcbo 回傳），而不需要找到圖表的頭銜。

guidata 特別用於 guihandles 的共軛，其開啟在包含所有 GUI 元件頭銜的圖表應用資料中之結構。

Examples

在此範例中，guidata 用來存放在有應用 M 檔案初始區段的 GUI 圖表應用資料的結構。此結構最初藉由 guihandles 開啟然後存取額外的資料。

data = guihandles(figure_handle); % create structure of handles
data.numberOfErrors = 0; % add some additional data
guidata(figure_handle,data) % save the structure

可重新呼叫在子函式回傳程序的資料並再度存取結構：

data = guidata(gcbo); % get the structure in the subfunction
data.numberOfErrors = data.numberOfErrors + 1;
guidata(gcbo,data) % save the changes to the structure

gtext 　 guide