本週 Windows PowerShell 秘訣

這是使用 Windows PowerShell 的快速秘訣。只要有新的秘訣，我們每週就會在這裡發佈。如果您想要分享任何秘訣，或有任何疑問，請讓我們知道。

您可以在本週 Windows PowerShell 秘訣封存找到更多秘訣。

建立圖形化日期選擇器

你知道…每個人都有弱點。對超人來說就是克利普頓石，只要暴露在克利普頓石之下，超人就會變得非常虛弱。對神力女超人來說就是她自己的神奇繩索，如果你想辦法用神奇繩索把她綁起來，她也會變得很虛弱。還有當綠燈俠碰到黃色物體時，他就會變得非常無力。那 Scripting Guys 呢？嗯，對 Scripting Guys 來說也是克利普頓石…和黃色物體。除此之外，Scripting Guys 還有一個弱點：讓使用者輸入日期的指令碼。

寫出這樣的指令碼並不難，困難的是要控制使用者輸入的日期格式。例如，假設使用者輸入下列日期：

3/11/2008

這似乎非常直截了當：明顯地是指 2008 年 3 月 11 日。

但也有可能是 2008 年 11 月 3 日，畢竟世界上許多地區的標準日期格式如下：

日/月/年

那您怎麼知道這裡使用哪一種格式呢？答案是你永遠不可能知道。

還有一些不是日期的日期，您要怎麼處理像是 2008 年 4 月 31 日這樣的日期呢？另外如果拼字有問題，我們雖然可能瞭解使用者鍵入「Febuary 3, 2008」的意思，但是電腦卻不知道。看了這些例子，您應該有點概念了。每一次要求人員在命令提示輸入日期，就是自找麻煩一次。

其實解決這個問題的方法很簡單：跳出日曆，讓使用者從日曆中挑選日期。這樣可以排除格式的問題，且電腦會將他們挑選的日期轉譯為正確的格式。也可以排除不存在日期 (例如 4 月 31 日) 和月份名稱拼錯的問題。實際上現在只剩一個問題無法排除：那就是無法使用 Windows PowerShell 跳出日曆。

這表示剛剛說的…等一下！誰說無法使用 Windows PowerShell 跳出日曆：

[void] [System.Reflection.Assembly]::LoadWithPartialName("System.Windows.Forms")
[void] [System.Reflection.Assembly]::LoadWithPartialName("System.Drawing") 

$objForm = New-Object Windows.Forms.Form 

$objForm.Text = "Select a Date" 
$objForm.Size = New-Object Drawing.Size @(190,190) 
$objForm.StartPosition = "CenterScreen"

$objForm.KeyPreview = $True

$objForm.Add_KeyDown({
if ($_.KeyCode -eq "Enter") 
        {
$dtmDate=$objCalendar.SelectionStart
$objForm.Close()
        }
    })

$objForm.Add_KeyDown({
if ($_.KeyCode -eq "Escape") 
        {
$objForm.Close()
        }
    })

$objCalendar = New-Object System.Windows.Forms.MonthCalendar 
$objCalendar.ShowTodayCircle = $False
$objCalendar.MaxSelectionCount = 1
$objForm.Controls.Add($objCalendar) 

$objForm.Topmost = $True

$objForm.Add_Shown({$objForm.Activate()})  
[void] $objForm.ShowDialog() 

if ($dtmDate)
    {
Write-Host "Date selected:$dtmDate"
    }
    

這到底是什麼啊！為什麼要叫你看這個呢？讓我們一一檢視程式碼，看看我們的解釋是否可以回答您的問題。

首先，我們需要載入 .NET Framework 類別 System.Windows.Forms。下面這行程式碼就是執行這項工作：

[void] [System.Reflection.Assembly]::LoadWithPartialName("System.Windows.Forms")

別太擔心看不懂，只要照著這行程式碼走就不會有太大的問題。請注意，載入 System.Windows.Forms 時，[void] 會避免類別資訊顯示在螢幕上。若把 [void] 拿掉，則執行 LoadWithPartialName 方法時就會得到下列訊息：

GAC    Version        Location
---    -------        --------
True   v2.0.50727     C:\WINDOWS\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\...
    

我們並不需要這些詳細資訊(這些資訊根本不重要)。接下來我們用完全相同的手法建立 System.Drawing 類別的例項：

[System.Reflection.Assembly]::LoadWithPartialName("System.Drawing")

載入這兩個類別後，我們使用 New-Object cmdlet 來建立 Forms 類別的新例項(因為我們需要容器來放置日曆控制項，所以我們需要 Forms 類別的例項)。建立空白表單 (使用物件參照 $objForm) 之後，我們使用下列的程式碼區塊來指定表單的標題 (Text) 和大小 (190 x 190 像素)，並確認表單每次出現時，都會顯示在螢幕的中央：

$objForm.Text = "Select a Date" 
$objForm.Size = New-Object Drawing.Size @(190,190) 
$objForm.StartPosition = "CenterScreen"
    

可以讓表單出現在螢幕上真是一件好事。更好的是我們也可以讓表單從螢幕上「消失」。在下列兩種情況下，我們不需要看到表單：a) 我們根本就不想要挑選日期，或 b) 已經挑選好日期，現在要使用該日期繼續後續動作。為了不讓事情複雜化，我們決定只在表單的使用者介面放置兩個東西：按下 ENTER 鍵與按一下 [確定] 按鈕的功能相同。而按下 ESC 鍵與按下 [取消] 按鈕的功能相同。

若要使用鍵盤命令 (像是 ENTER 和 ESC 鍵)，首先我們必須將表單的 KeyPreview 屬性設定為 True。如下面這一行程式碼所示：

$objForm.KeyPreview = $True

然後，我們需要定義使用者按下 ENTER 鍵後要執行的動作：

$objForm.Add_KeyDown({
if ($_.KeyCode -eq "Enter") 
        {
$dtmDate=$objCalendar.SelectionStart
$objForm.Close()
        }
    })
    

現在我們使用 Add_KeyDown 方法告訴表單使用者按下 ENTER 鍵時要執行的動作 (也就是剛才按下的按鍵 Keycode 等於 Enter 鍵時)。如果使用者按下 ENTER 鍵，我們會做兩件事：

首先，我們取得日曆 SelectionStart 屬性的值，並將它儲存在名稱為 $dtmDate 的變數。看起來很炫，但其實只是在說明我們要擷取使用者選取的日期，並將它儲存在變數 $dtmDate 中。

第二，我們要呼叫 Close 方法，並關閉表單。接著我們定義使用者按下 ESC 鍵要執行的動作：

$objForm.Add_KeyDown({
if ($_.KeyCode -eq "Escape") 
        {
$objForm.Close()
        }
    })
    

請注意，這時我們不會擷取使用者選取的日期，因為按下 ESC 鍵表示使用者不想要選取日期。相反地，我們要做的就是關閉表單。

這個時候我們可以開始我們最初的目的了：將日曆控制項新增至表單。我們一開始先建立 System.Windows.Forms.MonthCalendar 類別的例項。然後使用下面兩行程式碼來設定日曆的兩個屬性：

$objCalendar.ShowTodayCircle = $False
$objCalendar.MaxSelectionCount = 1  
    

我們將 ShowTodayCircle 屬性設定為 False 的原因很簡單：我們不喜歡日曆設定成 True 的外觀(有什麼差別嗎？先試試將 ShowTodayCircle 設定為 $False，然後再嘗試將 ShowTodayCircle 設定為 $True，您就知道啦！)。接著，我們將 MaxSelectionCount 屬性設定為 1，這樣可以限制使用者只在日曆中選取一個日期。

設定完屬性值之後，我們使用 Add 方法將日曆新增至表單：

$objForm.Controls.Add($objCalendar)

接下來我們設定 TopMost 屬性，這樣可以確保表單會顯示在螢幕中其他視窗之上：

$objForm.Topmost = $True

然後使用下面兩行程式碼來實際叫用日曆：

$objForm.Add_Shown({$objForm.Activate()})  
[void] $objForm.ShowDialog()
    

日曆看起來應該如下圖：

我們的日曆一次只顯示一個月份，因為這是我們想要的。假設我們一次想看 4 個月份，該怎麼做呢？這時我們就需要修改指令碼的兩個地方。第一，要增加表單的大小：

$objForm.Size = New-Object Drawing.Size @(370,330)

第二，要將 CalendarDimensions 屬性設定為四的組合；例如，下面的命令會讓日曆以長寬各兩個月份的方式呈現：

$objCalendar.CalendarDimensions = New-Object Drawing.Size @(2,2)

結果，日曆就會如下所示：

如果您希望日曆以目前的月份 (2008 年 3 月) 開始，那請設定 MinDate 屬性，如下：

$objCalendar.MinDate = Get-Date

…等等…等等

當使用者選擇日期並按下 ENTER 鍵之後，我們唯一要做的就是判斷 (並回應) 選取的日期：

if ($dtmDate)
    {
Write-Host "Date selected:$dtmDate"
    }
    

我們在這裡使用 if 陳述式來判斷 $dtmDate 是否含有值。如果沒有，表示使用者按了 ESC 鍵。如果含有值，則我們只要回應該值就好，如下：

03/18/2008 00:00:00

如果您不喜歡這種格式，你可把它修改成喜歡的格式。使用下面兩行程式碼：

$dtmDateLong = $dtmDate.ToLongDateString()
$dtmDateShort = $dtmDate.ToShortDateString()
    

第一行將 $dtmDate 轉換為下列格式：

Thursday, March 13, 2008

而第二行所得到的格式如下：

3/13/2008

全憑個人喜好。

我們可以繼續下去，不過本週的時間已經用完了。別擔心！我們知道使用 Windows PowerShell 來建立 GUI 小程式 (如日期選擇器) 有很多樂趣。因此，我們準備了一系列的範例來說明如何跳出使用核取方塊、選項按鈕和清單檢視的對話方塊方塊喔！請隨時留意我們的活動！