[QVGA] Windows 預設配置 (full.home.xml) 內容詳解

提供給想要自己修改佈景的夥伴，

了解這些功能屬性的用法後，日後想對手頭上的佈景做小幅度的修改，

或是想自己製作佈景，都能派的上用場，

廢話不多說，我們就直接進入正題吧。


1.基本觀念

首先，作為佈景的 xml 檔必須以 UTF-8 的編碼格式來編輯以及儲存，

使用記事本就能完成這項工作，但若您有慣用的文字編輯軟體當然更好；


存檔時編碼選擇 UTF-8

打開 full.home.xml 後應該能看到許多 < 及 > 組成的標籤，

標籤會以兩種方式出現，

一種是成雙成對的，例如 <plugin></plugin> 是一對，收尾的標籤會多一個正斜線，

這種標籤只要看到頭，就一定要有尾，不會只出現其中一個，

另一種則是單一標籤，例如 <carrier/>，標籤的結尾有個正斜線；

標籤內會有各種屬性或是內容，

一個完整的套件 (plugin) 看起來會像這樣：

(套件就是主畫面上的各種元件，例如時間日期、電信業者名稱、行事曆、最近啟動的程式...等等)

<plugin clsid="{79EFB752-CB70-446d-B317-499723482B3D}" name="startmru" height="52">
  <mru y="3"/>
</plugin>

clsid、name 及 height 就是 plugin 的屬性，

而 <mru y="3"/> 就是 plugin 的內容 (包在 plugin 的頭尾標籤中)，

大概了解這些後我們就可以開始看 full.home.xml 了。


2.佈景資訊

<?xml version="1.0"?>
<home>
  <author>Microsoft Corporation</author>
  <contacturl>http://www.microsoft.com/</contacturl>
  <title lang="0x0409">Windows Default</title>
  <title lang="0x0412">Windows 기본값</title>
  <title lang="0x0411">Windows 標準</title>
  <title lang="0x0404">Windows 預設配置</title>
  <title lang="0x0804">Windows 默认方案</title>

  <version>1.0</version>

<?xml version="1.0"?> - 表示這是一個 XML 文件...

<home> - 佈景主題皆要以 home 標籤開始，在文件的最後可以看到他的結尾標籤 </home>。

上面兩個標籤不會有機會去動到，以下開始才是需要修改的內容：

<author> - 佈景的作者。

<contacturl> - 作者的聯繫方式。

<title> - 佈景的名稱，也就是會出現在「設定 - 主畫面」中的佈景名稱。

這裡可以看到它有一個屬性 lang，這個屬性表示該佈景在各種語系環境下要顯示的名稱，

由上到下分別是英文、韓文、日文、正體中文及簡體中文，如果不想為各個語系都弄一個名稱，

可以簡化為：

<title>Windows 預設配置</title>

只留一個佈景名稱，

這樣不管在什麼語言環境下都是顯示 "Windows 預設配置"；

<version> - 佈景的版本。


3.預設屬性及背景。

<default target-width="240" target-height="320" font-face="nina" font-size="19" font-weight="normal" padding-left="5" padding-right="5" bgcolor="transparent" fgcolor="COLOR_HOMETEXT" padding-top="3" b-border-color="COLOR_HOMERULE" b-border-width="1">
  <format state="selected" fgcolor="COLOR_HOMEHIGHLIGHTTEXT"/>
</default>

<default> - 預設屬性，套件 (plugin) 中有需要指定卻沒指定的屬性時，就會到這邊找。

target-width、target-height - 主畫面寬高，通常是不用更改，預設就是 QVGA 的解析度了。
font-face - 字體。
font-size - 字型大小。
font-weight="normal" - 字型樣式，
這裡預設是使用 "normal"(正常)，另外可指定像是 "bold"(粗體，中文不適用)。
padding-left - 套件的內容和左邊界的距離。
padding-right - 套件的內容和右邊界的距離。
bgcolor="transparent" - 背景顏色，
transparent 表示透明，這樣平常才看的見背景圖片。
fgcolor="COLOR_HOMETEXT" - 文字顏色，
COLOR_HOMETEXT 表示使用色彩配置中的 COLOR_HOMETEXT，色彩配置後面會提到。
padding-top - 套件的內容和上邊界的距離。
b-border-color - 框線顏色，
框線就是每個套件下面都會出現的那條線，用來和下一個套件作區分。
b-border-width - 框線粗細。

<format> - 各種狀態下的格式，必須要和 state 屬性一起使用。

state - 狀態，比較常見的是 selected，表示選擇到這個套件的時候。

這樣聽起來好像很複雜，不過把這整段翻成中文就很淺顯易懂了：

<format state="selected" fgcolor="COLOR_HOMEHIGHLIGHTTEXT"/> 等於

當選擇到這個套件的時候 (state="selected")，文字顏色 (fgcolor) 使用 COLOR_HOMEHIGHLIGHTTEXT。

<background bgimage="\\windows\\WindowsMobile.jpg" bgimage-rotated="\\windows\\WindowsMobileLS.jpg" valign="bottom" bgcolor="COLOR_TRAYGRADLEFT" />

<background> - 佈景的背景。

bgimage - 背景圖片。
bgimage-rotated - PPC 才用的到的東西，橫向顯示時的背景圖片。
valign="bottom" - 對齊，bottom 表示對齊底部，
在背景圖片超過解析度大小的狀況下，對齊 bottom 就會看不到背景圖片上部超出的部份，
相反的，對齊 top 就會看不到背景圖片下部超出的部份。
bgcolor - 背景顏色，這裡也是使用待會會提到的色彩配置。


4.色彩配置

<scheme>
  <color name="COLOR_TRAYGRADLEFT" value="#2E97E3" />
  <color name="COLOR_HOMEHIGHLIGHT" value="#50A5E5" />
</scheme>

色彩配置使用 <scheme> 標籤包住所有色彩的設定，

就是各種系統色彩的設定。

色彩配置表還能拿來當捷徑使用，

當有任何屬性指定色彩配置中的顏色時 (name)，就會被替換成 value 中的值，

例如 bgcolor="COLOR_TRAYGRADLEFT" 實際上就是 bgcolor="#2E97E3"，

這樣做的好處是，當您日後想變更整個佈景的色系，

只要來這邊修改就好，不用到各個屬性中更改顏色值，

這裡只指定了兩個，其他都使用系統預設，其實色彩配置的項目很多，

官方提供的屬性表如下：

COLOR_WINDOW
所有應用程式視窗和控制項的背景色彩，包括捲軸的透明部位。
COLOR_WINDOWTEXT
清單檢視、控制項和標籤的文字色彩。未設定功能表文字色彩、軟鍵文字色彩或按鈕文字色彩。
COLOR_STATIC
靜態控制項的背景色彩，例如標籤。同時設定訊息方塊的背景色彩。
COLOR_STATICTEXT
靜態控制項的文字色彩，例如標籤。
COLOR_HIGHLIGHT
清單檢視、控制項、功能表和軟鍵按鈕的選取區域色彩。
COLOR_HIGHLIGHTTEXT
當項目有選取區域時的文字色彩，例如清單檢視元素或控制項和反白的軟鍵。
COLOR_MENU
功能表的背景色彩。
COLOR_MENUTEXT
功能表項目的文字色彩。
COLOR_GRAYTEXT
停用的文字色彩，例如停用的功能表項目和軟鍵按鈕。
COLOR_GRADLEFT
背景漸層的起始色彩值。
COLOR_GRADRIGHT
背景漸層的結束色彩值。
COLOR_INTGRADLEFT
次要背景漸層的起始色彩值。
COLOR_INTGRADRIGHT
次要背景漸層的結束色彩值。
COLOR_HIGHGRADLEFT
不支援漸層的醒目提示。 COLOR_HIGHGRADLEFT 和 COLOR_HIGHGRADRIGHT 必須設定成相同的數值。
COLOR_HIGHGRADRIGHT
不支援漸層的醒目提示。 COLOR_HIGHGRADLEFT 和 COLOR_HIGHGRADRIGHT 必須設定成相同的數值。
COLOR_TRAYGRADLEFT
標題列漸層的起始色彩值。
COLOR_TRAYGRADRIGHT
標題列漸層的結束色彩值。
COLOR_TRAYTEXT
標題列文字的色彩。
COLOR_WINDOWFRAME
主視窗和軟鍵區域之間以及捲軸縮圖周圍邊框的分隔線色彩。
COLOR_BTNFACE
軟鍵區域中未選取的背景色彩。
COLOR_BTNTEXT
軟鍵區域、導覽圖像和捲軸縮圖中未選取的背景色彩。
COLOR_SCROLLBAR
捲軸線條的色彩。
COLOR_ALERTTITLE
警示內標題文字的色彩。
COLOR_ALERTWINDOW
警示的背景色彩。
COLOR_ALERTRULE
警示的分隔線的色彩。
COLOR_HOMERULE
[首頁] 螢幕上分隔線的色彩。
COLOR_HOMETEXT
[首頁] 螢幕上未選取文字的色彩。
COLOR_HOMEHIGHLIGHTTEXT
[首頁] 螢幕上已選取文字的色彩。
COLOR_HOMEHIGHLIGHT
[首頁] 螢幕上已選取嵌入程式的色彩。

有興趣的夥伴就自己試試嘍。

其實色彩配置可以獨立出來成為另一個 XML 檔案 (*.scheme.xml)，

也就是出現在「設定 - 主畫面」中的色彩配置，不過這不是今天的主題，這裡就不多說了。


5.套件 - 圖示列

<plugin clsid="{837FC251-FE69-43ad-84E0-EBCEDEBA0884}" name="iconbar" height="27">
  <iconbar fgcolor="COLOR_TRAYTEXT"/>
  <background gradient="title" bgcolor="COLOR_TRAYGRADLEFT" b-border-color="COLOR_WINDOWFRAME" />
</plugin>

終於開始套件的部份了，

套件出現的順序及出現與否可看個人喜好，有人喜歡主畫面上顯示各種資訊，

但喜歡主畫面乾乾淨淨看的到整張桌布的人也是很多；

修改時只要記得一個原則，要移動順序就是整個 <plugin>...</plugin> 區塊一起移動，

不能只移動套件裡面的某些東西到其他套件中；

進入正題，

圖示列就是訊號強度、電量、可否使用 GPRS、有未接來電、有新訊息...這個區塊，

套件以 <plugin> 標籤包住，clsid 和 name 的關係您可以把它想成 IP 和網址的關係，

只看 clsid 一般人肯定是認不出這是什麼套件，加上個 name 就比較好懂了，

clsid - 不可修改，它是用來指定這是什麼套件。

name - 這部份就隨意了，容易辨識為主。

height - 這個區塊在主畫面佔用的高度。

套件的呼叫到這裡告一段落，接下來看看它的內容，

<iconbar> - 圖示列的實體，裡面的屬性上面已經解釋過了。

實體就是看的到的東西，套件的呼叫只是在主畫面中佔用的一塊區域，

一直到呼叫套件中提供的實體，在主畫面中才會有東西顯示出來，

<iconbar> 實際上就是主畫面的那些圖示。

<background> - 套件的背景。

gradient="title" - 使用漸層背景，
拿掉這個屬性標題就會變成單色：

bgcolor - 背景顏色。
b-border-color - 框線顏色，
使用漸層背景時，背景顏色及框線顏色都沒意義 (也就是說，若要使用漸層，就能砍掉這兩個屬性)，

所以要自訂背景及框線的話，首先就是要取消漸層，

不使用漸層的情況：
<background bgcolor="COLOR_TRAYGRADLEFT" b-border-color="#FF0000" />


有沒有發現我並沒有指定框線的粗細?

這就是 <default> 標籤的作用，我沒有指定的，就會到 <default> 標籤裡去找；

不想讓圖示列的背景遮住桌布的話，可以用透明背景：
<background bgcolor="transparent" b-border-width="0" />
其實 bgcolor="transparent" 這段可以不要，因為 <default> 標籤裡面已經設定過了，
若是您在 <default> 中已經指定b-border-width="0"，甚至可以把 <background> 這整段拿掉。



6.套件 - 常用程式

<plugin clsid="{79EFB752-CB70-446d-B317-499723482B3D}" name="startmru" height="52">
  <mru y="3"/>
</plugin>

最近使用的程式會在這邊顯示出來，

<mru> - 常用程式的實體。

這裡只使用了一個屬性 y - 和套件區塊上邊緣的距離，

以套件區塊的左上角座標為 (0,0)，x 座標向右，y 座標向下。

其實 <mru> 還有很多屬性可以用，列舉幾個比較特別的：

icon-size - 圖示大小，設為 16 或 32 分別會像這樣：
<mru y="3" icon-size="xx"/>(注意：套件的 height 屬性記得一起更改)


button-image - 背景圖片，
選擇的 icon 不是只有單色能用，不過這個部份不在今天討論的範圍。
button-transparent-color - 和上面的屬性一起使用，指定背景圖片中的一色為透明色。
<mru y="3" button-image="xxx" button-transparent-color="xxx"/>


max-button - 指定顯示多少個 icon。
<mru y="3" max-buttons="x"/>

這個範例使用了套件中提供的另一個實體 <appname>，
所以這個範例的完整語法應該是：
<mru y="3" max-buttons="2"/><appname x="100" y="13" fgcolor="#000000"/>


7.套件 - 系統資訊

<plugin clsid="{E09043DF-510E-4841-B652-388316977A7A}" name="carrier" height="46">
  <label>
    <text><carrier/></text>
  </label>
  <clock>
    <time y="21"/>
    <date y="21" halign="right"/>
  </clock>
</plugin>

這個套件用來顯示電信業者名稱、時間及日期，

<label> - 將此標籤的內容顯示在主畫面上。

<text> - 想要顯示的文字必須要用這個標籤包起來。

<carrier> - 等於電信業者名稱。

<clock> - 時間及日期。

<time> - 時間實體。

<date> - 日期實體。

halign - 對齊方式，right 等於對齊右邊。

這裡能玩的變化就比較多了，來看看下面這個範例：



原始碼：

<plugin clsid="{E09043DF-510E-4841-B652-388316977A7A}" name="carrier" height="32">
  <label halign="left" y="3" font-size="16">
    <text><carrier/></text>
  </label>
  <clock>
    <date font-size="16" mode="short" halign="right" y="3" />
    <time font-weight="bold" font-size="34" halign="center" y="-6" />
  </clock>
</plugin>

這個範例使用了一個前面沒見過的屬性，

mode - 格式，
用於 <date> 時屬性值有兩個：
long - 等於「設定 - 區域設定」中的完整日期樣式。
short - 等於「設定 - 區域設定」中的簡短日期樣式。

這個屬性也能用於 <time> 中，屬性值：
12 - 使用 12 小時制。
24 - 使用 24 小時制。

這裡還要說明一個觀念，套件中的各個實體，如果沒有指定座標，

會全部以 (0,0) 為座標出現，也就是各個實體會疊在一起，

不像編輯網頁時是一個接著一個彼此不重疊，

所以除了使用座標定位外，還可以使用對齊 (水平 halign 或垂直 valign) 的方式來將各個實體作定位，

這個範例中就分別將業者名稱、時間、日期分別定位到左 (left)、中 (center)、右 (right)，

這樣就不用費心去計算座標該設為多少。


8.套件 - 通話狀態

<plugin clsid="{37391041-C324-4725-BEE1-3232ED3539CA}" name="callprog" height="50">
  <background>
    <format state="selected" bgcolor="COLOR_HOMEHIGHLIGHT"/>
  </background>
  <format state="nocall" visible="false"/>
  <label>
    <text lang="0x0409">Call in progress:</text>
    <text lang="0x0412">진행 중인 전화:</text>
    <text lang="0x0411">通話中:</text>
    <text lang="0x0404">通話中:</text>
    <text lang="0x0804">通话中...</text>
  </label>
  <label y="23">
    <text><progress/></text>
  </label>
</plugin>

通話中回到主畫面時會顯示的套件：



這個套件中使用了兩個 <format>，分別用於背景及套件上，

第一個用於背景，意思是說 "當這個套件被選擇的時候，背景顏色為 COLOR_HOMEHIGHLIGHT"，

第二個用於套件，意思是說 "非通話時 (nocall)，不顯示這個套件 (visible="false")"，

<progress> - 通話狀態，也就是上圖的 "撥號中: 語音信箱" 及 "語音信箱" 這個部份。


9.套件 - 未接來電

<plugin clsid="{0BA8ABB8-1F1D-417f-88C6-DA8530E2E7A6}" name="missedcalls" height="25">
  <background>
    <format state="selected" bgcolor="COLOR_HOMEHIGHLIGHT"/>
  </background>
  <format state="nocall" visible="false"/>
  <label h="22">
    <text lang="0x0409">Missed calls: <calls/></text>
    <text lang="0x0412">부재 중 전화: <calls/></text>
    <text lang="0x0411">着信あり: <calls/></text>
    <text lang="0x0404">未接來電: <calls/></text>
    <text lang="0x0804">未接电话: <calls/></text>
  </label>
</plugin>

有未接來電才會顯示在主畫面上，

h - height 的縮寫，即高度 (同樣的，w 為width 的縮寫，寬度)。

<calls> - 顯示有多少個未接來電 (只有數字)。


10.套件 - 全天活動

<plugin clsid="{2FFD93B3-0FF0-4228-A6D6-D2DF177D7D92}" name="alldayevent" height="25">
  <background>
    <format state="selected" bgcolor="COLOR_HOMEHIGHLIGHT"/>
  </background>
  <format state="noevent" visible="false"/>
  <label h="22">
    <text><subject/></text>
  </label>
</plugin>

今明兩天有全天活動時才會顯示，

<subject> - 全天活動的主旨。


11.套件 - 行事曆

<plugin clsid="{865A354A-4A96-4687-B001-C155DC0DBE76}" name="calendar" height="50">
  <background>
    <format state="selected" bgcolor="COLOR_HOMEHIGHLIGHT"/>
  </background>
  <label h="22">
    <text><subject/></text>
  </label>
  <label h="22" y="23">
    <text><time/> <location/></text>
  </label>
</plugin>

顯示最近約會，

<subject> - 約會主旨。

<time> - 約會時間。

<location> - 約會地點。


12.套件 - 操作模式

<plugin clsid="{95976968-45D5-40c9-9779-2B859B1C2FEC}" name="profile" height="25">
  <background>
    <format state="selected" bgcolor="COLOR_HOMEHIGHLIGHT"/>
  </background>
  <label>
    <text lang="0x0409" singleline="true">Profile: <profile/></text>
    <text lang="0x0412" singleline="true">프로필: <profile/></text>
    <text lang="0x0411" singleline="true">プロファイル: <profile/></text>
    <text lang="0x0404" singleline="true">操作模式: <profile/></text>
    <text lang="0x0804" singleline="true">情景模式: <profile/></text>
  </label>
</plugin>

<profile> - 顯示目前的操作模式。

singleline="true" - 單行顯示 (也就是略過內容中的換行)。


13.套件 - 區域訊息廣播

<plugin clsid="{4e822425-a00f-497c-80ff-1c554665a369}" name="cooltext" height="25">
  <scrolltext textsource="cellbroadcast"/>
  <background>
    <format state="selected" bgcolor="COLOR_HOMEHIGHLIGHT"/>
  </background>
</plugin>

國內沒有這樣的服務，我就不多做解釋了。


14.套件 - 語音信箱 (及訊息)

<plugin clsid="{DCE58428-275E-491f-B835-F2AC38D0CC17}" name="voicemail" height="25">
  <background>
    <format state="selected" bgcolor="COLOR_HOMEHIGHLIGHT"/>
  </background>
  <label>
    <text lang="0x0409">Voicemail: <unreadVMail/></text>
    <text lang="0x0412">음성 메일: <unreadVMail/></text>
    <text lang="0x0411">ボイスメール: <unreadVMail/></text>
    <text lang="0x0404">語音信箱: <unreadVMail/></text>
    <text lang="0x0804">语音信箱: <unreadVMail/></text>
  </label>
</plugin>

語音信箱中有多少未聽取留言，

很遺憾的是目前我們也用不到這個東西，有可能是電信業者沒有提供，

或者這是給手機有內建答錄機的機種用的，這點我不清楚，也許是我不知道該怎麼用；

而且很奇怪的是，使用 {DCE58428-275E-491f-B835-F2AC38D0CC17} 這個 clsid 是錯誤的...

必須使用 {2F930BF0-6FE9-4a53-9E17-88E9247BAB48} 才能正常顯示，至於原因，我也不暸；

這個套件提供了三個實體：

<unreadVMail/> - 未讀留言 (只有數字)。

<unreadSMS/> - 未讀簡訊 (只有數字)。

<unreadEmail/> - 未讀郵件，包含 Outlook 郵件、Hotmail 郵件及 MMS (只有數字)。

所以這個套件可以這樣寫會比較適合：

<plugin clsid="{2F930BF0-6FE9-4a53-9E17-88E9247BAB48}" name="msgcount" height="25">
  <background>
    <format state="selected" bgcolor="COLOR_HOMEHIGHLIGHT"/>
  </background>
  <label>
    <text>語音信箱(<unreadVMail/>)/簡訊(<unreadSMS/>)/郵件(<unreadEmail/>)</text>
  </label>
</plugin>

或是不使用這個套件，因為下面要介紹的，也是和簡訊和郵件相關的套件。


15.套件 - 簡訊及郵件

  <plugin clsid="{8486CC1E-025B-4888-9C76-048DF7C1787D}" name="msgcount2" height="25" autoheight="false">
    <background>
      <format state="selected" bgcolor="COLOR_HOMEHIGHLIGHT"/>
    </background>
    <mail account="sms"/>
  </plugin>
  <plugin clsid="{8486CC1E-025B-4888-9C76-048DF7C1787D}" name="msgcount2" height="25" autoheight="false">
    <background>
      <format state="selected" bgcolor="COLOR_HOMEHIGHLIGHT"/>
    </background>
    <mail account="activesync"/>
  </plugin>
  <plugin clsid="{8486CC1E-025B-4888-9C76-048DF7C1787D}" name="msgcount2" height="25" autoheight="true">
    <text padding-bottom="5"/>
    <background>
      <format state="selected" bgcolor="COLOR_HOMEHIGHLIGHT"/>
    </background>
    <mail account="others"/>
  </plugin>
</home>

這裡使用了三個同樣的套件，

可是在實體中分別使用了不同的屬性，

<mail account="sms"/> - 未讀簡訊。

<mail account="activesync"/> - 未讀郵件 (Outlook 郵件)。

<mail account="others"/> - 其他未讀訊息 (Hotmail 及 MMS)。

和上一個套件不同之處，在於這個套件是實體直接產生 "簡訊 (0)"，

而上一個套件只會產生 "0"，所以上一個套件比較適合拿來做複雜的佈景，因為可塑性較高；

autoheight - 自動調整高度，
因為其他未讀訊息的部份包含了 Hotmail 及 MMS，
有時是單行，有時是雙行，所以加上這個屬性讓它自動調整高度。

最後是 </home>，表示文件結束。


16.最後

因為內容很多，所以寫的有點混亂，如果有遺漏或錯誤的部份，

還請各位夥伴提供意見，我再把它補上。

5/3 更新：

　替換了一些圖片讓文章更符合標題。

　更正官方色彩配置表中的錯誤。