{"id":3250,"date":"2011-08-05T07:44:00","date_gmt":"2011-08-05T15:44:00","guid":{"rendered":"http:\/\/www.sapien.com\/blog\/?p=3250"},"modified":"2011-08-05T07:45:12","modified_gmt":"2011-08-05T15:45:12","slug":"primalforms-2011-spotlight-on-the-picturebox-control","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2011\/08\/05\/primalforms-2011-spotlight-on-the-picturebox-control\/","title":{"rendered":"PrimalForms 2011: Spotlight on the PictureBox Control"},"content":{"rendered":"

The \u201cSpotlight on Controls\u201d series focuses on a single WinForms control in PrimalForms 2011 , details the important Properties, Methods, and Events of the control and demonstrates how to utilize the control. Most of the information about the controls is still applicable to previous versions of PrimalForms.<\/p>\n

Last time we took a look at the ProgressBar<\/a> control. This time we will look at the PictureBox control:<\/p>\n

PictureBox Control <\/strong>[System.Windows.Forms.PictureBox]<\/span><\/p>\n

Represents a Windows picture box control for displaying an image.<\/p>\n

Default Event: Click<\/p>\n

Why use a PictureBox control?<\/em><\/p>\n

Use a PictureBox when you need to display an image either located on a disk or the internet. Similar to other controls, you can also imbed an image in your form with the PictureBox.<\/p>\n

Important Properties:<\/font><\/span><\/strong><\/p>\n

Image<\/strong> <\/p>\n<\/td>\n\n

The image displayed in the PictureBox.<\/td>\n

Why use the Image property?<\/em> <\/p>\n

Use the Image property when you wish to display an image in your form. In PrimalForms 2011 the image will be imbedded with the form, whereas older versions of PrimalForms reference a file path.  <\/p>\n

\"ImageLocation\"<\/a> <\/p>\n

ImageLocation<\/strong> <\/p>\n

Disk or Web location to load image from. <\/p>\n

Why use the ImageLocation property?<\/em> <\/p>\n

Use the ImageLocation property when you wish to load an image asynchronously from either a website or disk location. Unlike the Image property,  the ImageLocation  property does not imbed the image in the form. <\/p>\n

InitialImage<\/strong> <\/p>\n

Image to display while the main image is loading (ImageLocation). The InitialImage is always displayed non-stretched, in the center of the PictureBox.  <\/p>\n

Default IntialImage: <\/p>\n

\"InitialImage\" <\/p>\n

ErrorImage<\/strong> <\/p>\n

The image to display when an error occurs during the image-loading process or if the image load is canceled. (ImageLocation) <\/p>\n

Default ErrorImage: <\/p>\n

\"ErrorImage\" <\/p>\n<\/td>\n

SizeMode<\/strong> <\/p>\n

This property controls how the PictureBox will handle image placement and control sizing.<\/td>\n

Values (Default: Normal<\/em>): <\/p>\n

\n

Normal<\/em>
The image is placed in the upper-left corner of the PictureBox. The image is clipped if it is larger than the PictureBox it is contained in. <\/p>\n

\"Normal\" <\/p>\n

StretchImage<\/em>
The image within the PictureBox is stretched or shrunk to fit the size of the PictureBox. <\/p>\n

\"Stretch\" <\/p>\n

AutoSize<\/em>
The PictureBox is sized equal to the size of the image that it contains. <\/p>\n

\"AutoSize\"<\/a> <\/p>\n

CenterImage<\/em>
The image is displayed in the center if the PictureBox is larger than the image. If the image is larger than the PictureBox, the picture is placed in the center of the PictureBox and the outside edges are clipped. <\/p>\n

\"Center\" <\/p>\n

Zoom<\/em>
The size of the image is increased or decreased maintaining the size ratio.<\/p>\n

\"Zoom\"<\/p>\n<\/blockquote>\n

 <\/p>\n

Important Events:<\/strong><\/p>\n

LoadProgressChanged<\/strong><\/p>\n

This event occurs when the progress of an asynchronous image-loading operation has changed.<\/p>\n

The LoadProgressChanged event passes a [System.ComponentModel.ProgressChangedEventArgs] object as a parameter to the event block. You can access this object by using the $_<\/span> variable.<\/p>\n

The important property of the ProgressChangedEventArgs object is:<\/p>\n

\n

ProgressPercentage<\/em><\/p>\n

Gets the asynchronous task progress percentage.<\/p>\n<\/blockquote>\n

You can utilize to LoadProgressChanged to display the current load percentage in a progress bar:<\/p>\n

$picturebox1_LoadProgressChanged<\/span>=<\/span>[System.ComponentModel.ProgressChangedEventHandler]{\n<\/span>#Event Argument: $_ = [System.ComponentModel.ProgressChangedEventArgs]<\/span>\n    <\/span>$progressbar1<\/span>.Value <\/span>=<\/span> <\/span>$_<\/span>.ProgressPercentage\n}<\/span><\/pre>\n
 <\/p>\n
Image loading with a progress bar:<\/p>\n
\"LoadProgressChanged\"<\/p>\n
Image load completed:<\/p>\n
\"LoadCompleted\"<\/p>\n
LoadCompleted<\/strong><\/p>\n
This event occurs when the asynchronous image-load operation is completed, been canceled, or raised an exception.<\/p>\n
The LoadCompleted event passes a [System.ComponentModel.AsyncCompletedEventArgs] object as a parameter to the event block. You can access this object by using the $_ variable.<\/p>\n
The two important properties of the AsyncCompleteEventArgs object are:<\/p>\n
\n
Cancelled<\/em><\/p>\n
The Cancelled property will tell you if the loading process was cancelled.<\/p>\n
Error<\/em><\/p>\n
The Error property will contain the exception error if the load operation failed. Use the Message sub-property get the error message text. <\/p>\n<\/blockquote>\n
Below is an example where an error message is displayed when an image fails to load asynchronously using the ImageLocation property:<\/p>\n
$picturebox1_LoadCompleted<\/span>=<\/span>[System.ComponentModel.AsyncCompletedEventHandler]{\n<\/span>#Event Argument: $_ = [System.ComponentModel.AsyncCompletedEventArgs]<\/span>\n    \n    <\/span>if<\/span> (<\/span>$_<\/span>.Error <\/span>-ne<\/span> <\/span>$null<\/span>)\n    {\n        <\/span>$labelMessage<\/span>.Text <\/span>=<\/span> <\/span>$_<\/span>.Error.Message\n    }\n}<\/span><\/pre>\n
 <\/p>\n
\"LoadCompletedErrorMessage\"<\/p>\n
<\/pre>\n","protected":false},"excerpt":{"rendered":"
The \u201cSpotlight on Controls\u201d series focuses on a single WinForms control in PrimalForms 2011 , details the important Properties, Methods, and Events of the control and demonstrates how to utilize the control. Most of the information about the controls is still applicable to previous versions of PrimalForms. Last time we took a look at the […]<\/p>\n","protected":false},"author":10,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[575,644,25],"tags":[641,676,28,633,327],"class_list":["post-3250","post","type-post","status-publish","format-standard","hentry","category-primalforms-2011-software-news","category-spotlight-on-controls","category-windows-powershell","tag-controls","tag-picturebox","tag-powershell","tag-primalforms-2011","tag-winform"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3250","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/comments?post=3250"}],"version-history":[{"count":2,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3250\/revisions"}],"predecessor-version":[{"id":3279,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3250\/revisions\/3279"}],"wp:attachment":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/media?parent=3250"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/categories?post=3250"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/tags?post=3250"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}