程式設計 Club

2017-02-06T18:20:00.003-08:00

K-K App 生活樂園工作室隱私權政策
更新日期：2016/02月

本文說明「K-K App 生活樂園工作室」的隱私權政策。請您詳細閱讀，本文不定期更新，您若繼續使用「K-K App 生活樂園工作室的 APP」，即代表您同意相關此政策。

1. 個人資料之類別
當您使用「K-K App 生活樂園工作室的 APP」（下稱「本APP軟體」）時，本團隊會蒐集下列類別的個人資料：網路IP、手機所屬電信商代碼等，如果您有付費使用到Google Play Store或App Store的應用程式內付費功能，則依照市集平台的系統內建功能，在付費的交易紀錄裡，收集姓名、email、以及郵遞區號資訊。

2. 資料的收集與應用
「K-K App 生活樂園工作室的 APP，有收集下述資料：

(1) 當撥打內建在APP裡的各種電話服務時，本APP不會記錄撥打次數、時間、所在國家、位置資訊（Location）。

(2) 當您透過網站或者是APP回報意見或問題時，寄信所使用之email。此蒐集目的作為處理問題後，回覆您之用途，不會販賣給第三方使用。

(4) 本APP有採用Google Analytics，匿名性的收集瀏覽各頁以及撥號紀錄狀況，以持續改善，調整出使用者最喜歡常用的內容。

(5) Google Play 付費，或者App Store 的付費版本，兩平台的市集，會紀錄您的email 、姓名，以及郵遞區號，這些都屬於系統的紀錄，我們不會拿來對外界公開。

(7) 收集手機的裝置代碼（device ID 或device token )，作為推播訊息使用。

3. 第三方函式庫整合
(1) 本APP軟體有採用Google官方的APP流量統計軟體Google Analytics來評估APP各項功能操作的行為，目的是為了改善優化產品，提供更適合用戶偏好喜歡的內容。
(2) 本APP軟體整合行動廣告服務，會使用到第三方廣告系統的函式庫，目前使用 google Admod 公司的廣告系統。
(3) 本APP軟體，查詢在地餐廳、咖啡廳、飲食，採用Google API，查詢時，會使用手機拿到的座標經緯度，來搜尋附近推薦店家。

4. 本軟體不會收集的項目
凡是您自行新增之撥打號碼規則，「K-K App 生活樂園工作室的 APP」不會做收集，以維護您的個人隱私。

5. 「K-K App 生活樂園工作室的 APP」的資料儲存與保護

「K-K App 生活樂園工作室的 APP」為方便用戶使用，提供多項個人化設定功能。包含「我的最愛清單」、「新增撥號規則」。這些都是儲存在手機的記憶體內，請您妥善保管手機。

6. 同意個人資料之蒐集、處理、利用或國際傳輸：
您了解並同意本團隊依本「隱私權政策」及相關法規，蒐集、處理或利用您所提供的個人資料。

7. 除下列情形外，本團隊不會任意將您的個人資料出售、轉讓或揭露予任何第三人：
(1) 本團隊／本APP軟體將因法律規定、法院命令、行政調查或其他法律程序的要求而提供您的資料，惟在此情形下，該資料只會單純提供予調查單位，並受中華民國相關應適用法律的保護。
(2) 為了調查和防止非法活動、涉嫌詐欺、對人身安全有潛在威脅的狀況、對本團隊／本APP軟體服務條款的違反，或為了對上述情形採取應對措施。
(3) 本APP軟體或本團隊被其他公司收購或合併，我們有權利將您的個人資料移轉給該公司。如果發生這種情況，本APP軟體會在您的個人資料被移轉且將適用不同的隱私權政策前通知您。

8. 個人資料之安全
本團隊將依相關法律規定，採取適當的技術性和組織性等安全措施，保護您所提供的個人資料，並限於因業務需要必須接觸您個人資料的員工，始有權限接觸到您的個人資料。本團隊已採取符合法規要求的實體、電子和程序防護措施，以保護您個人資料的安全。但請注意，儘管本團隊會盡力保護您的個人資料，仍無法保證您的個人資料百分之百不會遭受第三人之非法攔截、傳送或盜駭。

如果您有任何關於本隱私權政策的問題，請來信討論：chiang.kevin0603@gmail.com

How to create file and directory in Java.

2016-09-21T17:56:00.003-07:00

String filePath = "logs/test.log";
File file = new File(filePath);

此時如果直接createNewFile()

if(!file.exists())
{
 try {
  file.createNewFile();
 } catch (IOException e) {
  // TODO Auto-generated catch block
  e.printStackTrace();
 }
}

會因為parent的資料夾不存在而失敗，而這時直接使用mkdirs()

if(!file.exists())
{
 file.mkdirs();
 try {
  file.createNewFile();
 } catch (IOException e) {
  // TODO Auto-generated catch block
  e.printStackTrace();
 }
}

但這樣會把01.log也當成資料夾建立，就無法createNewFile，所以應該先切換到上層目錄再進行mkdirs()

if(!file.exists())
{
 file.getParentFile().mkdirs();
 try {
  file.createNewFile();
 } catch (IOException e) {
  // TODO Auto-generated catch block
  e.printStackTrace();
 }
}

取得螢幕實際寬高的方法

2016-09-20T17:56:00.001-07:00

取得螢幕實際寬高的方法

標籤： Android

基本上這方法就寫在官方的 doc 裡
網路搜尋的話也很容易找到
不過還是在此記錄一下

1

2

3

4

5

DisplayMetrics displaymetrics = new DisplayMetrics();

//使用 Activity 的 getWindowManager()獲得 WindowManager

getWindowManager().getDefaultDisplay().getMetrics(displaymetrics);

int height = displaymetrics.heightPixels;

int width = displaymetrics.widthPixels;

主要就是在 Activity 裡利用 getWindowManager() 先取得系統唯一的 WindowManager
然後取得一個 DisplayMetrics 物件
這物件主要是存放解析度相關的屬性
包含 densityDpi, widthPixels, heightPixels ... 等

所以利用 DisplayMetrics 很簡單就得到螢幕實際像素了

WindowManager 除了透過 Activity 的 getWindowManager()獲得之外
還可以透過 Context 的 getSystemService(Context.WINDOW_SERVICE) 取得
所以 code 也可以這樣改

public static int[] getDisplayPixels(Context context){

 DisplayMetrics displaymetrics = new DisplayMetrics();

 WindowManager windowManager = (WindowManager) context.getSystemService(Context.WINDOW_SERVICE);

 windowManager.getDefaultDisplay().getMetrics(displaymetrics);

 int width = displaymetrics.widthPixels;

 int height = displaymetrics.heightPixels;

 return new int[]{width, height};

}

學習Apple Swift語言不可錯過的六個免費網路資源

2015-04-20T17:29:00.001-07:00

學習Apple Swift語言不可錯過的六個免費網路資源

3 則迴響

Swift語言是Apple在2014年六月推出的一個新的程式語言，將取代舊有的Objective-C程式，成為iOS以及Mac OS X平台的標準語言，如果想儘快學習這門新語言，該如何開始呢？

以下我分享六個最實用的Swift網路學習資源，希望對你有所幫助：

1. Swift官方電子書（Apple官方提供）

你可以透過iTunes下載這本電子書到你的iPhone或iPad上，如果你想要用一般的PC來閱讀，它也有網頁版本，你可以透過網頁版本在你的PC上面瀏覽並學習。

＊電子書下載連結（iTunes）：The Swift Programming Language

＊PC網頁版本：The Swift Programming Language網頁版本

2. Swift中文電子書（熱心網友翻譯）

Apple提供的Swift電子書雖然是官方釋出，但可惜是英文版本，許多人可能看到數百頁的英文電子書就要昏了… 好消息是，有中國的網友號召30多人把這本數百頁的英文電子書翻譯成中文了，只花了九天，相當了不起！

＊Swift中文電子書：The Swift Programming Language 中文版

3. Swift官方部落格（提供最新消息，學習資訊）

Apple為了推廣Swift，特別建立了部落格來提供Swift程式語言的最新消息，以及學習的資訊。因為Swift是一個很新的語言，不免仍然會有一些語法上的修改，這個部落格時常將最新的Swift版本或語法更新在這裡發佈，建議想學習Swift的朋友也要常常關注這個部落格來學習最新的內容。

＊Swift官方部落格：Swift部落格連結

4. 知名國外教學網站Ray Wenderlich

Ray Wenderlich是一個專業的國外教學網站，專注於iOS開發以及App遊戲設計，從2014年六月起，已經在他們網站上製作了不少Swift的相關教學文章（目前已有十多篇），他們的教學相當不賴，你可以在以下連結找到他們提供的Swift學習指導教學。

＊Ray Wenderlich的Swift免費教學：Swift免費教學文章

5. 想找Swift範例程式碼？到GitHub上面找吧！

GitHub是一個程式碼版本控制網站，上面持續累積的Swift程式碼，已經高達9000個以上了，內容也經橫跨不同應用，十分地豐富，對於Swift已經有一些了解，想要找別人寫好的程式碼來學習的朋友，可以到GitHub上面找找看。

＊ GitHub上語言標記為Swift的程式搜尋結果：超過9000個以上的Swift程式範例

6. 有問題想問人該去哪裡問呢？Stack Overflow是首選！

Stack Overflow是一個國外知名的IT技術問答網站，從Swift發表到現在約三個多月，Stack Overflow上面關於Swift語言的問題已經累積達8500個以上，由於這個網站的聚集了許多程式設計方面的專家，如果在自學上遇到問題，也可以先來這裡看看是否已有這個問題的解答。

＊Stack Overflow的Swift語言相關問題：Stack Overflow上的Swift程式相關問題

快速結論

學習Swift程式不可錯過的六個免費網路資源，除了Apple官方的Swift程式語言電子書，以及Swift官方部落格之外，還有網友合力翻譯的Swift中文電子書、國外Ray Wenderlich網站的專業教學、GitHub上的豐富程式碼資源，以及Stack Overflow的問答知識庫，這些資源都可以給你很大的學習幫助。

Android 禁止螢幕旋轉 & 螢幕旋轉不刷新 Activity & 動態更改螢幕方向

2015-03-12T20:59:00.001-07:00

資料來源：http://gaebolg.blog.163.com/blog/static/19826906820134312050504/

一、禁止螢幕旋轉：

打開工程中的 AndroidManifest.xml 檔，在 <activity> </activity> 中，添加一條屬性資訊：

android:screenOrientation="portrait" （強制豎屏）

android:screenOrientation="landscape" （強制橫屏）

二、螢幕旋轉不刷新 Activity：

當螢幕旋轉時，會重新執行 Activity 中的 onCreate() 方法，即刷新了 Activity 的顯示。若是不想刷新，可以用第一種方法鎖屏，也可以用以下方法：

1、打開工程中的 AndroidManifest.xml 檔，在 <activity> </activity> 中，添加一條屬性資訊：

android:configChanges=”orientation|keyboardHidden”

注：這個屬性指的是，當後邊屬性值代表的事件發生時，Activity 會執行某個函數，orientation 指的是當螢幕旋轉時，keyboardHidden 指的是鍵盤輔助功能改變。“|”為或符號，指這兩個中任意一個發生，就執行 Activity 某個函數。

注2：如果你的開發 API 等級等於或高於 13，你還需要設置 screenSize，因為 screenSize 會在螢幕旋轉時改變。

2、在對應 Activity 中重寫 onConfigurationChanged() 方法：

@Override
public void onConfigurationChanged(Configuration newConfig) {
    // TODO Auto-generated method stub
    super.onConfigurationChanged(newConfig);
    if (newConfig.orientation == Configuration.ORIENTATION_LANDSCAPE) {
        // 什麼都不用寫
    }
    else {
        // 什麼都不用寫
    }
}

注：如果在 if、else 中，使用了 setContentView(R.layout.xxxx) 函數，那麼就可以實現：每次螢幕旋轉時，調用不同的佈局。

三、動態更改螢幕方向：

有些時候，我們不需要把程式寫死，需要在程式中有需要的時候旋轉螢幕，例如：在“設置”裏添加一個 ListView 項，可通過點擊選擇橫屏或豎屏。（比如：電子書軟體）

假設有一個按鈕，我們僅重寫 OnClick() 函數：

@Override
public void onClick(View v) {

    // 如果是豎排，則改為橫排
    if (getRequestedOrientation() == ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE) {
        setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);
    }

    // 如果是橫排，則改為豎排
    else if (getRequestedOrientation() == ActivityInfo.SCREEN_ORIENTATION_PORTRAIT) {
        setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE);
    }

}

重點就是：getRequestedOrientation() 函數、setRequestedOrientation() 函數的使用。

注意：使用這種方法，必須事先在 AndroidManifest.xml 的 <activity> </activity> 中，添加android:screenOrientation 屬性值，不然 getRequestedOrientation() 可能會出問題。

[Android] 在APP 裡面呼叫Line APP

2015-03-10T19:01:00.001-07:00

Line跟facebook一樣在安裝了 Line/Facebook app後,
可以簡單的利用startActivity來進行一些簡單的PO文動作, 也就是藉由他本身的
app去執行api。
相反來說, 若是想利用自己的app去發request 就要去add naver/facebook 的library, 這樣能做到的事更多, 但是較為麻煩。
這邊將介紹如何透過簡單的方式來PO文到line上

//判斷是否安裝了line
private boolean checkLineInstalled(){
PackageManager pm = getPackageManager();
m_appList = pm.getInstalledApplications(0);
boolean lineInstallFlag = false;
for (ApplicationInfo ai : m_appList) {
if(ai.packageName.equals(PACKAGE_NAME)){
lineInstallFlag = true;
break;
}
}
return lineInstallFlag;
}

//PO文字
public static final String PACKAGE_NAME = "jp.naver.line.android";
public static final String CLASS_NAME = "jp.naver.line.android.activity.selectchat.SelectChatActivity";
Intent intent = new Intent(Intent.ACTION_SEND);
intent.setClassName(PACKAGE_NAME, CLASS_NAME);
intent.setType("text/plain");
intent.putExtra(Intent.EXTRA_TEXT, sendText);
startActivity(intent);

//PO圖片
String fname = "send_image.jpg";
String fileFullPath = Environment.getExternalStorageDirectory().getAbsolutePath()
+ File.separator + fname;

Uri uri = Uri.fromFile(new File(fileFullPath));
Intent intent = new Intent(Intent.ACTION_SEND);
intent.setClassName(PACKAGE_NAME, CLASS_NAME);
intent.setType("image/jpeg");
intent.putExtra(Intent.EXTRA_STREAM, uri);
startActivity(intent);

Reference: https://gist.github.com/ekos/3993270

帶出所以有可以share的app
Reference:http://orgcent.com/android-app-intent-share-list/

Android-TextView多行本文滾動輕鬆實現

2014-12-16T23:31:00.001-08:00

Android中我們為了實現文本的滾動可以在ScrollView中嵌入一個TextView，其實TextView自己也可以實現多行滾動的，畢竟ScrollView必須只能有一個直接的子類佈局。只要在layout中簡單設置幾個屬性就可以輕鬆實現

  <TextView  
    android:id="@+id/tvCWJ"  
    android:layout_width="fill_parent"  
    android:layout_height="wrap_content"  
    android:scrollbars="vertical"   <!--垂直滾動條 -->
    android:singleLine="false"       <!--實現多行 -->
    android:maxLines="15"            <!--最多不超過15行 -->
    android:textColor="#FF0000"
    />

當然我們為了讓TextView動起來，還需要用到TextView的setMovementMethod方法設置一個滾動實例，代碼如下:

1 2	TextView tvAndroid123 = (TextView)findViewById(R.id.tvCWJ); tvAndroid123.setMovementMethod(ScrollingMovementMethod.getInstance());

Android學習_建立程式內(application)的全域變數(Global Variable)

2014-11-12T01:35:00.003-08:00

Android學習_建立程式內(application)的全域變數(Global Variable)

在Activity間傳遞變數可以利用Bundle的方式來處理，但是如果當Activity太多，又每一個都可能運用到相同的參數，如每一個頁面都要去判斷登入者來決定可使用的功能，這時候可能會將值儲存在所謂的全域變數。

步驟：
1. 建立繼承於Application的類別


package tw.com.ola;
import android.app.Application;
public class GlobalVariable extends Application {
 public String UserID = "";
}

說明：
*必須要繼承Application
*可以自行撰寫getter或setter，就跟一般的類別檔一樣
*上述程式碼僅建立一個外部可讀寫的變數UserID

2. 設定AndroidManifest


<application android:name=".GlobalVariable" android:icon="@drawable/icon" android:label="@string/app_name">
      <activity android:name=".Activity_CheckAndroid" android:label="@string/Activity_CheckAndroid_Title" android:screenOrientation="landscape">
      <intent-filter>
              <action android:name="android.intent.action.MAIN" />
              <category android:name="android.intent.category.LAUNCHER" />
          </intent-filter>
      </activity>
</application>

說明：
*一般AndroidManifest中有一個application標籤，原本沒有android:name屬性，將第一步驟建立的類別檔加入，例：android:name=".GlobalVariable"。

3. 將值放入與將值讀出


//放入
GlobalVariable globalVariable = (GlobalVariable)context.getApplicationContext();
globalVariable.UserID = key_UserID;

//讀出
GlobalVariable globalVariable = (GlobalVariable)context.getApplicationContext();
String UserID = globalVariable.UserID;

說明：
*如此就可以將各個Activity都需要的變數，進行儲存與讀取的動作。

Android Intent的几种用法全面总结

2014-09-01T23:02:00.000-07:00

Intent应该算是Android中特有的东西。你可以在Intent中指定程序要执行的动作（比如：view,edit,dial），以及程序执行到该动作时所需要的资料。都指定好后，只要调用startActivity()，Android系统会自动寻找最符合你指定要求的应用程序，并执行该程序。

下面列出几种Intent的用法
显示网页:

Uri uri = Uri.parse("http://www.google.com");
Intent it = new Intent(Intent.ACTION_VIEW,uri);
startActivity(it);

复制代码

显示地图:

Uri uri = Uri.parse("geo:38.899533,-77.036476");
Intent it = new Intent(Intent.Action_VIEW,uri);
startActivity(it);

复制代码

路径规划:

Uri uri = Uri.parse("http://maps.google.com/maps?f=d&saddr=startLat%20startLng&daddr=endLat%20endLng&hl=en");
Intent it = new Intent(Intent.ACTION_VIEW,URI);
startActivity(it);

复制代码

拨打电话:
调用拨号程序

Uri uri = Uri.parse("tel:xxxxxx");
Intent it = new Intent(Intent.ACTION_DIAL, uri);
startActivity(it);

复制代码

Uri uri = Uri.parse("tel.xxxxxx");
Intent it =new Intent(Intent.ACTION_CALL,uri);
要使用这个必须在配置文件中加入<uses-permission id="android.permission.CALL_PHONE" />

复制代码

发送SMS/MMS
调用发送短信的程序

Intent it = new Intent(Intent.ACTION_VIEW);
it.putExtra("sms_body", "The SMS text");
it.setType("vnd.android-dir/mms-sms");
startActivity(it);

复制代码

发送短信

Uri uri = Uri.parse("smsto:0800000123");
Intent it = new Intent(Intent.ACTION_SENDTO, uri);
it.putExtra("sms_body", "The SMS text");
startActivity(it);

复制代码

发送彩信

Uri uri = Uri.parse("content://media/external/images/media/23");
Intent it = new Intent(Intent.ACTION_SEND);
it.putExtra("sms_body", "some text");
it.putExtra(Intent.EXTRA_STREAM, uri);
it.setType("image/png");
startActivity(it);

复制代码

发送Email

Uri uri = Uri.parse("mailto:xxx@abc.com");
Intent it = new Intent(Intent.ACTION_SENDTO, uri);
startActivity(it);

复制代码

Intent it = new Intent(Intent.ACTION_SEND);
it.putExtra(Intent.EXTRA_EMAIL, "me@abc.com");
it.putExtra(Intent.EXTRA_TEXT, "The email body text");
it.setType("text/plain");
startActivity(Intent.createChooser(it, "Choose Email Client"));

复制代码

Intent it=new Intent(Intent.ACTION_SEND);
String[] tos={"me@abc.com"};
String[] ccs={"you@abc.com"};
it.putExtra(Intent.EXTRA_EMAIL, tos);
it.putExtra(Intent.EXTRA_CC, ccs);
it.putExtra(Intent.EXTRA_TEXT, "The email body text");
it.putExtra(Intent.EXTRA_SUBJECT, "The email subject text");
it.setType("message/rfc822");
startActivity(Intent.createChooser(it, "Choose Email Client"));

复制代码

添加附件

Intent it = new Intent(Intent.ACTION_SEND);
it.putExtra(Intent.EXTRA_SUBJECT, "The email subject text");
it.putExtra(Intent.EXTRA_STREAM, "file:///sdcard/mysong.mp3");
sendIntent.setType("audio/mp3");
startActivity(Intent.createChooser(it, "Choose Email Client"));

复制代码

播放多媒体

Intent it = new Intent(Intent.ACTION_VIEW);
Uri uri = Uri.parse("file:///sdcard/song.mp3");
it.setDataAndType(uri, "audio/mp3");
startActivity(it);

复制代码

Uri uri = Uri.withAppendedPath(MediaStore.Audio.Media.INTERNAL_CONTENT_URI, "1");
Intent it = new Intent(Intent.ACTION_VIEW, uri);
startActivity(it);

复制代码

Uninstall 程序

Uri uri = Uri.fromParts("package", strPackageName, null);
Intent it = new Intent(Intent.ACTION_DELETE, uri);
startActivity(it);

复制代码

顯示地圖與導航intent用法

2014-09-01T22:46:00.001-07:00

顯示地圖現成的Intent用法程式碼如下:
Uri uri = Uri.parse("geo:緯度,經度");

Intent intent = new Intent(Intent.ACTION_VIEW, uri);

startActivity(intent);

顯示導航現成的Intent用法程式碼如下:
Uri uri = Uri.parse("http://maps.google.com/maps?f=d&saddr=起點位置&daddr=終點位置&hl=tw");

路徑格式:
f=d&saddr=起點位置&daddr=終點位置&hl=tw
起點位置格式:Latitude,Longitude
終點位置格式:Latitude,Longitude
Intent it = new Intent(Intent.ACTION_VIEW, uri);
startActivity(it);

備註:記得要加入internet的使用權限

String vDirectionUrl = "https://maps.google.com/maps?f=d"
                     + "&saddr=" + 來源Latitude + "," + 來源Longitude
                     + "&daddr=" + 目的Latitude + "," + 目的Longitude
                     + "&hl=tw";

// 在 Google 地圖 App 顯示導航
Intent intent = new Intent( Intent.ACTION_VIEW, Uri.parse(vDirectionUrl) );
intent.setClassName("com.google.android.apps.maps", "com.google.android.maps.MapsActivity");
startActivity(intent);


Android

String strURL = "http://maps.google.com/maps?f=d&saddr=&daddr=&hl=;
/* 
   f=d：使用Google Map 導航功能
   saddr：傳入 開始位置(預設為目前位置)
   daddr：傳入 目的位置
   hl：指定語系 (Locale.getDefault().getCountry())
*/
Intent intent = new Intent();  
intent.setAction(android.content.Intent.ACTION_VIEW); 
intent.setData 
( 
    Uri.parse(strURL )
); 
startActivity(intent); 

iOS

    MKUserLocation *userLoc = self.myMapView.userLocation;
    NSString *destlatlong = [NSString stringWithFormat:@"%f,%f",
                             userLoc.location.coordinate.latitude,
                             userLoc.location.coordinate.longitude];
         
    NSString *url = [NSString stringWithFormat: @"http://maps.google.com/maps?f=d&saddr=%@&daddr=%@&z=12",
                     destlatlong,[strLoc stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding]];

    [[UIApplication sharedApplication] openURL:[NSURL URLWithString:url]];

[PHP] 簡易的圖片相似度比較

2014-06-02T20:20:00.000-07:00

出至：http://jax-work-archive.blogspot.tw/2012/04/php.html

<?php

/**

 * 圖片相似度比較

 *

 * @version     $Id: ImageHash.php 4429 2012-04-17 13:20:31Z jax $

 * @author      jax.hu

 *

 * <code>

 *  //Sample_1

 *  $aHash = ImageHash::hashImageFile('wsz.11.jpg');

 *  $bHash = ImageHash::hashImageFile('wsz.12.jpg');

 *  var_dump(ImageHash::isHashSimilar($aHash, $bHash));

 *

 *  //Sample_2

 *  var_dump(ImageHash::isImageFileSimilar('wsz.11.jpg', 'wsz.12.jpg'));

 * </code>

 */

class ImageHash {

    /**取樣倍率 1~10

     * @access public

     * @staticvar int

     * */

    public static $rate = 2;

    /**相似度允許值 0~64

     * @access public

     * @staticvar int

     * */

    public static $similarity = 80;

    /**圖片類型對應的開啟函數

     * @access private

     * @staticvar string

     * */

    private static $_createFunc = array(

        IMAGETYPE_GIF   =>'imageCreateFromGIF',

        IMAGETYPE_JPEG  =>'imageCreateFromJPEG',

        IMAGETYPE_PNG   =>'imageCreateFromPNG',

        IMAGETYPE_BMP   =>'imageCreateFromBMP',

        IMAGETYPE_WBMP  =>'imageCreateFromWBMP',

        IMAGETYPE_XBM   =>'imageCreateFromXBM',

    );

    /**從檔案建立圖片

     * @param string $filePath 檔案位址路徑

     * @return resource 當成功開啟圖片則回傳圖片 resource ID，失敗則是 false

     * */

    public static function createImage($filePath){

        if(!file_exists($filePath)){ return false; }

        /*判斷檔案類型是否可以開啟*/

        $type = exif_imagetype($filePath);

        if(!array_key_exists($type,self::$_createFunc)){ return false; }

        $func = self::$_createFunc[$type];

        if(!function_exists($func)){ return false; }

        return $func($filePath);

    }

    /**hash 圖片

     * @param resource $src 圖片 resource ID

     * @return string 圖片 hash 值，失敗則是 false

     * */

    public static function hashImage($src){

        if(!$src){ return false; }

        /*缩小圖片尺寸*/

        $delta = 8 * self::$rate;

        $img = imageCreateTrueColor($delta,$delta);

        imageCopyResized($img,$src, 0,0,0,0, $delta,$delta,imagesX($src),imagesY($src));

        /*計算圖片灰階值*/

        $grayArray = array();

        for ($y=0; $y<$delta; $y++){

            for ($x=0; $x<$delta; $x++){

                $rgb = imagecolorat($img,$x,$y);

                $col = imagecolorsforindex($img, $rgb);

                $gray = intval(($col['red']+$col['green']+$col['blue'])/3)& 0xFF;

                $grayArray[] = $gray;

            }

        }

        imagedestroy($img);

        /*計算所有像素的灰階平均值*/

        $average = array_sum($grayArray)/count($grayArray);

        /*計算 hash 值*/

        $hashStr = '';

        foreach ($grayArray as $gray){

            $hashStr .= ($gray>=$average) ? '1' : '0';

        }

        return $hashStr;

    }

    /**hash 圖片檔案

     * @param string $filePath 檔案位址路徑

     * @return string 圖片 hash 值，失敗則是 false

     * */

    public static function hashImageFile($filePath){

        $src = self::createImage($filePath);

        $hashStr = self::hashImage($src);

        imagedestroy($src);

        return $hashStr;

    }

    /**比較兩個 hash 值，是不是相似

     * @param string $aHash A圖片的 hash 值

     * @param string $bHash B圖片的 hash 值

     * @return bool 當圖片相似則回傳 true，否則是 false

     * */

    public static function isHashSimilar($aHash, $bHash){

        $aL = strlen($aHash); $bL = strlen($bHash);

        if ($aL !== $bL){ return false; }

        /*計算容許落差的數量*/

        $allowGap = $aL*(100-self::$similarity)/100;

        /*計算兩個 hash 值的漢明距離*/

        $distance = 0;

        for($i=0; $i<$aL; $i++){

            if ($aHash{$i} !== $bHash{$i}){ $distance++; }

        }

        return ($distance<=$allowGap) ? true : false;

    }

    /**比較兩個圖片檔案，是不是相似

     * @param string $aHash A圖片的路徑

     * @param string $bHash B圖片的路徑

     * @return bool 當圖片相似則回傳 true，否則是 false

     * */

    public static function isImageFileSimilar($aPath, $bPath){

        $aHash = ImageHash::hashImageFile($aPath);

        $bHash = ImageHash::hashImageFile($bPath);

        return ImageHash::isHashSimilar($aHash, $bHash);

    }

}

[Android] dp px 互換(dp px exchange)

2013-10-06T23:30:00.002-07:00

Image from BBC GEL

單位

dp : Density-independent pixel，獨立於螢幕解析度密度的像素值，也就是說，當你設定 1dp 時，在 120 dpi 的螢幕上會是原本的 75 %，在 160 dpi 的螢幕上為 100%，在 240 dpi 的螢幕上為 150%，實際的像素值會依螢幕密度而改變。

px : pixel ，一般所認知的像素值，指定多少就是多少，不會因螢幕密度不同而改變。所以 100 * 100 px 的方形在 320 x 480 螢幕的手機上看起來會比 1280 x 720 的螢幕上看起來大很多，這個方形實際上尺寸並沒有改變，改變的是螢幕解析度，放在一個較小的空間看起來比較大，放在一個較大的空間，看起來就會比較小。

這裡有圖示解說，看圖比較容易懂。

轉換

如果單純只在 layout 上指定值，直接指定 dp 就好了，但如果要在程式碼中指定就必須要做轉換，否則都是 px ，我們必須把它轉為 dp 才能和其他在 layout 中指定的元件有一樣的比例。

我自己是找到公式後寫成工具程式，直接叫用就好了，程式碼如下：

/**
 * Covert dp to px
 * @param dp
 * @param context
 * @return pixel
 */
public static float convertDpToPixel(float dp, Context context){
    float px = dp * getDensity(context);
    return px;
}

/**
 * Covert px to dp
 * @param px
 * @param context
 * @return dp
 */
public static float convertPixelToDp(float px, Context context){
    float dp = px / getDensity(context);
    return dp;
}

/**
 * 取得螢幕密度
 * 120dpi = 0.75
 * 160dpi = 1 (default)
 * 240dpi = 1.5
 * @param context
 * @return
 */
public static float getDensity(Context context){
 DisplayMetrics metrics = context.getResources().getDisplayMetrics();
 return metrics.density;
}

參考資料

http://developer.android.com/guide/practices/screens_support.html
http://www.bbc.co.uk/gel/tablet/tablet-device-considerations/pixel-density

php 取得遠端網站的內容

2013-10-06T22:57:00.003-07:00

取得遠端的網頁內容的函式名稱：

file_get_contents

用法：

$homepage=file_get_contents('http://www.kimo.com.tw');

echo $homepage

以PHP讀寫Excel檔案

2013-10-06T22:51:00.002-07:00

以PHP讀寫Excel檔案

Details: Written by 小羅

http://phpexcel.codeplex.com/

用google找了一下，PHPExcel類別的功能非常強大，支援各版本的Excel檔案、CSV、HTML及PDF檔案的讀寫，有這方面的需求，改用這套工具可以省卻不少自行撰寫工具的時間，對使用者來說，Excel檔案的親和性比起CSV檔案來說，好太多了，所以決定使用Excel作為報表讀取檔案。

文章起頭的網址是PHPExcel的官網，從官網下載套件後，下載套件內的說明文件非常詳盡，花一二天就可以讀懂，使用上並不困難，只是要花時間熟悉使用方法。

PHPExcel的安裝

解壓縮下載的套件後，將Class目錄放到類別目錄下。

PHPExcel的使用

require Class/PHPExcel.php後，PHPExcel會自動載入需要的所有類別，不需作後續設定。

PHPExcel的設計哲學

物件分成三大區塊

1)Excel檔的操控--針對Excel2007版本的Excel進行操控，所有操控都在記憶體中進行，檔案的寫入及讀取由其他物件負責。

2)Excel檔的讀取--包含各版本Excel、PDF、CSV等

3)Excel檔的寫入--包含各版本Excel、PDF、CSV等

讀取Excel檔案的操件方法

1)由PHPExcel決定載入檔案的種類，如Excel版本，而不硬性設定。

1.$reader

= 
PHPExcel_IOFactory::load(

'excel檔');

2)由PHPExcel決定載入檔案的種類，不硬性設定讀取的檔案種類，但將檔案設定為唯讀屬性。

$reader= 
PHPExcel_IOFactory::createReaderForFile('excel檔'); 

$reader->setReadDataOnly(true); 

$excel= $reader->load('excel檔');

讀取某一格的Excel內容

column由0開始

row由1開始

$sheet=$excel->getActiveSheet(); 

$sheet->getCell('A8') 

->getValue();

或

$sheet=$excel->getActiveSheet(); 

$sheet->getCellByColumnAndRow(2,8) 

getValue();

取得公式計算後的結果

$sheet=$excel->getActiveSheet(); 

$sheet->getCell('A8') 

->getCalculatedValue();

循序讀取cell的內容

<?php 

$objReader = 
PHPExcel_IOFactory::createReader('Excel2007'); 

$objReader->setReadDataOnly(true); 

$objPHPExcel = $objReader->load("test.xlsx"); 

$objWorksheet = $objPHPExcel->getActiveSheet(); 

echo '<table>' . "\n"; 

foreach ($objWorksheet->getRowIterator() 
as $row) { 

 echo '<tr>' . "\n"; 

$cellIterator = $row->getCellIterator(); 

 $cellIterator->setIterateOnlyExistingCells(false); // This loops all cells, 

 // even if it is not set. 

 // By default, only cells 

 // that are set will be 

 // iterated. 

 foreach ($cellIterator as $cell) { 

 echo '<td>' . $cell->getValue() . '</td>' 
. "\n"; 

 } 

echo '</tr>' . "\n"; 

} 

echo '</table>' . "\n"; 

?>

01.<?php 

02.$objReader = 
PHPExcel_IOFactory::createReader('Excel2007'); 

03.$objReader->setReadDataOnly(true); 

04.$objPHPExcel = $objReader->load("test.xlsx"); 

05.$objWorksheet = $objPHPExcel->getActiveSheet(); 

06.$highestRow = $objWorksheet->getHighestRow(); 
// e.g. 10 

07.$highestColumn = $objWorksheet->getHighestColumn(); 
// e.g 'F' 

08.$highestColumnIndex = 
PHPExcel_Cell::columnIndexFromString($highestColumn); // e.g. 5 

09.echo '<table>' . "\n"; 

10.for 
($row = 
1; $row <= $highestRow; ++$row) { 

11. echo '<tr>' . "\n"; 

12.for 
($col = 
0; $col <= $highestColumnIndex; ++$col) { 

13. echo '<td>' . $objWorksheet->getCellByColumnAndRow($col, $row)->getValue() . '</td>' . "\n"; 

14. } 

15.echo '</tr>' . "\n"; 

16.} 

17.echo '</table>' . "\n"; 

18.?>

設定使用第幾個活頁簿(index從0開始)

1.setActiveSheetIndex(0);

使用流程
1)讀取Excel檔案或創建Excel檔案
2)解析並操控Excel檔案
3)將記憶體中的Excel轉換成其他的型態

PHP日期的加減法

2013-04-29T19:25:00.001-07:00

顯示格式2004-01-08

在2004-01-08再加上15天 = 2004-01-23

$years = date("Y"); //用date()函式取得目前年份格式0000
$months = date("m"); //用date()函式取得目前月份格式00
$days = date("d"); //用date()函式取得目前日期格式00
$day = date("Y-m-d",mktime(0,0,0,$months,$days+15,$years));
echo $day;

在2004-01-08再加上6個月 = 2004-07-08

$years = date("Y"); //用date()函式取得目前年份格式0000
$months = date("m"); //用date()函式取得目前月份格式00
$days = date("d"); //用date()函式取得目前日期格式00
$day = date("Y-m-d",mktime(0,0,0,$months+6,$days,$years));
echo $day;

在2004-01-08再加上2年 = 2006-01-08

$years = date("Y"); //用date()函式取得目前年份格式0000
$months = date("m"); //用date()函式取得目前月份格式00
$days = date("d"); //用date()函式取得目前日期格式00
$day = date("Y-m-d",mktime(0,0,0,$months,$days,$years+2));
echo $day;

在2004-01-08再減15天 = 2003-12-24

$years = date("Y"); //用date()函式取得目前年份格式0000
$months = date("m"); //用date()函式取得目前月份格式00
$days = date("d"); //用date()函式取得目前日期格式00
$day = date("Y-m-d",mktime(0,0,0,$months,$days-15,$years));
echo $day;

在2004-01-08再減6個月 = 2003-07-08

$years = date("Y"); //用date()函式取得目前年份格式0000
$months = date("m"); //用date()函式取得目前月份格式00
$days = date("d"); //用date()函式取得目前日期格式00
$day = date("Y-m-d",mktime(0,0,0,$months-6,$days,$years));
echo $day;

在2004-01-08再減2年 = 2002-01-08

$years = date("Y"); //用date()函式取得目前年份格式0000
$months = date("m"); //用date()函式取得目前月份格式00
$days = date("d"); //用date()函式取得目前日期格式00
$day = date("Y-m-d",mktime(0,0,0,$months,$days,$years-2));
echo $day;

[PHP] 分割與合併字串的相關函式

2013-04-29T18:41:00.001-07:00

PHP中提供許多分割與合併字串的函式，以下就來瀏覽一下吧！
1.explode()：此函式可以將字串分割為陣列儲存，類似切token的方式，若以下列程式碼為例：

$student="kevin susan james";
$stuednt_array=explode(" ",$student);
foreach($stuednt_array as $index => $value)
echo "student $index is: $value\n";

則結果為：
student 0 is: kevin
student 1 is: susan
student 2 is: james

<?php

// Example 1
$pizza = "piece1 piece2 piece3 piece4 piece5 piece6";

$pieces = explode(" ", $pizza);
echo $pieces[0]; // piece1

echo $pieces[1]; // piece2

// Example 2

$data = "foo:*:1023:1000::/home/foo:/bin/sh";
list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data);
echo $user; // foo

echo $pass; // *

?>

2.implode()：此函式可以將陣列合併為字串儲存，若以下列程式碼為例：

$stuednt_array = array(kevin, susan, james);
$student = implode(",", $stuednt_array);
echo $student

則結果為：
kevin,susan,james

3.join()：此函式和implode()用法相同，不再舉例。

4.split()：這個函式和implode()很相像，不同的是他可以用regular expression，先看他的官方文件：

array split ( string $pattern , string $string [, int $limit ] )

而官方的舉例如下：

$date = "04/30/1973";
list($month, $day, $year) = split('[/.-]', $date);
echo "Month: $month; Day: $day; Year: $year\n";

依此例子，則會印出以下結果：
Month: 04; Day: 30; Year: 1973
5.str_split()：此函式會將字串以字母切割，並儲存成陣列，先看他的官方文件。

array str_split ( string $string [, int $split_length ] )

舉例而言：

$str = "Hello";
$arr1 = str_split($str);
print_r($arr1);

印出結果會如下：
Array
(
[0] => H
[1] => e
[2] => l
[3] => l
[4] => o
)
以上為比較常用的，如果日後有用到或看到新的，再來新增好了。

[分享]快用苹果助手免越狱安装的原理

2013-04-25T01:55:00.002-07:00

这个软件其实是这个软件开发者的APPLE ID购买了很多很多的软件游戏，然后通过这个软件授权KEY利用ITUNES的同步允许给你设备安装软件。安装的时候，其实是在用快用苹果助手官方的账号给你安装游戏软件的。说简单点就是这个软件帮你跳过了一步一步授权KEY的麻烦。直接同步安装。

从使用体验来分析，“快用”大致的原理是，先按苹果的流程购买获得各APP的安装文件，然后放在自己的服务器上供用户通过“快用”下载。在下载到PC本地后，通过数据线连接IOS设备，并模拟iTunes的通信规范往设备里装应用。这使得所有通过“快用”安装的应用所对应的苹果ID是“快用”的一个ID，而非用户在自己设备上的常用ID。

这会导致两个显而易见的结果：

1、不能升级。所有使用“快用”安装的APP都不能通过app store升级，除非获得“快用”方面官方ID的密码。原理上，如果“快用”的服务器上更新了应用版本，可以卸载应用后重新通过“快用”安装来升级——显然，这有些麻烦。而且到目前为止，由于“快用”刚刚上线不久，还处于积累更多APP的阶段，对于已有APP的版本管理和升级，还抽不出精力来照顾。

2、安装的应用可能被iTunes同步抹去。这一现象并没有绝对的必然性，在使用中确实出现过。但此问题与“快用”无关，只能说PC版的iTunes用户体验实在糟糕。还有一种情况是IOS设备执行iTunes同步后会有部分通过“快用”安装的APP无法使用，出现闪退。虽然“快用”上已经有闪退修复的功能，但似乎并不总是好使
但实际上，这两个问题都不算是大问题。毕竟与为了获得更多应用使用权限而越狱相比，可能遇到的技术问题更多。

据“快用”的研发经理欧阳磊介绍，该产品思路来自于网络上有规模不小的IOS用户群体互相之间共享苹果ID来下载付费应用。这使得一个群体内的单个人付出更少的费用获得更多的应用。而“快用”则把这种模式从小群体拓展到了大众，“快用”官方付费并把应用分享给所有用户。

对于“快用”来说，“共享ID”的技术模式并不存在太大的风险，苹果不太可能限制用户之间的ID共享，否则会得罪拥有多个苹果ID和多个ISO设备的用户（这样的用户正越来越多）。
下载地址：http://www.kuaiyong.com/

C# MessageBox.Show 用法 .

2013-03-18T22:19:00.002-07:00

简介摘要：MessageBox.Show (String) 显示具有指定文本的消息框。由 .NET Compact Framework 支持。 MessageBox.Show (IWin32Window, String) 在指定对象的前面显示具有指定文本的消息框。

MessageBox.Show (String) 显示具有指定文本的消息框。

由 .NET Compact Framework 支持。

MessageBox.Show (IWin32Window, String) 在指定对象的前面显示具有指定文本的消息框。

MessageBox.Show (String, String) 显示具有指定文本和标题的消息框。

由 .NET Compact Framework 支持。

MessageBox.Show (IWin32Window, String, String) 在指定对象的前面显示具有指定文本和标题的消息框。

MessageBox.Show (String, String, MessageBoxButtons) 显示具有指定文本、标题和按钮的消息框。

MessageBox.Show (IWin32Window, String, String, MessageBoxButtons) 在指定对象的前面显示具有指定文本、标题和按钮的消息框。

MessageBox.Show (String, String, MessageBoxButtons, MessageBoxIcon) 显示具有指定文本、标题、按钮和图标的消息框。

MessageBox.Show (IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon) 在指定对象的前面显示具有指定文本、标题、按钮和图标的消息框。

MessageBox.Show (String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton) 显示具有指定文本、标题、按钮、图标和默认按钮的消息框。

由 .NET Compact Framework 支持。

MessageBox.Show (IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton) 在指定对象的前面显示具有指定文本、标题、按钮、图标和默认按钮的消息框。

MessageBox.Show (String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions) 显示具有指定文本、标题、按钮、图标、默认按钮和选项的消息框。

MessageBox.Show (IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions) 在指定对象的前面显示具有指定文本、标题、按钮、图标、默认按钮和选项的消息框。

MessageBox.Show (String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean) 显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和"帮助"按钮的消息框。

MessageBox.Show (String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String) 使用指定的帮助文件显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和"帮助"按钮的消息框。

MessageBox.Show (IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String) 使用指定的帮助文件显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和"帮助"按钮的消息框。

MessageBox.Show (String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator) 使用指定的帮助文件和 HelpNavigator 显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和"帮助"按钮的消息框。

MessageBox.Show (String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String) 使用指定的帮助文件和帮助关键字[guan jian zi]显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和"帮助"按钮的消息框。

MessageBox.Show (IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator) 使用指定的帮助文件和 HelpNavigator 显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和"帮助"按钮的消息框。

MessageBox.Show (IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String) 使用指定的帮助文件和帮助关键字[guan jian zi]显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和"帮助"按钮的消息框。

MessageBox.Show (String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object) 使用指定的帮助文件、HelpNavigator 和帮助主题显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和"帮助"按钮的消息框。

MessageBox.Show (IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object) 使用指定的帮助文件、HelpNavigator 和帮助主题显示一个具有指定文本、标题、按钮、图标、默认按钮、选项和"帮助"按钮的消息框。

用法如：

DialogResult ret =MessageBox.Show( "确定要删除[shan chu]记录么？" , "删除[shan chu]", MessageBoxButtons.OKCancel, MessageBoxIcon.Question);

MessageBox.Show( "提示[ti shi]信息", " 信息标题", MessageBoxButtons.OK);

MessageBox.Show( "提示[ti shi]信息", " 信息标题", MessageBoxButtons.OK, MessageBoxIcon.Error);

我们在程序中经常会用到MessageBox。

MessageBox.Show()共有21中重载[zhong zai]方法。现将其常见用法总结如下：

1. MessageBox .Show( "Hello~~~~" );

最简单的，只显示提示[ti shi]信息。

2. MessageBox .Show( "There are something wrong!" , "ERROR" );

可以给消息框加上标[shang biao]题。

3. if ( MessageBox .Show( "Delete this user?" , "Confirm Message" , MessageBoxButtons .OKCancel) == DialogResult .OK)

{

//delete

}

询问是否删除[shan chu]时会用到这个。

4. if ( MessageBox .Show( "Delete this user?" , "Confirm Message" , MessageBoxButtons .OKCancel, MessageBoxIcon .Question) == DialogResult .OK)

{

//delete

}

可以给MessageBox加上一个Icon，.net提供常见的Icon共选择[xuan ze]。

5. if ( MessageBox .Show( "Delete this user?" , "Confirm Message" , MessageBoxButtons .OKCancel, MessageBoxIcon .Question, MessageBoxDefaultButton .Button2) == DialogResult .OK)

{

//delete

}

可以改变MessageBox的默认焦点，如下：

6. if ( MessageBox .Show( "Delete this user?" , "Confirm Message" , MessageBoxButtons .OKCancel, MessageBoxIcon .Question, MessageBoxDefaultButton .Button2, MessageBoxOptions .RtlReading) == DialogResult .OK)

{

//delete

}

反向显示：

7. if ( MessageBox .Show( "Delete this user?" , "Confirm Message" , MessageBoxButtons .OKCancel, MessageBoxIcon .Question, MessageBoxDefaultButton .Button2, MessageBoxOptions .RightAlign, true ) == DialogResult .OK)

{

//delete

}

添加Help按钮：

8. if ( MessageBox .Show( "Delete this user?" , "Confirm Message" , MessageBoxButtons .OKCancel, MessageBoxIcon .Question, MessageBoxDefaultButton .Button1, MessageBoxOptions .RtlReading, @"/folder/file.htm" ) == DialogResult .OK)

{

//delete

}

指定帮助文件的路径[lu jing]，点击即可打开该路径[lu jing]下的帮助文件。

9. //HelpNavigator 指定常数来指示[zhi shi]要显示的帮助文件元素。 Find 帮助文件将打开到搜索[sou suo]页。

if ( MessageBox .Show( "Delete this user?" , "Confirm Message" , MessageBoxButtons .OKCancel, MessageBoxIcon .Question, MessageBoxDefaultButton .Button1, MessageBoxOptions .RtlReading, @"/folder/file.htm" , HelpNavigator .Find) == DialogResult .OK)

{

//delete

}

还有一些用法，不是太实用这里就不一一介绍了，有兴趣的朋友可以参考[can kao]下这里： MSDN 的MessageBox类。

http://blog.csdn.net/fan158/article/details/5891780

MessageBox.Show 方法的使用

2013-03-18T22:18:00.001-07:00

MessageBox 類別 Show 方法的語法為：

數值變數名稱 = MessageBox.Show(提示訊息 [,標題] [,按鈕] [,圖示] [,預設按鈕] [,選項])

按鈕的列舉常數名稱及其意義為：

列舉常數名稱	顯示按鈕
MessageBoxButtons.OK	「確定」按鈕
MessageBoxButtons.OKCancel	「確定」、「取消」按鈕
MessageBoxButtons.AbortRetryIgnore	「中止」、「重試」、「略過」按鈕
MessageBoxButtons.YesNoCancel	「是」、「否」、「取消」按鈕
MessageBoxButtons.YesNo	「是」、「否」按鈕
MessageBoxButtons.RetryCancel	「重試」、「取消」按鈕

圖示的列舉常數名稱及其意義為：

列舉常數名稱	顯示按鈕
MessageBoxIcon.Asterisk	「i」圖示
MessageBoxIcon.Error	「X」圖示
MessageBoxIcon.Exclamation	「！」圖示
MessageBoxIcon.Hand	「X」圖示
MessageBoxIcon.Information	「i」圖示
MessageBoxIcon.None	無圖示
MessageBoxIcon.Question	「？」圖示
MessageBoxIcon.Stop	「X」圖示
MessageBoxIcon.Warning	「！」圖示

預設按鈕的列舉常數名稱及其意義為：

列舉常數名稱	顯示按鈕
MessageBoxDefaultButton.Button1	以第一個按鈕為預設按鈕
MessageBoxDefaultButton.Button2	以第二個按鈕為預設按鈕
MessageBoxDefaultButton.Button3	以第三個按鈕為預設按鈕

選項的列舉常數名稱及其意義為：

列舉常數名稱	顯示按鈕
MessageBoxOptions.DefaultDeskTopOnly	訊息方塊僅顯示於預設旳桌面。
MessageBoxOptions.RightAlign	標題文字靠右對齊。
MessageBoxOptions.RtlReading	訊息由右向左顯示。
MessageBoxOptions.ServiceNotification	訊息方塊僅顯示於作用旳桌面。

傳回值的列舉常數名稱及其意義為：

列舉常數名稱	顯示按鈕
DialogResult.OK	按「確定」鈕
DialogResult.Cancel	按「取消」鈕
DialogResult.Abort	按「中止」鈕
DialogResult.Retry	按「重試」鈕
DialogResult.Ignore	按「略過」鈕
DialogResult.Yes	按「是」鈕
DialogResult.No	按「否」鈕

Internet Country Codes (網際網路國家代碼)

2013-03-14T19:38:00.003-07:00

IP Country codes are short alphabetic (字母的) or numeric (數字) geographic (地理的) codes (geocodes, 位址代碼) developed to represent (代表) countries and dependent (獨立的) areas, for use in data processing and communications (通訊). The following is a list of countries alphabetized by country codes.

IP Country code	Country Name or Area	Chinese
AC	Ascension Island	亞森欣島
AD	Andorra	安道爾共和國
AE	United Arab Emirates	阿拉伯聯合大公國
AF	Afghanistan	阿富汗
AG	Antigua and Barbuda	安地卡及巴布達
AI	Angola	安圭拉
AL	Albania	阿爾巴尼亞
AM	Armenia	亞美尼亞
AN	Netherlands Antilles	荷屬安的列斯群島
AO	Angola	安哥拉
AQ	Antarctica	南極洲
AR	Argentina	阿根廷
AS	American Samoa	薩摩亞
AT	Austria	奧地利
AU	Australia	澳大利亞
AW	Aruba	阿魯巴
AZ	Azerbaijan	亞塞拜然
BA	Bosnia-Herzegovina	波士尼亞
BB	Barbados	巴貝多
BD	Bangladesh	孟加拉
BE	Belgium	比利時
BF	Burkina Faso	布吉納法索
BG	Bulgaria	保加利亞
BH	Bahrain	巴林
BI	Burundi	蒲隆地
BJ	Benin	貝南
BM	Bermuda	百慕達
BN	Brunei Darussalam	汶萊
BO	Bolivia	玻利維亞
BR	Brazil	巴西
BS	Bahamas	巴哈馬
BT	Bhutan	不丹
BV	Bouvet Island	波維特島
BW	Botswana	波札那
BY	Byelorussian SSR	白俄羅斯
BZ	Belize	貝里斯
CA	Canada	加拿大
CC	Cocos Islands	可可斯群島(椰子島)
CF	The Central African Republic	中非共和國
CG	Congo	剛果
CH	Switzerland	瑞士
CI	Ivory Coast	象牙海岸
CK	Cook Island	科克群島
CL	Chile	智利
CM	Cameroon	喀麥隆
CN	China	中國大陸
CO	Colombia	哥倫比亞
CR	Costa Rica	哥斯大黎加
CS	Czechoslovakia (former)	捷克斯拉夫 (前)
CU	Cuba	古巴
CV	Cape Verde, Republic of	維德角
CX	Christmas Island	耶路撒冷
CY	Cyprus	賽普勒斯
CZ	Czech Republic	捷克共和國
DE	Germany	德國
DJ	Djibouti	吉布地
DK	Denmark	丹麥
DM	Dominica	多明哥
DO	Dominica	多米尼加
DZ	Algeria	阿爾及利亞
EC	Ecuador	厄瓜多
EE	Estonia	愛沙尼亞
EG	Egypt	埃及
EH	West Sahara	西撒哈拉
ER	Eritrea	厄立特里亞 (非洲國家)
ES	Spain	西班牙
ET	Ethiopia	衣索比亞
FI	Finland	芬蘭
FJ	Fiji	斐濟
FK	Falkland Islands	福克蘭群島
FM	Micronesia	密克羅尼西亞
FO	Faroe Islands	法羅群島
FR	France	法國
FX	France, Metropolitan	法國，大都會
GA	Gabon	加彭
GB	United Kingdom	英國
GD	Grenada	格瑞納達
GE	Georgia	喬治亞
GF	French Guiana	法屬圭亞那
GH	Ghana	迦納
GI	Gibraltar	直布羅陀
GL	Greenland	格陵蘭
GM	Gambia	甘比亞
GN	Guinea	幾內亞
GP	Guadeloupe	瓜德魯普島
GQ	Equatorial Guinea	赤道幾內亞
GR	Greece	希臘
GS	South Georgia and the South Sandwich Islands	南喬治亞和南桑德韋奇群島
GT	Guatemala	瓜地馬拉
GU	Guam	關島
GW	Guinea-Bissau	幾內亞比索
GY	Guyana	圭亞那
HK	Hong Kong	香港
HM	Heard and McDonald Islands	赫德及麥當勞群島
HN	Honduras	宏都拉斯
HR	Croatia	克羅埃西亞
HT	Haiti	海地
HU	Hungary	匈牙利
ID	Indonesia	印度尼西亞
IE	Ireland	愛爾蘭
IL	Israel	以色列
IN	India	印度
IO	British Indian Ocean Territory	英聯邦的印度洋領域
IQ	Iraq	伊拉克
IR	Iran	伊朗
IS	Iceland	冰島
IT	Italy	意大利
JM	Jamaica	牙買加
JO	Jordan	約旦
JP	Japan	日本
KE	Kenya	肯亞
KG	Kyrgyzstan	吉爾吉斯
KH	Cambodia	高棉 (柬埔寨)
KI	Kiribati	吉里巴斯
KM	Comoros	科摩羅
KN	St. Kitts and Nevis	聖克里斯多福及尼維斯
KP	Korea, Democratic People's Rep. of	北韓
KR	Korea, Republic of	南韓
KW	Kuwait	科威特
KY	Cayman Islands	開曼群島
KZ	Kazakstan	哈薩克
LA	Laos	寮國
LB	Lebanon	黎巴嫩
LC	St. Lucia	聖露西亞
LI	Liechtenstein	列支敦斯登
LK	Sri Lanka	斯里蘭卡
LR	Liberia	賴比瑞亞
LS	Lesotho	賴索托
LT	Lithuania	立陶宛
LU	Luxembourg	盧森堡
LV	Latvia	拉脫維亞
LY	Libya	利比亞
MA	Morocco	摩洛哥
MC	Monaco	摩納哥
MD	Moldova, Republic of	摩爾多瓦
MG	Malagasy	馬達加斯加
MH	Marshall Islands	馬紹爾群島
MK	Macedonia	馬其頓
ML	Mali	馬利
MM	Burma	緬甸
MN	Mongolia	蒙古
MO	Macao	澳門
MP	Northern Mariana Islands	北聖
MQ	Martinique	聖馬丁
MR	Mauritania	茅利塔尼亞
MS	Montserrat	蒙瑟拉特島
MT	Malta	馬爾他
MU	Mauritius	模里西斯
MV	Maldives	馬爾地夫
MW	Malawi	馬拉威
MX	Mexico	墨西哥
MY	Malaysia	馬來西亞
MZ	Mozambique	莫三比克
NA	Namibia	納米比亞
NC	New Caledonia	新加勒多尼亞
NE	Niger	尼日
NF	Norfolk Island	諾福克群島
NG	Nigeria	奈及利亞
NI	Nicaragua	尼加拉瓜
NL	Netherlands	荷蘭
NO	Norway	挪威
NP	Nepal	尼泊爾
NR	Nauru	諾魯
NT	Neutral Zone	中立區
NU	Niue	紐威島
NZ	New Zealand	紐西蘭
OM	Oman	阿曼
PA	Panama	巴拿馬
PE	Peru	秘魯
PF	French Polynesia	法屬玻里尼西亞
PG	Papua, Territory of	巴布亞新幾內亞
PH	Philippines	菲律賓
PK	Pakistan	巴基斯坦
PL	Poland	波蘭
PM	St. Pierre and Miquelon	聖皮耳
PN	Pitcairn Islands	聖皮特開恩群島
PR	Puerto Rico	波多黎各
PT	Portugal	葡萄牙
PW	Palau	帛琉
PY	Paraguay	巴拉圭
QA	Qatar	卡達
RE	Reunion Island	留尼旺島
RO	Romania	羅馬尼亞
RU	Russia	俄羅斯聯邦
RW	Rwanda	盧安達
SA	Saudi Arabia	沙烏地阿拉伯
SB	Solomon Islands	所羅門群島
SC	Seychelles	塞席爾
SD	Sudan	蘇丹
SE	Sweden	瑞典
SG	Singapore	新加坡
SH	St. Helena	聖赫勒拿島
SI	Slovene	斯洛法尼亞
SJ	Svalbard and Jan Mayen Islands	冷岸和央麥恩島
SK	Slovakia	斯洛伐克
SL	Sierra Leone	獅子山
SM	San Marino	聖馬利諾
SN	Senegal	塞內加爾
SO	Somali	索馬利亞
SR	Surinam	蘇利南
ST	Sao Tome and Principe	聖多美及普林西比
SU	USSR (Formerly)	蘇聯 (前)
SV	El Salvador	薩爾瓦多
SY	Syria	敘利亞
SZ	Swaziland	史瓦濟蘭
TC	Turks and Caicos Islands	土克斯及開科斯群島
TD	Chad	查德
TF	French Southern Territories	法屬南部屬地
TG	Togo	多哥
TH	Thailand	泰國
TJ	Tajikistani	塔吉克
TK	Tokelau	托克勞群島
TM	Turkmenistan	土庫曼
TN	Tunisia	突尼西亞
TO	Tonga	東加
TP	East Timor	帝汶
TR	Turkey	土耳其
TT	Trinidad and Tobago	千里達及托貝哥
TV	Tuvalu	吐瓦魯
TW	Taiwan	台灣
TZ	Tanzania	坦尚尼亞
UA	Ukraine	烏克蘭
UG	Uganda	烏干達
UK	England	英國（正式代碼為GB）
UM	United States Minor Outlying Islands	美屬邊疆群島
US	America	美國
UY	Uruguay	烏拉圭
UZ	Uzbekistan	烏茲別克
VA	Vatican	梵蒂岡 (羅馬教庭)
VC	St. Vincent and the Grenadines	聖文森及格
VE	Venezuela	委內瑞拉
VG	Virgin Islands (British)	英屬維爾京群島 (英)
VI	Virgin Islands (U.S.)	英屬維爾京群島 (美)
VN	Vietnam	越南
VU	Vanuatu	萬那杜(共和國) (位於大洋洲)
WF	Wallis and Futuna Islands	沃利斯和富圖納群島
WS	Western Samoa	西薩摩亞
YE	Yemen	葉門
YT	Mayotte (Island)	馬約特(島)
YU	Yugoslavia	南斯拉夫
ZA	South Africa	南非
ZM	Zambia	尚比亞
ZR	Zaire	扎伊爾
ZW	Zimbabwe	辛巴威
ZZ	Other	其他

MessageBox and DialogResult

2013-03-14T03:22:00.002-07:00

MessageBox and DialogResult

//第1個參數為顯示訊息, 2 = 視窗TITLE, 3 = 按鈕選項

DialogResult result = MessageBox.Show("r u sure?", "delete", MessageBoxButtons.OKCancel);

if (result == DialogResult.OK)

{

…

}

取得error or exception的位置(行數)

2013-03-14T03:20:00.001-07:00

取得error or exception的位置(行數)

try { }

catch(Exception ex)

{

int errorLine = new System.Diagnostics.StackTrace(ex, true).GetFrame(0).GetFileLineNumber();

}

Android通讯录查询篇--ContactsContract.Data

2013-03-13T20:27:00.002-07:00

官方的文档中描述了一大段的话。里面比较重要的几点是：
   1、在Data中有一大段的公共数据段，DATA1~DATA15。这名子咋一看，真搞笑，哪有这样为数据命名的，神也记不住是干什么的的啊！
   2、上面说的那些公共数据段所存的数据类型是由这个MIMETYPE决定的。

   虽说这两个重要，不过刚看到这里，我还是懵了，这到底是个什么玩意嘛。（当然这很有可能是因为英文水平差，没看完全懂的原因。）
再看看官方文档，上面有个例子说，如果MIMETYPE的值是Phone.CONTENT_ITEM_TYPE，则DATA1就是电话号码，如果MIMETYPE的值是Email.CONTENT_ITEM_TYPE则DATA1的值就是E-mail地址。这样一说，又似乎明白了点。（还是举实例子来的实在！）
　　在上次说的那个官方代码里面不就有将MIMETYPE赋值为Phone.CONTENT_ITEM_TYPE的么。所以那个查询就用来查电话了。
　　在MIMETYPE的描述里面说，它可以被赋许多值：
　　StructuredName.CONTENT_ITEM_TYPE
　　Phone.CONTENT_ITEM_TYPE
　　Email.CONTENT_ITEM_TYPE
　　Photo.CONTENT_ITEM_TYPE
　　Organization.CONTENT_ITEM_TYPE
　　Im.CONTENT_ITEM_TYPE
　　Nickname.CONTENT_ITEM_TYPE
　　Note.CONTENT_ITEM_TYPE
　　StructuredPostal.CONTENT_ITEM_TYPE
　　GroupMembership.CONTENT_ITEM_TYPE
　　Website.CONTENT_ITEM_TYPE
　　Event.CONTENT_ITEM_TYPE
　　Relation.CONTENT_ITEM_TYPE

　　现在我们知道的有用Phone那个可以查电话，那用哪个查姓名呢？
　　再之后看文档时候可以明白把StructuredName.CONTENT_ITEM_TYPE给MINETYPE就行了。(但刚开始的时候可能是因为看英文，怎么都没把它们好的联系起来。)
　　所将官方的代码改成这样的话就可以查询姓名了。

Cursor c = getContentResolver().query(Data.CONTENT_URI, 

        new String[]{Data._ID,StructuredName.DISPLAY_NAME, }, 

        Data.MIMETYPE + "='" + StructuredName.CONTENT_ITEM_TYPE + "'", 

          null, null);

　　其中游标C的结果的第二个字段（StructuredName.DISPLAY_NAME）就是姓名，准确的说应该是“显示姓名”（因为姓名也以再细分为姓和名）。

工作需要，研究一下VCard格式

2013-03-13T00:16:00.003-07:00

工作需要，研究一下VCard格式

from : http://zhoup.cnblogs.com/archive/2006/02/21/334798.aspx

vCard MIME Directory Profile（rfc－2426）

VCard 数据格式的标识符是VCARD

l         预定义的值类型：uri, date, date-time, float
l         新增加的值类型：binary, phone-number, utc-offset and vcard value
l         预定义的类型：SOURCE, NAME, PROFILE, BEGIN, END.
l         新增加的类型：FN, N, NICKNAME, PHOTO, BDAY, ADR, LABEL, TEL, EMAIL,
MAILER, TZ, GEO, TITLE, ROLE, LOGO, AGENT, ORG, CATEGORIES, NOTE,
PRODID, REV, SORT-STRING, SOUND, URL, UID, VERSION, CLASS, KEY
l         预定义的参数：ENCODING, VALUE, CHARSET, LANGUAGE, CONTEXT.
l         新增加的参数：TYPE

vCard数据格式行是: 类型 [;参数]:值

    ADR;HOME;POSTAL;PARCEL:;;街道地址;深圳;广东;433330;中国
ADR：是一个类型，表示是一条地址信息
      “;”号是分隔符合
      HOME;POSTAL;PARCEL表示参数，表示ADR的用途或者是类别
      :;;街道地址;深圳;广东;433330;中国表示是一个ADR值，地址值

预定义类型的用法

BEGIN 和 END 类型

Vcard内容必须以BEGIN:VCARD开头，以END:VCARD结尾
参考一个vcard的例子1：

BEGIN:VCARD

VERSION:2.1
N:周;鹏
FN:周鹏
NICKNAME:nickName
ORG:深圳敖天;部门
TITLE:职位
NOTE;ENCODING=QUOTED-PRINTABLE:=C6=E4=CB=FB
TEL;WORK;VOICE:电话1
TEL;WORK;VOICE:电话2
TEL;HOME;VOICE:电话1
TEL;HOME;VOICE:电话2
TEL;CELL;VOICE:13590342862
TEL;PAGER;VOICE:0755
TEL;WORK;FAX:传真
TEL;HOME;FAX:传真
ADR;WORK:;;单位地址;深圳;广东;433000;国家
LABEL;WORK;ENCODING=QUOTED-PRINTABLE:=B5=A5=CE=BB=B5=D8=D6=B7
=C9=EE=DB=DA
=B9=E3=B6=AB
433000
=B9=FA=BC=D2
ADR;HOME;POSTAL;PARCEL:;;街道地址;深圳;广东;433330;中国
LABEL;HOME;ENCODING=QUOTED-PRINTABLE:=BD=D6=B5=C0=B5=D8=D6=B7
=C9=EE=DB=DA
=B9=E3=B6=AB
433330
=D6=D0=B9=FA
URL:http://
URL:单位主页
EMAIL;PREF;INTERNET:guodc@139.com
X-QQ:38394246
X-ICQ:icq
X-WAB-GENDER:2
REV:20060220T180305Z

END:VCARD

NAME 类型

如果在内容中出现NAME类型，那么它的值是一个可以显示的，描述vCard源的文本

PROFILE类型

   如果出现PROFILE类型，那么它的值必须是“VCARD”

SOURCE 类型

  如果包含SOURCE类型，它的值提供一些怎样找到vCard源的信息

预定参数的用法

LANGUAGE

 参考[MIME-DIR]文档

ENCODING

参考[MIME-DIR]文档

VALUE

参考[MIME-DIR]文档

预定义值类型的用法

在[MIME-DIR]中预定类型的值一定不能包含用逗号分开的列表，除N，NICKNAME, ADR和 CATEGORIES值类型外。

预定义值类型的扩展

BINARY

表明类型的值是二进制的，主要应用在类型PHOTO, LOGO, SOUND, and KEY中.
ENCODING参数的值必须指定为“B”

        二进制的内容的编码参考[RFC 2047]

VCARD

表示一个类型的值是一个vCard对象

PHONE-NUMBER

表示类型的值是一个电话号码

UTC-OFFSET

表示时间

结构类型的值

复合类型值是用分号分开的字段的集合，复合类型值中避免使用分号，如何需要使用分号，需要用“\分号“替代

行的限定和分行

参考[MIME DIR]，如果行的长度超过了75个字符，那么必须分行。

VCard 特征

标识类型

FN 类型定义

目的：vcard对象的名称，一个vcard对象必须包含FN类型。
例子：FN:Mr. John Q. Public\, Esq.

N类型定义

目的：FN表示一个vcard对象的名称，N表示这个对象名称的组成部分

  例子：N:Public;John;Quinlan;Mr.;Esq.

        N:Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P.

  各个组成部分可以用分号分号，每个组成部分可以用逗号。

NICKNAME类型定义

目的：表示别名

例子：NICKNAME:Robbie

        NICKNAME:Jim,Jimmie

PHOTO类型定义

目的：vcard对象的图像信息

例子：PHOTO;VALUE=uri:http://www.abc.com/pub/photos/jqpublic.gif

      PHOTO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN

         AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm

         ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0

         <...remainder of "B" encoded binary data...>

   如果使用内联的二进制数据表示图片信息，那么;ENCODING=b

BDAY类型定义

目的：表示出生日期

例子：BDAY:1996-04-15

        BDAY:1953-10-15T23:10:00Z

        BDAY:1987-09-27T08:30:00-06:00

地址类型

ADR 类型定义

目的：是一个组合，用来表示一个地址信息，值类型是一个用分号分开的文本值

例子：ADR;TYPE=dom,home,postal,parcel:;;123 Main Street;Any Town;CA;91921-1234;A

ADR;HOME;POSTAL;PARCEL:;;街道地址;深圳;广东;433330;中国

        组合由一下部分顺序的组成：

the post office box;

the extended address;

the street address;

the locality (e.g., city);

the region (e.g., state or  province);

the postal code;

the country name

七个部分组成，如果，其他的一个部分没有，必须用分号分开

 type 参数的说明

"dom"  国内地址

"intl" 国际地址

"parcel"包裹递送地址

"home" 居住地址;

"work"工作地址;

"pref" 有多个地址的时候，优先的地址

缺省的"TYPE=intl,postal,parcel,work"，可以替换

LABEL类型定义

目的：是一格式化的文本值，表示一个地址

例子：LABEL;TYPE=dom,home,postal,parcel:Mr.John Q. Public\, Esq.\n

         Mail Drop: TNE QB\n123 Main Street\nAny Town\, CA  91921-1234

         \nU.S.A.

 type 参数的说明

"dom"  国内地址

"intl" 国际地址

"parcel"包裹递送地址

"home" 居住地址;

"work"工作地址;

"pref" 有多个地址的时候，优先的地址

缺省的"TYPE=intl,postal,parcel,work"，可以替换

和ADR的不同是 ADR的值是用分号分开的数据，LABEL就是一个格式化的文本。

电话通信地址类型

TEL类型定义

目的：指定一个电话号码

例子：TEL;TYPE=work,voice,pref,msg:+1-213-555-1234 begin_of_the_skype_highlighting +1-213-555-1234 免費  end_of_the_skype_highlighting

说明：值是一个规范的全球唯一的电话号码

     TYPE参数的值有：

            "home"表示家庭电话

        "msg" 表示这个号码支持语音

"work" 工作电话

"pref" 表示多个电话中最喜欢使用的电话

"voice" 声音电话号码

               "fax"传真号码

        "cell" 表示手机电话

"video" 视频电话

"pager" 调度电话，估计是总机的电话

        "bbs" 公开的广播系统的电话

        "modem" 调制解调器电话

        "car"汽车电话

        "isdn" ISDN连接电话号码

 "pcs" 个人通信服务电话

缺省是 "voice".

TYPE参数的用法是TYPE=work;TYPE=voice或者"TYPE=work,voice"，缺省值可以被重置

 "TYPE=work,home,voice,fax".

EMAIL类型定义

目的：指定一个电子邮件

例子：EMAIL;TYPE=internet:jqpublic@xyz.dom1.com

    EMAIL;TYPE=internet:jdoe@isp.net

    EMAIL;TYPE=internet,pref:jane_doe@abc.com

TYPE参数的使用

"internet" 表示一个internet 类型地址

    "x400" 表示是一个 X.400 地址

"pref"最喜欢使用的邮件电子

缺省是"internet".

MAILER 类型定义

目的：指定一个电子邮件发送者

例子：MAILER:PigeonMail 2.1

地理类型

TZ类型定义

目的：时区信息

例子：TZ:-05:00

        TZ;VALUE=text:-05:00; EST; Raleigh/North America

        缺省是一个utc-offset值.

GEO类型定义

目的：地理位置信息

例子GEO:37.386013;-122.082932

     CEO 经度；纬度

组织类型

TITLE类型定义

目的：工作位置，工作职能（job title）

例子TITLE:Director\, Research and Development

ROLE 类型定义

目的：公司的职业（occupation）

例子ROLE:Programmer

LOGO类型定义

目的：公司logo，是一个图像信息

例子LOGO;VALUE=uri:http://www.abc.com/pub/logos/abccorp.jpg

LOGO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN         AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm

         ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0

         <...the remainder of "B" encoded binary data...>

说明：TYPE知道图像的格式，ENCODING=b表示是二进制的数据流

      URI表示是一个外部图像对象

AGENT类型定义

目的：指定另外一个人替换他的个人行为

例子：AGENT;VALUE=uri: CID:JQPUBLIC.part3.960129T083020.xyzMail@host3.com

AGENT:BEGIN:VCARD\nFN:Susan Thomas\nTEL:+1-919-555-

         1234\nEMAIL\;INTERNET:sthomas@host.com\nEND:VCARD\n

说明：缺省是一个Vcard对象，当时也可是一个URI指定的外部Vcard对象

ORG类型定义

目的：表示一个组织的名称

例子ORG:ABC\, Inc.;North American Division;Marketing

解释类型

CATEGORIES类型定义

目的：vcard应用的分类信息

例子：CATEGORIES:TRAVEL AGENT

      CATEGORIES:INTERNET,IETF,INDUSTRY,INFORMATION TECHNOLOGY

NOTE 类型定义

目的：对vcard的注释和说明

例子：NOTE:This fax number is operational 0800 to 1715

          EST\, Mon-Fri.

PRODID类型定义

目的：指定创建Vcard对象的产品的ID

例子：PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN

REV类型定义

目的：指定当前Vcard的修改信息

例子：REV:1995-10-31T22:27:10Z

      REV:1997-11-15

SORT-STRING类型定义

目的：指定家庭名称或者其他名称对FN和N类型排序

例子：  FN:Rene van der Harten

        N:van der Harten;Rene;J.;Sir;R.D.O.N.

        SORT-STRING:Harten

        FN:Robert Pau Shou Chang

        N:Pau;Shou Chang;Robert

        SORT-STRING:Pau

        FN:Osamu Koura

        N:Koura;Osamu

        SORT-STRING:Koura

        FN:Oscar del Pozo

        N:del Pozo Triscon;Oscar

        SORT-STRING:Pozo

        FN:Chistine d'Aboville

        N:d'Aboville;Christine

        SORT-STRING:Aboville

SOUND类型定义

目的：指定Vcard的数字声音信息，缺省是指定vcard的name类型的发音信息。

例子：  SOUND;TYPE=BASIC;VALUE=uri:CID:JOHNQPUBLIC.part8.

         19960229T080000.xyzMail@host1.com

        SOUND;TYPE=BASIC;ENCODING=b:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN         AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm         ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0 <...the remainder of "B" encoded binary data...>

可以用URI指定一个外部声音二进制流

    可以是内置的声音二进制流，ENCODING=b

UID类型定义

目的：指定一个全球唯一的个人或资源标识。

例子：UID:19950401-080045-40000F192713-0052

URL类型定义

目的：指定Vcard 参考的路径。

例子：URL:http://www.swbyps.restaurant.french/~chezchic.html

VERSION类型定义

目的：指定Vcard使用的vcard规范的版本。

例子：  VERSION:3.0

Security 类型

CLASS类型定义

目的：指定访问Vcard对象的访问分级。

例子：  CLASS:PUBLIC

        CLASS:PRIVATE

        CLASS:CONFIDENTIAL

说明：安全分级需要参考目录服务的访问分级

KEY 类型定义

目的：指定Vcard的公共钥匙值（加密解密是使用）或者是授权认证。

例子：  KEY;ENCODING=b:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcNAQEEBQA

         wdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENbW11bmljYX

         Rpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0

         ZW1zMRwwGgYDVQQDExNyb290Y2EubmV0c2NhcGUuY29tMB4XDTk3MDYwNj

         E5NDc1OVoXDTk3MTIwMzE5NDc1OVowgYkxCzAJBgNVBAYTAlVTMSYwJAYD

         VQQKEx1OZXRzY2FwZSBDb21tdW5pY2F0aW9ucyBDb3JwLjEYMBYGA1UEAx

         MPVGltb3RoeSBBIEhvd2VzMSEwHwYJKoZIhvcNAQkBFhJob3dlc0BuZXRz

         Y2FwZS5jb20xFTATBgoJkiaJk/IsZAEBEwVob3dlczBcMA0GCSqGSIb3DQ

         EBAQUAA0sAMEgCQQC0JZf6wkg8pLMXHHCUvMfL5H6zjSk4vTTXZpYyrdN2

         dXcoX49LKiOmgeJSzoiFKHtLOIboyludF90CgqcxtwKnAgMBAAGjNjA0MB

         EGCWCGSAGG+EIBAQQEAwIAoDAfBgNVHSMEGDAWgBT84FToB/GV3jr3mcau

         +hUMbsQukjANBgkqhkiG9w0BAQQFAAOBgQBexv7o7mi3PLXadkmNP9LcIP

         mx93HGp0Kgyx1jIVMyNgsemeAwBM+MSlhMfcpbTrONwNjZYW8vJDSoi//y

         rZlVt9bJbs7MNYZVsyF1unsqaln4/vy6Uawfg8VUMk1U7jt8LYpo4YULU7

         UZHPYVUaSgVttImOHZIKi4hlPXBOhcUQ==

扩展类型

可以定义自己的类型，自己定义的类型需要以“x-”开头
比喻例子中的信息：
X-QQ:38394246
X-ICQ:icq
X-WAB-GENDER:2

工作需要，研究一下VCard格式

2013-03-13T00:16:00.001-07:00

工作需要，研究一下VCard格式

from : http://zhoup.cnblogs.com/archive/2006/02/21/334798.aspx

vCard MIME Directory Profile（rfc－2426）

VCard 数据格式的标识符是VCARD

vCard数据格式行是: 类型 [;参数]:值

预定义类型的用法

BEGIN 和 END 类型

Vcard内容必须以BEGIN:VCARD开头，以END:VCARD结尾
参考一个vcard的例子1：

BEGIN:VCARD

END:VCARD

NAME 类型

如果在内容中出现NAME类型，那么它的值是一个可以显示的，描述vCard源的文本

PROFILE类型

   如果出现PROFILE类型，那么它的值必须是“VCARD”

SOURCE 类型

  如果包含SOURCE类型，它的值提供一些怎样找到vCard源的信息

预定参数的用法

LANGUAGE

 参考[MIME-DIR]文档

ENCODING

参考[MIME-DIR]文档

VALUE

参考[MIME-DIR]文档

预定义值类型的用法

在[MIME-DIR]中预定类型的值一定不能包含用逗号分开的列表，除N，NICKNAME, ADR和 CATEGORIES值类型外。

预定义值类型的扩展

BINARY

表明类型的值是二进制的，主要应用在类型PHOTO, LOGO, SOUND, and KEY中.
ENCODING参数的值必须指定为“B”

        二进制的内容的编码参考[RFC 2047]

VCARD

表示一个类型的值是一个vCard对象

PHONE-NUMBER

表示类型的值是一个电话号码

UTC-OFFSET

表示时间

结构类型的值

复合类型值是用分号分开的字段的集合，复合类型值中避免使用分号，如何需要使用分号，需要用“\分号“替代

行的限定和分行

参考[MIME DIR]，如果行的长度超过了75个字符，那么必须分行。

VCard 特征

标识类型

FN 类型定义

目的：vcard对象的名称，一个vcard对象必须包含FN类型。
例子：FN:Mr. John Q. Public\, Esq.

N类型定义

目的：FN表示一个vcard对象的名称，N表示这个对象名称的组成部分

  例子：N:Public;John;Quinlan;Mr.;Esq.

        N:Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P.

  各个组成部分可以用分号分号，每个组成部分可以用逗号。

NICKNAME类型定义

目的：表示别名

例子：NICKNAME:Robbie

        NICKNAME:Jim,Jimmie

PHOTO类型定义

目的：vcard对象的图像信息

例子：PHOTO;VALUE=uri:http://www.abc.com/pub/photos/jqpublic.gif

      PHOTO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN

         AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm

         ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0

         <...remainder of "B" encoded binary data...>

   如果使用内联的二进制数据表示图片信息，那么;ENCODING=b

BDAY类型定义

目的：表示出生日期

例子：BDAY:1996-04-15

        BDAY:1953-10-15T23:10:00Z

        BDAY:1987-09-27T08:30:00-06:00

地址类型

ADR 类型定义

目的：是一个组合，用来表示一个地址信息，值类型是一个用分号分开的文本值

例子：ADR;TYPE=dom,home,postal,parcel:;;123 Main Street;Any Town;CA;91921-1234;A

ADR;HOME;POSTAL;PARCEL:;;街道地址;深圳;广东;433330;中国

        组合由一下部分顺序的组成：

the post office box;

the extended address;

the street address;

the locality (e.g., city);

the region (e.g., state or  province);

the postal code;

the country name

七个部分组成，如果，其他的一个部分没有，必须用分号分开

 type 参数的说明

"dom"  国内地址

"intl" 国际地址

"parcel"包裹递送地址

"home" 居住地址;

"work"工作地址;

"pref" 有多个地址的时候，优先的地址

缺省的"TYPE=intl,postal,parcel,work"，可以替换

LABEL类型定义

目的：是一格式化的文本值，表示一个地址

例子：LABEL;TYPE=dom,home,postal,parcel:Mr.John Q. Public\, Esq.\n

         Mail Drop: TNE QB\n123 Main Street\nAny Town\, CA  91921-1234

         \nU.S.A.

 type 参数的说明

"dom"  国内地址

"intl" 国际地址

"parcel"包裹递送地址

"home" 居住地址;

"work"工作地址;

"pref" 有多个地址的时候，优先的地址

缺省的"TYPE=intl,postal,parcel,work"，可以替换

和ADR的不同是 ADR的值是用分号分开的数据，LABEL就是一个格式化的文本。

电话通信地址类型

TEL类型定义

目的：指定一个电话号码

例子：TEL;TYPE=work,voice,pref,msg:+1-213-555-1234 begin_of_the_skype_highlighting +1-213-555-1234 免費  end_of_the_skype_highlighting

说明：值是一个规范的全球唯一的电话号码

     TYPE参数的值有：

            "home"表示家庭电话

        "msg" 表示这个号码支持语音

"work" 工作电话

"pref" 表示多个电话中最喜欢使用的电话

"voice" 声音电话号码

               "fax"传真号码

        "cell" 表示手机电话

"video" 视频电话

"pager" 调度电话，估计是总机的电话

        "bbs" 公开的广播系统的电话

        "modem" 调制解调器电话

        "car"汽车电话

        "isdn" ISDN连接电话号码

 "pcs" 个人通信服务电话

缺省是 "voice".

TYPE参数的用法是TYPE=work;TYPE=voice或者"TYPE=work,voice"，缺省值可以被重置

 "TYPE=work,home,voice,fax".

EMAIL类型定义

目的：指定一个电子邮件

例子：EMAIL;TYPE=internet:jqpublic@xyz.dom1.com

    EMAIL;TYPE=internet:jdoe@isp.net

    EMAIL;TYPE=internet,pref:jane_doe@abc.com

TYPE参数的使用

"internet" 表示一个internet 类型地址

    "x400" 表示是一个 X.400 地址

"pref"最喜欢使用的邮件电子

缺省是"internet".

MAILER 类型定义

目的：指定一个电子邮件发送者

例子：MAILER:PigeonMail 2.1

地理类型

TZ类型定义

目的：时区信息

例子：TZ:-05:00

        TZ;VALUE=text:-05:00; EST; Raleigh/North America

        缺省是一个utc-offset值.

GEO类型定义

目的：地理位置信息

例子GEO:37.386013;-122.082932

     CEO 经度；纬度

组织类型

TITLE类型定义

目的：工作位置，工作职能（job title）

例子TITLE:Director\, Research and Development

ROLE 类型定义

目的：公司的职业（occupation）

例子ROLE:Programmer

LOGO类型定义

目的：公司logo，是一个图像信息

例子LOGO;VALUE=uri:http://www.abc.com/pub/logos/abccorp.jpg

LOGO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN         AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm

         ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0

         <...the remainder of "B" encoded binary data...>

说明：TYPE知道图像的格式，ENCODING=b表示是二进制的数据流

      URI表示是一个外部图像对象

AGENT类型定义

目的：指定另外一个人替换他的个人行为

例子：AGENT;VALUE=uri: CID:JQPUBLIC.part3.960129T083020.xyzMail@host3.com

AGENT:BEGIN:VCARD\nFN:Susan Thomas\nTEL:+1-919-555-

         1234\nEMAIL\;INTERNET:sthomas@host.com\nEND:VCARD\n

说明：缺省是一个Vcard对象，当时也可是一个URI指定的外部Vcard对象

ORG类型定义

目的：表示一个组织的名称

例子ORG:ABC\, Inc.;North American Division;Marketing

解释类型

CATEGORIES类型定义

目的：vcard应用的分类信息

例子：CATEGORIES:TRAVEL AGENT

      CATEGORIES:INTERNET,IETF,INDUSTRY,INFORMATION TECHNOLOGY

NOTE 类型定义

目的：对vcard的注释和说明

例子：NOTE:This fax number is operational 0800 to 1715

          EST\, Mon-Fri.

PRODID类型定义

目的：指定创建Vcard对象的产品的ID

例子：PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN

REV类型定义

目的：指定当前Vcard的修改信息

例子：REV:1995-10-31T22:27:10Z

      REV:1997-11-15

SORT-STRING类型定义

目的：指定家庭名称或者其他名称对FN和N类型排序

例子：  FN:Rene van der Harten

        N:van der Harten;Rene;J.;Sir;R.D.O.N.

        SORT-STRING:Harten

        FN:Robert Pau Shou Chang

        N:Pau;Shou Chang;Robert

        SORT-STRING:Pau

        FN:Osamu Koura

        N:Koura;Osamu

        SORT-STRING:Koura

        FN:Oscar del Pozo

        N:del Pozo Triscon;Oscar

        SORT-STRING:Pozo

        FN:Chistine d'Aboville

        N:d'Aboville;Christine

        SORT-STRING:Aboville

SOUND类型定义

目的：指定Vcard的数字声音信息，缺省是指定vcard的name类型的发音信息。

例子：  SOUND;TYPE=BASIC;VALUE=uri:CID:JOHNQPUBLIC.part8.

         19960229T080000.xyzMail@host1.com

        SOUND;TYPE=BASIC;ENCODING=b:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN         AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm         ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0 <...the remainder of "B" encoded binary data...>

可以用URI指定一个外部声音二进制流

    可以是内置的声音二进制流，ENCODING=b

UID类型定义

目的：指定一个全球唯一的个人或资源标识。

例子：UID:19950401-080045-40000F192713-0052

URL类型定义

目的：指定Vcard 参考的路径。

例子：URL:http://www.swbyps.restaurant.french/~chezchic.html

VERSION类型定义

目的：指定Vcard使用的vcard规范的版本。

例子：  VERSION:3.0

Security 类型

CLASS类型定义

目的：指定访问Vcard对象的访问分级。

例子：  CLASS:PUBLIC

        CLASS:PRIVATE

        CLASS:CONFIDENTIAL

说明：安全分级需要参考目录服务的访问分级

KEY 类型定义

目的：指定Vcard的公共钥匙值（加密解密是使用）或者是授权认证。

例子：  KEY;ENCODING=b:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcNAQEEBQA

         wdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENbW11bmljYX

         Rpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0

         ZW1zMRwwGgYDVQQDExNyb290Y2EubmV0c2NhcGUuY29tMB4XDTk3MDYwNj

         E5NDc1OVoXDTk3MTIwMzE5NDc1OVowgYkxCzAJBgNVBAYTAlVTMSYwJAYD

         VQQKEx1OZXRzY2FwZSBDb21tdW5pY2F0aW9ucyBDb3JwLjEYMBYGA1UEAx

         MPVGltb3RoeSBBIEhvd2VzMSEwHwYJKoZIhvcNAQkBFhJob3dlc0BuZXRz

         Y2FwZS5jb20xFTATBgoJkiaJk/IsZAEBEwVob3dlczBcMA0GCSqGSIb3DQ

         EBAQUAA0sAMEgCQQC0JZf6wkg8pLMXHHCUvMfL5H6zjSk4vTTXZpYyrdN2

         dXcoX49LKiOmgeJSzoiFKHtLOIboyludF90CgqcxtwKnAgMBAAGjNjA0MB

         EGCWCGSAGG+EIBAQQEAwIAoDAfBgNVHSMEGDAWgBT84FToB/GV3jr3mcau

         +hUMbsQukjANBgkqhkiG9w0BAQQFAAOBgQBexv7o7mi3PLXadkmNP9LcIP

         mx93HGp0Kgyx1jIVMyNgsemeAwBM+MSlhMfcpbTrONwNjZYW8vJDSoi//y

         rZlVt9bJbs7MNYZVsyF1unsqaln4/vy6Uawfg8VUMk1U7jt8LYpo4YULU7

         UZHPYVUaSgVttImOHZIKi4hlPXBOhcUQ==

扩展类型

可以定义自己的类型，自己定义的类型需要以“x-”开头
比喻例子中的信息：
X-QQ:38394246
X-ICQ:icq
X-WAB-GENDER:2