<?xml version="1.0"?>
<doc>
<assembly>
<name>AlbumSurfer</name>
</assembly>
<members>
<member name="T:AlbumSurfer.AboutForm">
<summary>AboutForm Class Definition.</summary>
<remarks>A typical invocation of this module would do the following:
<code>
{
AboutForm frmAbout = new AboutForm();
frmAbout.ShowDialog( this );
}</code>
</remarks>
</member>
<member name="F:AlbumSurfer.AboutForm.m_lblCompany">
<summary>Form label for displaying the Company Name.</summary>
<remarks>Value obtained from the Application object "CompanyName" property which itself comes from the Assembly "Company" attribute.</remarks>
</member>
<member name="F:AlbumSurfer.AboutForm.m_lblTitle">
<summary>Form label for displaying the form title.</summary>
<remarks>Value obtained from the Assembly "Title" attribute.</remarks>
</member>
<member name="F:AlbumSurfer.AboutForm.m_lblVersion">
<summary>Form label for displaying the Product Version.</summary>
<remarks>Value obtained from the Application object "Version" property which itself comes from the Assembly "Version" attribute.</remarks>
</member>
<member name="F:AlbumSurfer.AboutForm.m_lblCopyright">
<summary>Form label for displaying the Product Copyright.</summary>
<remarks>Value obtained from the Application object "Copyright" property which itself comes from the Assembly "Company" attribute.</remarks>
</member>
<member name="F:AlbumSurfer.AboutForm.m_lblDescription">
<summary>Form label for displaying the Product Description.</summary>
<remarks>Value obtained from the Application object "Description" property. This is typically a little narrative
that describes what the product can do.</remarks>
</member>
<member name="F:AlbumSurfer.AboutForm.m_tbxReleaseInfo">
<summary>Form text box for displaying information about the release history of this product.</summary>
<remarks>Value obtained from the Assembly "TradeMark" attribute.</remarks>
</member>
<member name="F:AlbumSurfer.AboutForm.m_btnSysInfo">
<summary>Form button which spawns the SYSINFO application to show system information.</summary>
<remarks>Presents the user with a System Info window permitting exploration of the systems characteristics.</remarks>
</member>
<member name="F:AlbumSurfer.AboutForm.m_btnOK">
<summary>Form button to close the about form.</summary>
<remarks>Button provided for the user to dispatch the dialog.</remarks>
</member>
<member name="F:AlbumSurfer.AboutForm.m_pic1">
<summary>Form picture box for the display of the company logo.</summary>
<remarks>A container for placing the corporate logo employing a transparency mechanism where all white pixels of
the source bitmap are replaced with the control back ground.</remarks>
</member>
<member name="F:AlbumSurfer.AboutForm.components">
<summary>Required designer variable.</summary>
<remarks>Container object for the storage of all the objects on the form.</remarks>
</member>
<member name="M:AlbumSurfer.AboutForm.#ctor">
<summary>Constructor.</summary>
<remarks>Constructor procedure which instantiates and initializes all the form objects.</remarks>
</member>
<member name="M:AlbumSurfer.AboutForm.Dispose(System.Boolean)">
<summary>Clean up any resources being used.</summary>
<remarks>Can be though of as the class destructor which disposes of all the form objects.</remarks>
</member>
<member name="M:AlbumSurfer.AboutForm.InitializeComponent">
<summary>Required method for Designer support - do not modify
the contents of this method with the code editor. </summary>
</member>
<member name="M:AlbumSurfer.AboutForm.AboutForm_Load(System.Object,System.EventArgs)">
<summary>Handles the form load event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='eve'>Event arguments.</param>
<returns>void.</returns>
<remarks>Narrative.</remarks>
</member>
<member name="M:AlbumSurfer.AboutForm.AboutForm_KeyDown(System.Object,System.Windows.Forms.KeyEventArgs)">
<summary>Handles the form key down event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='eventArgs'>Event arguments.</param>
<returns>void.</returns>
<remarks>Provides a mechanism to dispatch the About form by pushing the escape key.</remarks>
</member>
<member name="M:AlbumSurfer.AboutForm.AboutForm_Resize(System.Object,System.EventArgs)">
<summary>Handles the form resize event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='eve'>Event arguments.</param>
<returns>void.</returns>
<remarks>Makes sure all the objects on the form are positioned properly after resizing.</remarks>
</member>
<member name="M:AlbumSurfer.AboutForm.m_btnOK_Click(System.Object,System.EventArgs)">
<summary>Handles the m_btnOK click event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='eve'>Event arguments.</param>
<returns>void.</returns>
<remarks>Standard dialog form button for closing the from with an OK response.</remarks>
</member>
<member name="M:AlbumSurfer.AboutForm.m_btnSysInfo_Click(System.Object,System.EventArgs)">
<summary>Handles the m_btnSysInfo click event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='eve'>Event arguments.</param>
<returns>void.</returns>
<remarks>Provides for a means for the user to spawn the application which shows
"System Information" about the structure of the system.</remarks>
</member>
<member name="M:AlbumSurfer.AboutForm.m_pic1_Paint(System.Object,System.Windows.Forms.PaintEventArgs)">
<summary>Handles the m_pic1 paint event.</summary>
<param name='objSender'>Reference to the m_pic1 Object.</param>
<param name='ePaintArgs'>Event arguments.</param>
<returns>void.</returns>
<remarks>This little exercise replaces the white in the bitmap
with the system control background color making the bitmap
act a bit like an icon.</remarks>
</member>
<member name="M:AlbumSurfer.AboutForm.AssemblyInfoGet">
<summary>Procedure to obtain information from the assembly attributes
which is not part of the Application object.</summary>
<returns>void</returns>
<remarks>The Application object provides us with some info from the assembly data, but not all
of it.
<para>The Assembly Title string is also obtained for our window top label.</para>
<para>The framework actually places the AssemblyName.Version string in the
AssemblyInformationalVersionAttribute which ends up as the Application.ProductVersion object.
One can obtain the raw version info with the following code:
<code>
{
Assembly objAssembly;
AssemblyName assName;
objAssembly = System.Reflection.Assembly.GetExecutingAssembly();
assName = objAssembly.GetName(); // has raw Version info in it
strText = assName.Version.ToString();
}</code>
Because of this and that it is convenient to get the Version string from the
Application object we will hijack the Trademark attribute to store or product
release history.
</para>
</remarks>
</member>
<member name="T:AlbumSurfer.MainForm">
<summary>Root form for the Album Surfer Application.</summary>
<remarks>This is the main form which permits selection of options as well as a view port for the images.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.frmMain">
<summary>A object reference to our one and only main form.</summary>
<remarks>A reference to the instantiated object is placed here.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.g_reg">
<summary>An object reference to the instantiated registry persistent storage class.</summary>
<remarks>By choosing "USE_REGISTRY" the registry flavor of persistent storage is instantiated.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.g_strSelectedPathFile">
<summary>Global string variable for the select path file (persisted).</summary>
<remarks>The path and filename of the last/first view file of a directory.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.g_s32TimerInterval">
<summary>Global string variable for the select path file (persisted).</summary>
<remarks>This is the time interval in milliseconds for the slide show display.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.ms_strWinPlacement">
<summary>String variable keep in persistent storage as to the placement and size of the main form.</summary>
<remarks>This string is the "Top,Left,Width,Height" of the main form.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.ms_strHelpPathFile">
<summary>String variable which is the path and name of the help file.</summary>
<remarks>This string is created by concatenating the help file name "AlbumSurfer.chm" to the application path.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.ms_s32JpegSaveQuality">
<summary>Long parameter value used when saving jpegs.</summary>
<remarks>When saving jpegs this value is used to determine the compression quality factor.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_DelegateDragDropOpen">
<summary>Delegate linkage for file Drag and Drop operations.</summary>
<remarks>Object instantiation of a delegate to allow an immediate return from the Drag and Drop event.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_alstFiles">
<summary>ArrayList collection for the storage of all the files in the directory that have image extensions.</summary>
<remarks>This is a list of path filenames sorted in the order of their root filename( no extension ).</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_alstImageExts">
<summary>ArrayList collection for the storage of all known image extensions we can handle.</summary>
<remarks>This is a list of image extensions. If the file is one of these we can display it.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_s32FileIXShowing">
<summary>Storage variable for the index in the m_alstFiles of the presently displayed file.</summary>
<remarks>If this value is -1 nothing is being displayed.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_s32FileIXNext">
<summary>Storage variable for the index in the m_alstFiles of the next request file to be displayed.</summary>
<remarks>If this value is -1 nothing is being requested.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_ynBusy">
<summary>The "Fit to Window" and "Actual Size" items interact with each other. This boolean is essentially a lock
when one is being modified not to modify the other except as needed.</summary>
<remarks>Essanetially this boolean is acting like a data mutex.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_bmap">
<summary>Storage variable for off screen bitmaps.</summary>
<remarks>Used when selected data need to be stored off screen.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_sfpScale">
<summary>Storage variable for displayed bitmap magnification factor.</summary>
<remarks>Floating point value used to scale the bitmap for display.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_ynSizeToFit">
<summary>Variable that indicates when what is being displayed has been scaled to fit.</summary>
<remarks>.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_ynPicMouseDown">
<summary>Variable that indicates the left mouse button is being depressed.</summary>
<remarks>This variable helps us figure out when we are in the area select process.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_ptStart">
<summary>Variable that stores the point of origin of the select process.</summary>
<remarks>This variable stores the point on the screen where the user started the selection process.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_ptScreen">
<summary>Variable that stores the screen coordinate X,Y for start point of selection.</summary>
<remarks>This value is used as the start info in the rectReversable rectangle.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_s32SelectW">
<summary>Variable that stores the Width of the selection rectangle.</summary>
<remarks>.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_s32SelectH">
<summary>Variable that stores the Height of the selection rectangle.</summary>
<remarks>.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_rectReversable">
<summary>The rectangle object used to call the selection draw routines.</summary>
<remarks>This object has its X,Y and W,H appropriately initialized for calling the appear/disappear routines.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuMain">
<summary>The main menu object.</summary>
<remarks>This is the container object for menu item objects of the form.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuFile">
<summary>The "File" menu column header.</summary>
<remarks>This is the parent menu item that owns all the items in the "File" column.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuFileOpenFile">
<summary>The "File" menu "Open File" item.</summary>
<remarks>Clicking this menu item causes the Open File dialog to appear.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuFileImagesShow">
<summary>The "File" menu "Images Show" item.</summary>
<remarks>Clicking this menu item causes the automatic slide show feature to get toggled on and off.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuFileSep0">
<summary>The "File" menu separator #0.</summary>
<remarks>This provides a way of separating unlike operations in a menu list.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuFileExit">
<summary>The "File" menu "Exit" item.</summary>
<remarks>Clicking this menu item causes the application to exit.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuEdit">
<summary>The "Edit" menu column header.</summary>
<remarks>This is the parent menu item that owns all the items in the "Edit" column.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuEditCut">
<summary>The "Edit" menu "Cut" item.</summary>
<remarks>Provides standard edit functionality(Inactive).</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuEditCopy">
<summary>The "Edit" menu "Copy" item.</summary>
<remarks>Provides standard edit functionality(Inactive).</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuEditPaste">
<summary>The "Edit" menu "Paste" item.</summary>
<remarks>Provides standard edit functionality(Inactive).</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuView">
<summary>The "View" menu column header.</summary>
<remarks>Provides a header for the View menu item collection.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuViewPreviousImage">
<summary>The "View" menu "Previous Image" item.</summary>
<remarks>Clicking this menu item causes the previous image in the view list to be displayed.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuViewNextImage">
<summary>The "View" menu "Next Image" item.</summary>
<remarks>Clicking this menu item causes the next image in the view list to be displayed.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuViewSep0">
<summary>The "View" menu separator #0.</summary>
<remarks>This provides a way of separating unlike operations in a menu list.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuViewFitToWindow">
<summary>The "View" menu "Fit To Window" item.</summary>
<remarks>Clicking this menu item causes the image to be sized to completely fit in the displayed window.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuViewZoomIn">
<summary>The "View" menu "Zoom In" item.</summary>
<remarks>Clicking this menu item causes the image to be increased in size by 25%.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuViewZoomOut">
<summary>The "View" menu "Zoom Out" item.</summary>
<remarks>Clicking this menu item causes the image to be decreased in size by 25%.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuViewActualSize">
<summary>The "View" menu "Actual Size" item.</summary>
<remarks>Clicking this menu item causes the image to be sized to its natural pixel resolution.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuViewFullScreen">
<summary>The "View" menu "Full Screen" item.</summary>
<remarks>Clicking this menu item causes the main form to loose it borders and display the image full screen.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuViewSep1">
<summary>The "View" menu separator #1.</summary>
<remarks>This provides a way of separating unlike operations in a menu list.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuViewProperties">
<summary>The "View" menu "Properties" item.</summary>
<remarks>Clicking this menu item causes the image properties form to appear.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuViewSep2">
<summary>The "View" menu separator #2.</summary>
<remarks>This provides a way of separating unlike operations in a menu list.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuTools">
<summary>The "Tools" menu column header.</summary>
<remarks>This is the parent menu item that owns all the items in the "Tools" column.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuToolsOptions">
<summary>The "Tools" menu "Options" item.</summary>
<remarks>Clicking this menu item causes the "Options" dialog to appear.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuHelp">
<summary>The "Help" menu column header.</summary>
<remarks>This is the parent menu item that owns all the items in the "Help" column.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuHelpAbout">
<summary>The "Help" menu "About" item.</summary>
<remarks>Clicking this menu item causes the "About" dialog to appear.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.mnuHelpHelp">
<summary>The "Help" menu "Help" item.</summary>
<remarks>Clicking this menu item causes the compiled Help file to appear.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.cmnuPic1">
<summary>Screen context menu column header.</summary>
<remarks>Right clicking screen picture area causes this menu to appear.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.cmnuPic1Previous">
<summary>The Picture context menu "Previous" item.</summary>
<remarks>Selecting this menu item causes the previous image to be displayed.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.cmnuPic1Next">
<summary>The Picture context menu "Next" item.</summary>
<remarks>Selecting this menu item causes the next image to be displayed.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.cmnuPic1Sep0">
<summary>The separator #0 in the picture context menu.</summary>
<remarks>This provides a way of separating unlike operations in a menu list.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.cmnuPic1Save">
<summary>The Picture context menu "Save" item.</summary>
<remarks>Selecting this menu item cause Save File dialog to appear.
This is only enabled if there is a selected area so its enabled status can be used to determine active selection.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.cmnuPic1Properties">
<summary>The Picture context menu "Properties" item.</summary>
<remarks>Clicking this menu item causes the image properties form to appear..</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_dlgFileOpen">
<summary>File Open dialog used to obtain the location of a new file (directory) to be displayed.</summary>
<remarks>When the user selects the File->Open menu option this dialog is invoked.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_dlgFileSave">
<summary>File Save dialog used to save the selected image area.</summary>
<remarks>When the user selects the "Save" option from the display context menu this dialog is invoked.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_tmr1">
<summary>The form timer used for automatic sequential image display.</summary>
<remarks>This interval on this time determines the delay between the display of each image.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_sbr1">
<summary>The form status bar container object that contains the status panels.</summary>
<remarks>Status panels provide feedback to the user about the image object properties.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_spanInfo">
<summary>The form status bar panel for general user information.</summary>
<remarks>Status bar panel where the user is given feedback on general operation success and failures.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_spanPicXY">
<summary>The form status bar panel for cursor X,Y inside the picture area.</summary>
<remarks>Status bar panel in which we show the X,Y of the cursor in the picture image.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_spanBmapWH">
<summary>Status bar panel to show the natural image width and height.</summary>
<remarks>In this panel we show the user natural width and height of the source bitmap.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_spanIdOfTot">
<summary>Status bar panel to show the user which image of the collection is being display.</summary>
<remarks>In this panel the user is given ID of the presently display image and how many are in the collection.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_spanFormat">
<summary>Status bar panel which show the user the natural format of the source image.</summary>
<remarks>In this panel the user is given the type of image the source is.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_panPic">
<summary>The form panel container object that contains the bitmap picture box.</summary>
<remarks>This picture box is appropriated placed in this panel depending on it scale.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_pic1">
<summary>The form picture box that the bitmap gets rendered in.</summary>
<remarks>This object is a child of the picture panel and renders the bitmap to the appropriate scale.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.m_spanPercentage">
<summary>Status bar panel to show the user the percentage of scaling of the image being displayed.</summary>
<remarks>In this panel the user is given the displayed scaling factor.</remarks>
</member>
<member name="F:AlbumSurfer.MainForm.components">
<summary>Required designer variable.</summary>
<remarks>This container object is where the forms wizard places all the objects that belong to the form.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.#ctor">
<summary>The constructor for the class</summary>
<remarks>Instantiate and initialize all objects owned by the form and
initalize other variables as needed</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.Dispose(System.Boolean)">
<summary>Destructor for class, clean up any resources being used.</summary>
<remarks>Thus is where the class resources are freed.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.InitializeComponent">
<summary>Required method for Designer support - do not modify
the contents of this method with the code editor.</summary>
</member>
<member name="M:AlbumSurfer.MainForm.Main(System.String[])">
<summary>The entry point of the application for windows.</summary>
<param name='astrArgs'>Array of invocation command line arguments, if any.</param>
<returns>void.</returns>
<remarks>This is the main entry point for windows and kicks off the application
functionality by instantiating the MainForm and spawning it.
Additionally we instantiate our application persistent store mechanism and
show the splash screen letting the user know we have started.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.MainForm_Load(System.Object,System.EventArgs)">
<summary>Handles the Form Load event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Sets up window position and size and initializes some data values.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.MainForm_Closed(System.Object,System.EventArgs)">
<summary>Handle the Form Closed event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Store user values in persistence object data for next execution.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.MainForm_Activated(System.Object,System.EventArgs)">
<summary>Handles the Main Form Activate event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>This event ensures that mouse wheel input will be seen by the control that changes images.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.MainForm_DragDrop(System.Object,System.Windows.Forms.DragEventArgs)">
<summary>Handles the Drag Drop event for the Main Form.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>If the user drops it in a form owned area, we will receive it.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.MainForm_KeyDown(System.Object,System.Windows.Forms.KeyEventArgs)">
<summary>Handles the form KeyDown event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Narrative.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.MainForm_DragEnter(System.Object,System.Windows.Forms.DragEventArgs)">
<summary>Handles the Drag Enter event for the Main Form.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>If the user is dragging a "FileDrop" to the form response by
turning on the Copy indicator giving feedback to the user indicating
the drop will be accepted.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.mnuFileOpenFile_Click(System.Object,System.EventArgs)">
<summary>Handles the File Open menu item click.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Present to the user a File Open Dialog and set up files.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.mnuFileImagesShow_Click(System.Object,System.EventArgs)">
<summary>Handles the File menu Images Show menu item click.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Toggle the auto show feature on and off.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.mnuFileExit_Click(System.Object,System.EventArgs)">
<summary>Handles the File menu Exit menu item click.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Abort the application and exit.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.mnuViewPreviousImage_Click(System.Object,System.EventArgs)">
<summary>Handles the View menu Previous Image menu item click.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Display the sequentially previous image to the user.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.mnuViewNextImage_Click(System.Object,System.EventArgs)">
<summary>Handles the View menu Next Image menu item click.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Display the sequentially next image to the user.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.mnuViewFitToWindow_Click(System.Object,System.EventArgs)">
<summary>Handles the View menu Fit To Window menu item click.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Set the image to fit the window, at least one aspect.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.mnuViewZoomIn_Click(System.Object,System.EventArgs)">
<summary>Handles the View menu ImageZoomIn menu item click.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Zoom in the image for the user.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.mnuViewZoomOut_Click(System.Object,System.EventArgs)">
<summary>Handles the View menu ImageZoomOut menu item click.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Zoom out for the user.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.mnuViewActualSize_Click(System.Object,System.EventArgs)">
<summary>Handles the View menu Actual Size menu item click.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Set the image being displayed to it nature resolution factor.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.mnuViewFullScreen_Click(System.Object,System.EventArgs)">
<summary>Handles the View menu Full Screen item click.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>When the user click this menu item the image goes to full screen with
no borders, menu or status bar.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.mnuToolsOptions_Click(System.Object,System.EventArgs)">
<summary>Handles the Tools menu Option item click.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Show the user the Options Form.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.mnuHelpHelp_Click(System.Object,System.EventArgs)">
<summary>Handles the Help menu Help item click event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>When the user clicks this menu item the compiled help file appears on the screen.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.mnuHelpAbout_Click(System.Object,System.EventArgs)">
<summary>Handles the Help menu About menu item click.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Show the user the application About form.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.cmnuPic1Previous_Click(System.Object,System.EventArgs)">
<summary>Handles the m_pic1 context menu Previous item click event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>If the user calls up the context menu in the picture box and clicks
the "Previous Image" item, show the previous image.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.cmnuPic1Next_Click(System.Object,System.EventArgs)">
<summary>Handles the m_pic1 context menu Next item click event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>If the user calls up the context menu in the picture box and clicks
the "Next Image" item, show the next image..</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.cmnuPic1Save_Click(System.Object,System.EventArgs)">
<summary>Handles the m_pic1 context menu "Save" item click.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>If a selection rectangle has been defined open the file save dialog
and give the user the option of the format that the selected area is saved in.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.m_panPic_Paint(System.Object,System.Windows.Forms.PaintEventArgs)">
<summary>Paint the bitmap according to the scaling factor. Usually initiated
by an Invalidate.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>This procedures main job is to figure out the positioning of the picture
box control in its container panel. This is all a function of the scaling factor
the user has chosen for the image.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.m_panPic_DragEnter(System.Object,System.Windows.Forms.DragEventArgs)">
<summary>Handles the Drag Enter event for the picture box panel control.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>If the user is dragging a "FileDrop" to the form response by
turning on the Copy indicator giving feedback to the user indicating
the drop will be accepted..</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.m_panPic_DragDrop(System.Object,System.Windows.Forms.DragEventArgs)">
<summary>Handles the Drag Drop event for the picture box panel control.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>If the user drops it in a picture box panel control area,
we will receive it.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.m_panPic_MouseWheel(System.Object,System.Windows.Forms.MouseEventArgs)">
<summary>Handles the mouse wheel event in the picture box panel control.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>If the mouse wheel is rotated up show the next image, if down show the
previous image.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.m_panPic_MouseEnter(System.Object,System.EventArgs)">
<summary>Handles the Mouse Enter event in the picture box panel control.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>To receive mouse wheel events the control has to have focus.
If the user moves the mouse into the panel control that contains the picture
box this procedure will make sure the panel has focus.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.m_panPic_Resize(System.Object,System.EventArgs)">
<summary>Handles the m_panPic Resize event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>This event occurs whenever the user resizes the main form. The invalidate forces
a m_panPic Repaint which forces a m_pic1 repaint with the new size.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.m_pic1_Paint(System.Object,System.Windows.Forms.PaintEventArgs)">
<summary>Paints the bitmap into the m_pic1 picture box object.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Paints the image into the form picture box control.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.m_pic1_MouseDown(System.Object,System.Windows.Forms.MouseEventArgs)">
<summary>Handles the Mouse Down in the m_pic1 picture box control.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>This is typically the start of an area selection action so we need
to store our starting coordinates.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.m_pic1_MouseMove(System.Object,System.Windows.Forms.MouseEventArgs)">
<summary>Handles the Mouse Move Event in the m_pic1 control</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Translate the mouse position in the m_pic1 control and display to the user
If we are in a select region activity undraw and redraw the selection rectangle.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.m_pic1_MouseUp(System.Object,System.Windows.Forms.MouseEventArgs)">
<summary>Handles the Mouse Up event in the m_pic1 picture box control.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Typically the end of a select area action.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.m_tmr1_Tick(System.Object,System.EventArgs)">
<summary>Handles the timer tick event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>If the timer is running we are sequentially showing images,
get the next one.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.FileListInit(System.Boolean)">
<summary>Procedure to initialize the file access mechanism.</summary>
<param name='ynStartUp'>Arg1Purpose.</param>
<returns>void.</returns>
<remarks>Using the selected file path we will search the entire directory for
all graphic files we know anything about, sort them by their root name, and
display the one the user started with.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.ImageSelectedShow">
<summary>Displays the image represented by the index the user has chosen.</summary>
<returns>void.</returns>
<remarks>The mechanism for selecting an image is to set the m_s32FileIXNext variable
to the index of the image you want to display.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.ImageNext">
<summary>Displays the sequentially next image in the list.</summary>
<returns>void.</returns>
<remarks>Selects and displays the next image in the list and wraps if necessary.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.ImagePrevious">
<summary>Displays the sequentially previous image in the list.</summary>
<returns>void.</returns>
<remarks>Selects and displays the previous image in the list and wraps if necessary.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.ImageZoomIn">
<summary>Zooms in the image being displayed.</summary>
<returns>void.</returns>
<remarks>Changes the scale factor by 25% zooming in.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.ImageZoomOut">
<summary>Zooms out the image being displayed.</summary>
<returns>void.</returns>
<remarks>Changes the scale factor by 25% zooming out.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.ImageSizeSet(System.Single)">
<summary>Makes an attempt to make sure the images about to be used is not too large.</summary>
<param name='sfpScale'>The magnification factor.</param>
<returns>void.</returns>
<remarks>High resolution images can get very very large when you zoom in on them
and this procedure tries to prevent the app from blowing up.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.ImageActualSize(System.Boolean)">
<summary>Sets the displayed image to its natural resolution.</summary>
<param name='ynSet'>Boolean that indicates whether to turn on or off actual size.</param>
<returns>void.</returns>
<remarks>Narrative.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.ImageFitToWindow(System.Boolean)">
<summary>Sets the displayed image to a size that makes at least one of its dimensions
fill the display area.</summary>
<param name='ynSet'>Boolean that indicates whether to turn on the fit to window, or
turn it off.</param>
<returns>void.</returns>
<remarks>"ImageFitToWindow" and "ImageActualSize" are two parts of the image size logic that
tell the drawing routine what size to render the picture. If "ImageFitToWindow" is true it
implies that "ImageActualSize" is false and vice versa. If both are false then we are
scaling the bitmap rendering at some other resolution.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.Pic1Scroll(System.Windows.Forms.Keys,System.Boolean)">
<summary>Scrolls the image in the picture panel the direction and amount request by the user.</summary>
<param name='keyID'>Whether Up, Down, or Left, Right key was pressed.</param>
<param name='ynBig'>Whether we should scroll the pic image a big or small increment.</param>
<returns>void.</returns>
<remarks>This procedures job is first to figure out the direction and size the
user want to scroll the pic image, and then do it. .</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.Pic1SelectionGet_bmap">
<summary>Procedure to return a bitmap object from the selected area in the m_pic1 control area.</summary>
<returns>void.</returns>
<remarks>Return a bitmap from the selected area in the picture box control. Uses the Win32 Gdi32.dll
to perform this function.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.DesktopGet_bmap">
<summary>Procedure to return a bitmap object from the selected screen area.</summary>
<returns>Bitmap</returns>
<remarks>When the user selects an area of the screen and clicks save, this procedure
gets the area selected as a bitmap. Uses Win32 Gdi32.dll to do this.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.DrawXORRectangle(System.Drawing.Graphics,System.Int32,System.Int32,System.Int32,System.Int32)">
<summary>Procedure to demonstrate the classic XOR box draw technique.</summary>
<param name='gcDst'>Graphics context of the area to be drawn to.</param>
<param name='s32Left'>Coordinate of the left of the drawn to area(X).</param>
<param name='s32Top'>Coordinate of the top of the drawn to area(Y).</param>
<param name='s32Right'>Coordinate of the right of the drawn to area(X + Width).</param>
<param name='s32Bottom'>Coordinate of the bottom of the drawn to area(Y + Height).</param>
<returns>void.</returns>
<remarks>This procedure employees the Win32 Gdi32.dll and draws an XOR rectangle
employing the classic technique.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.DragDropOpen(System.String)">
<summary>Procedure to use the path and file from a drag and drop as the album reference.</summary>
<param name='strFile'>This is the path and file string of the newly selected image.</param>
<returns>void.</returns>
<remarks>There are Drag and drop routines for both the form and the image panel, so where ever
the user drops will work. This procedure is employed by both to switch the image reference.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.DragDropExecute(System.Windows.Forms.DragEventArgs)">
<summary>Procedure to do the Drag Drop event.</summary>
<param name='e'>DragEventArgs event data.</param>
<returns>void.</returns>
<remarks>Since our drag drops are from the explorer, and the explorer
is effectively paused while we are responding to the drop event, we
will receive the data and call the processing procedure asynchronously
so the operation of the explorer will not be paused because of us.</remarks>
</member>
<member name="M:AlbumSurfer.MainForm.ScreenFullToggle">
<summary>Procedure to toggle back and forth between full screen and normal window style.</summary>
<returns>void.</returns>
<remarks>This procedure toggles between a full screen display with no borders and what ever
size and position the display was before it was toggled to full screen.</remarks>
</member>
<member name="T:AlbumSurfer.MainForm.DelegateDragDropOpen">
<summary>Delegate used in asynchronous call (see Form1_DragDrop).</summary>
<remarks>Delegate type definition used to asynchronously process the dropped file.</remarks>
</member>
<member name="T:AlbumSurfer.ImageNameSortClass">
<summary>Comparitor class for sorting image file roots</summary>
</member>
<member name="T:AlbumSurfer.CONST">
<summary>Publicly accessible constant values are defined in this class.</summary>
<remarks>Publicly accessible class of constants. These are defined for consistency between classes.</remarks>
</member>
<member name="F:AlbumSurfer.CONST.REG_START_IMAGE">
<summary>Registry key ID string for image file to start with, last one viewed also.</summary>
<remarks>Set to a value of "Start Image".</remarks>
</member>
<member name="T:AlbumSurfer.OptionsForm">
<summary>Options Form Object Definition.</summary>
<remarks>Defines the Options Form and all objects owned by it.</remarks>
</member>
<member name="F:AlbumSurfer.OptionsForm.m_tvw1">
<summary>Forms treeview object.</summary>
<remarks>This object permits selection of multiple user control option pages.</remarks>
</member>
<member name="F:AlbumSurfer.OptionsForm.m_spl1">
<summary>Forms splitter object.</summary>
<remarks>This object permits selection of display partitioning between the treeview and user control.</remarks>
</member>
<member name="F:AlbumSurfer.OptionsForm.m_uctlPage0">
<summary>User control object.</summary>
<remarks>this is page 0 of optional application parameters.</remarks>
</member>
<member name="F:AlbumSurfer.OptionsForm.m_uctlPage1">
<summary>User control object.</summary>
<remarks>This is page 1 of optional application parameters.</remarks>
</member>
<member name="F:AlbumSurfer.OptionsForm.components">
<summary>Required designer variable. </summary>
<remarks>Container object for all objects owned by the Options form.</remarks>
</member>
<member name="M:AlbumSurfer.OptionsForm.#ctor">
<summary>Class constructor for an OptionsForm</summary>
<returns>void</returns>
<remarks>Call InitializeComponent which instantiates and initializes all objects owned by the form and managed by the wizard.</remarks>
</member>
<member name="M:AlbumSurfer.OptionsForm.Dispose(System.Boolean)">
<summary>Clean up any resources being used.</summary>
<remarks>Effectively the destructor, object collected by the garbage collection.</remarks>
</member>
<member name="M:AlbumSurfer.OptionsForm.InitializeComponent">
<summary>
Required method for Designer support - do not modify
the contents of this method with the code editor.
</summary>
</member>
<member name="M:AlbumSurfer.OptionsForm.OptionsForm_Closing(System.Object,System.ComponentModel.CancelEventArgs)">
<summary>Handles the ? event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Change the visibility of each user control to invisible permitting them to preserve whatever they must.</remarks>
</member>
<member name="M:AlbumSurfer.OptionsForm.OptionsForm_Load(System.Object,System.EventArgs)">
<summary>Handles the ? event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>This event would typically be used to init any form any child data. </remarks>
</member>
<member name="M:AlbumSurfer.OptionsForm.m_tvw1_AfterSelect(System.Object,System.Windows.Forms.TreeViewEventArgs)">
<summary>Handles the treeview after select event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Sets up the mask correctly from after select to show the
appropriate user control.</remarks>
</member>
<member name="M:AlbumSurfer.OptionsForm.ShowUctrl(System.UInt32)">
<summary>Procedure which is passed a mask indicating the user control to display.</summary>
<param name='u32Mask'>Binary mask used to indicate user control to display.</param>
<returns>void.</returns>
<remarks>Mechanism to show a user control. If the visible control has changed we make the old one
invisible thereby permitting it to preserve any necessary data. Two user controls will have
visibility event the old visible one becomes invisible, and the new one become visible.</remarks>
</member>
<member name="T:AlbumSurfer.Page0Uctrl">
<summary>Definition of the Page0Uctrl Class.</summary>
<remarks>This class definition defines the objects, methods and properties of the Page0Uctrl object.</remarks>
</member>
<member name="F:AlbumSurfer.Page0Uctrl.m_ynSuspendLayout">
<summary>Boolean object.</summary>
<remarks>This object provides a mechanism for ignore layout changes during init.</remarks>
</member>
<member name="F:AlbumSurfer.Page0Uctrl.m_lblPageTitle">
<summary>A form label for the storage of the page title.</summary>
<remarks>Label for displaying user control title.</remarks>
</member>
<member name="F:AlbumSurfer.Page0Uctrl.m_updwImageInterval">
<summary>Forms numeric up and down object.</summary>
<remarks>This NumericUpDown provides a selection mechanism for the auto show time interval selection.</remarks>
</member>
<member name="F:AlbumSurfer.Page0Uctrl.m_lblUpDownTitle">
<summary>Forms label object providing a title to or interval adjustment control.</summary>
<remarks>This object .</remarks>
</member>
<member name="F:AlbumSurfer.Page0Uctrl.m_lblUpDownTag">
<summary>Forms label object.</summary>
<remarks>This object permits selection of multiple user control option pages.</remarks>
</member>
<member name="F:AlbumSurfer.Page0Uctrl.components">
<summary>Required designer variable.</summary>
<remarks>Forms designer container for all our user control objects.</remarks>
</member>
<member name="M:AlbumSurfer.Page0Uctrl.#ctor">
<summary>Class Constructor for Page1Uctr0.</summary>
<remarks>This method calls the Windows Form InitializeComponent function to instantiate and
initialize all of this class's objects.</remarks>
</member>
<member name="M:AlbumSurfer.Page0Uctrl.Dispose(System.Boolean)">
<summary>Clean up any resources being used.</summary>
<remarks>This method functions like a destructor except we must wait for garbage collection
before all objects are actually freed.</remarks>
</member>
<member name="M:AlbumSurfer.Page0Uctrl.InitializeComponent">
<summary>
Required method for Designer support - do not modify
the contents of this method with the code editor.
</summary>
</member>
<member name="M:AlbumSurfer.Page0Uctrl.Page0Uctrl_VisibleChanged(System.Object,System.EventArgs)">
<summary>Handles the Visibility Changed event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>When the parent form tree view is clicked it make invisible the presently
active user control and then visible the newly chosen one. These events indicate to
to user control its status so that it can either save or refresh data that it controls.</remarks>
</member>
<member name="T:AlbumSurfer.Page1Uctrl">
<summary>Definition of the Page1Uctrl Class.</summary>
<remarks>This class definition defines the objects, methods and properties of the Page1Uctrl object.</remarks>
</member>
<member name="F:AlbumSurfer.Page1Uctrl.m_ynSuspendLayout">
<summary>Boolean to ignore layout during initialization.</summary>
<remarks>This object provides a mechanism for ignore layout changes during init. Its public so the
parent container can tell indicate when it has stop setting initial values</remarks>
</member>
<member name="F:AlbumSurfer.Page1Uctrl.m_lblPageTitle">
<summary>A form label for the storage of the page title.</summary>
<remarks>Label for displaying user control title.</remarks>
</member>
<member name="F:AlbumSurfer.Page1Uctrl.m_gbxJpgSaveQuality">
<summary>A group box container for the Jpeg quality controls.</summary>
<remarks>This group box contain all the control object which permit adjustment of Jpeg save quality.</remarks>
</member>
<member name="F:AlbumSurfer.Page1Uctrl.m_tbar">
<summary>A track bar for fine adjustment of Jpeg save quality.</summary>
<remarks>This track bar permits adjustment of the Jpeg save quality factor on a fine level.</remarks>
</member>
<member name="F:AlbumSurfer.Page1Uctrl.m_lblTbarValue">
<summary>A form label for the storage of the Jpeg save quality percentage.</summary>
<remarks>Label for displaying the Jpeg save quality percentage..</remarks>
</member>
<member name="F:AlbumSurfer.Page1Uctrl.m_btn100">
<summary>A form button for the quick selection of a Jpeg save quality percentage of 100%.</summary>
<remarks>Button for selecting a Jpeg save quality of 100%.</remarks>
</member>
<member name="F:AlbumSurfer.Page1Uctrl.m_btn75">
<summary>A form button for the quick selection of a Jpeg save quality percentage of 76%.</summary>
<remarks>Button for selecting a Jpeg save quality of 75%.</remarks>
</member>
<member name="F:AlbumSurfer.Page1Uctrl.m_btn50">
<summary>A form button for the quick selection of a Jpeg save quality percentage of 50%.</summary>
<remarks>Button for selecting a Jpeg save quality of 50%.</remarks>
</member>
<member name="F:AlbumSurfer.Page1Uctrl.m_btn25">
<summary>A form button for the quick selection of a Jpeg save quality percentage of 25%.</summary>
<remarks>Button for selecting a Jpeg save quality of 25%.</remarks>
</member>
<member name="F:AlbumSurfer.Page1Uctrl.components">
<summary> Required designer variable.</summary>
<remarks>Forms designer container for all our user control objects.</remarks>
</member>
<member name="M:AlbumSurfer.Page1Uctrl.#ctor">
<summary>Class Constructor for Page1Uctrl.</summary>
<remarks>This method calls the Windows Form InitializeComponent function to instantiate and
initialize all of this class's objects.</remarks>
</member>
<member name="M:AlbumSurfer.Page1Uctrl.Dispose(System.Boolean)">
<summary>Clean up any resources being used.</summary>
<remarks>This method functions like a destructor except we must wait for garbage collection
before all objects are actually freed.</remarks>
</member>
<member name="M:AlbumSurfer.Page1Uctrl.InitializeComponent">
<summary>
Required method for Designer support - do not modify
the contents of this method with the code editor.
</summary>
</member>
<member name="M:AlbumSurfer.Page1Uctrl.Page1Uctrl_VisibleChanged(System.Object,System.EventArgs)">
<summary>Handles the Visibility Changed event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>When the parent form tree view is clicked it make invisible the presently
active user control and then visible the newly chosen one. These events indicate to
to user control its status so that it can either save or refresh data that it controls.</remarks>
</member>
<member name="M:AlbumSurfer.Page1Uctrl.m_tbar_ValueChanged(System.Object,System.EventArgs)">
<summary>Handles the tbar Value changed event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>The user is sliding the tbar handle and we will display the value
in numbers that reflects their change.</remarks>
</member>
<member name="M:AlbumSurfer.Page1Uctrl.m_btn100_Click(System.Object,System.EventArgs)">
<summary>Handles the tbar group 100% button click event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>This button permits quick selection of a Jpeg quality of 100%.</remarks>
</member>
<member name="M:AlbumSurfer.Page1Uctrl.m_btn75_Click(System.Object,System.EventArgs)">
<summary>Handles the tbar group 75% button click event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>This button permits quick selection of a Jpeg quality of 75%.</remarks>
</member>
<member name="M:AlbumSurfer.Page1Uctrl.m_btn50_Click(System.Object,System.EventArgs)">
<summary>Handles the tbar group 50% button click event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>This button permits quick selection of a Jpeg quality of 50%.</remarks>
</member>
<member name="M:AlbumSurfer.Page1Uctrl.m_btn25_Click(System.Object,System.EventArgs)">
<summary>Handles the tbar group 25% button click event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>This button permits quick selection of a Jpeg quality of 25%.</remarks>
</member>
<member name="T:AlbumSurfer.PropertiesForm">
<summary>Properties Form Class.</summary>
<remarks>This is the main form which displays to the user a list of all the properties of the image.</remarks>
</member>
<member name="F:AlbumSurfer.PropertiesForm.m_s32MaxLineCount">
<summary>Storage variable for the maximum number of properties values to show before truncation.</summary>
<remarks>.</remarks>
</member>
<member name="F:AlbumSurfer.PropertiesForm.m_compLvwItms">
<summary>List View Item Comparator Object.</summary>
<remarks>This object is used to managed the sorting technique employed by listview items.</remarks>
</member>
<member name="F:AlbumSurfer.PropertiesForm.m_chdr1">
<summary>List View Column Header Object.</summary>
<remarks>This object is used for the listview column that displays the field description.</remarks>
</member>
<member name="F:AlbumSurfer.PropertiesForm.m_chdr2">
<summary>List View Column Header Object.</summary>
<remarks>This object is used for the listview column that displays the field data type.</remarks>
</member>
<member name="F:AlbumSurfer.PropertiesForm.m_chdr3">
<summary>List View Column Header Object.</summary>
<remarks>This object is used for the listview column that displays the field values.</remarks>
</member>
<member name="F:AlbumSurfer.PropertiesForm.m_lvw">
<summary>List View Object.</summary>
<remarks>This is the listview object for displaying property values.</remarks>
</member>
<member name="F:AlbumSurfer.PropertiesForm.components">
<summary>Required designer variable.</summary>
<remarks>This container object is where the forms wizard places all the objects that belong to the form.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.#ctor">
<summary>The constructor for the class</summary>
<remarks>Instantiate and initialize all objects owned by the form and
initalize other variables as needed</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.Dispose(System.Boolean)">
<summary>Destructor for class, clean up any resources being used.</summary>
<remarks>Thus is where the class resources are freed.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.InitializeComponent">
<summary> Required method for Designer support - do not modify the contents of this method with the code editor.</summary>
</member>
<member name="M:AlbumSurfer.PropertiesForm.PropertiesForm_Load(System.Object,System.EventArgs)">
<summary>Handles the Properties Form Load event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Narrative.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.PropertiesForm_Closed(System.Object,System.EventArgs)">
<summary>Handles the Properties Close Form event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>The form is closed, preserve all user modified data for the next time.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.m_lvw_ColumnClick(System.Object,System.Windows.Forms.ColumnClickEventArgs)">
<summary>Handles the m_lvw Column Click event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>Narrative.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.PropretiesShow">
<summary>Properties Show procedure.</summary>
<returns>void.</returns>
<remarks>Given an image, display to the user all its properties.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.SortIndex_Remove_Event(System.Object,System.EventArgs)">
<summary>Handles the Sort Index Remove event.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event arguments.</param>
<returns>void.</returns>
<remarks>When the user wants to sort on another column we must remove the indicator from the last column.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.PropValueGet_str(System.Drawing.Imaging.PropertyItem)">
<summary>Property Value get procedure.</summary>
<param name='propItm'>Reference to property object to get the value from.</param>
<returns>string.</returns>
<remarks>Given a property item return a string representation of its data.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.PropertyGetStr_str(System.Drawing.Imaging.PropertyItem)">
<summary>Property Value get string procedure.</summary>
<param name='propItem'>Reference to property object to get the value from.</param>
<returns>string.</returns>
<remarks>The property item value is a string data type, get its representation.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.PropertyGetS8_str(System.Drawing.Imaging.PropertyItem)">
<summary>Property Value type byte get string value procedure.</summary>
<param name='propItem'>Reference to property object to get the value from.</param>
<returns>string.</returns>
<remarks>The property item value is a byte[s] data type, get its string representation.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.PropertyGetS16_str(System.Drawing.Imaging.PropertyItem)">
<summary>Property Value type short get string value procedure.</summary>
<param name='propItem'>Reference to property object to get the value from.</param>
<returns>string.</returns>
<remarks>The property item value is a short[s] data type, get its string representation.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.PropertyGetS32_str(System.Drawing.Imaging.PropertyItem)">
<summary>Property Value type long get string value procedure.</summary>
<param name='propItem'>Reference to property object to get the value from.</param>
<returns>string.</returns>
<remarks>The property item value is a long[s] data type, get its string representation.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.PropertyGetDtim_str(System.Drawing.Imaging.PropertyItem)">
<summary>Property Value type date time get its string value procedure.</summary>
<param name='propItem'>Reference to property object to get the value from.</param>
<returns>string.</returns>
<remarks>The property item value is a date[s] data type, get its string representation.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.ReadInt32(System.Byte[],System.Int32)">
<summary>Property Value type rational get its string value procedure.</summary>
<param name='au8Data'>Object sending the event.</param>
<param name='s32Offset'>Event arguments.</param>
<returns>Int32.</returns>
<remarks>Narrative.</remarks>
</member>
<member name="M:AlbumSurfer.PropertiesForm.PropertyGetRationals_str(System.Drawing.Imaging.PropertyItem)">
<summary>Handles the ? event.</summary>
<param name='propItem'>Reference to property object to get the value from.</param>
<returns>string.</returns>
<remarks>The property item value is a rational[s] data type, get its string representation.</remarks>
</member>
<member name="T:AlbumSurfer.EXIFIDCodes">
<summary>Image Exif Field Identification Codes.</summary>
<remarks>This is a list of field codes possible in the image property collection. It is a subset of what could be found.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.UnknownCode">
<summary>For other codes</summary>
<remarks>Undefined Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ImageDescription">
<summary>Describes image. Two-byte character code such as Chinese/Korean/Japanese cannot be used.</summary>
<remarks>STR Data Type.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.Manufacturer">
<summary>Manfacturer of digicam. In the Exif standard, this tag is optional, but it is mandatory for DCF.</summary>
<remarks>STR Data Type.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.Model">
<summary>Shows model number of digicam. In the Exif standard, this tag is optional, but it is mandatory for DCF.</summary>
<remarks>STR Data Type.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.Orientation">
<summary>The orientation of the camera relative to the scene, when the image was captured. The relation of the '0th row' and '0th column' to visual position is shown as right.
1 top left side, 2 top right side, 3 bottom right side, 4 bottom left side, 5 left side top, 6 right side top, 7 right side bottom, 8 left side bottom.</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.XResolution">
<summary>Display/Print resolution of image. Default value is 1/72inch, but it has no mean because personal computer doesn't use this value to display/print out.</summary>
<remarks>URational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.YResolution">
<summary>Display/Print resolution of image. Default value is 1/72inch, but it has no mean because personal computer doesn't use this value to display/print out.</summary>
<remarks>URational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ResolutionUnit">
<summary>Unit of XResolution(0x011a)/YResolution(0x011b). '1' means no-unit, '2' means inch, '3' means centimeter. Default value is '2'(inch).</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.Software">
<summary>Shows firmware(internal software of digicam) version number.</summary>
<remarks>STR Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.DateTime">
<summary>Date/Time of image was last modified. Data format is "YYYY:MM:DD HH:MM:SS"+0x00, total 20bytes. If clock has not set or digicam doesn't have clock, the field may be filled with spaces. In usual, it has the same value of DateTimeOriginal(0x9003).</summary>
<remarks>STR[ 20 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.WhitePoint">
<summary>Defines chromaticity of white point of the image. If the image uses CIE Standard Illumination D65(known as international standard of 'daylight'), the values are '3127/10000,3290/10000'.</summary>
<remarks>URational[ 2 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.PrimaryChromaticities">
<summary>Defines chromaticity of the primaries of the image. If the image uses CCIR Recommendation 709 primaries, values are '640/1000,330/1000,300/1000,600/1000,150/1000,0/1000'.</summary>
<remarks>URational[ 6 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.YCbCrCoefficients">
<summary>When image format is YCbCr, this value shows a constant to translate it to RGB format. In usual, values are '0.299/0.587/0.114'.</summary>
<remarks>URational[ 3 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.YCbCrPositioning">
<summary>When image format is YCbCr and uses 'Subsampling'(cropping of chroma data, all the digicam do that), defines the chroma sample point of subsampling pixel array. '1' means the center of pixel array, '2' means the datum point.</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ReferenceBlackWhite">
<summary>Shows reference value of black point/white point. In case of YCbCr format, first 2 show black/white of Y, next 2 are Cb, last 2 are Cr. In case of RGB format, first 2 show black/white of R, next 2 are G, last 2 are B.</summary>
<remarks>URational[ 6 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.Copyright">
<summary>Shows copyright information.</summary>
<remarks>STR Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ExifOffset">
<summary>Offset to Exif Sub IFD</summary>
<remarks>U32[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ExposureTime">
<summary>Exposure time (reciprocal of shutter speed). Unit is second.</summary>
<remarks>URational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.FNumber">
<summary>The actual F-number(F-stop) of lens when the image was taken.</summary>
<remarks>URational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ExposureProgram">
<summary>Exposure program that the camera used when image was taken. '1' means manual control, '2' program normal, '3' aperture priority, '4' shutter priority, '5' program creative (slow program), '6' program action(high-speed program), '7' portrait mode, '8' landscape mode.</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ISOSpeedRatings">
<summary>CCD sensitivity equivalent to Ag-Hr film speed rate.</summary>
<remarks>U16[ 2 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ExifVersion">
<summary>Exif version number. Stored as 4bytes of ASCII character. If the picture is based on Exif V2.1, value is "0210". Since the type is 'undefined', there is no NULL(0x00) for termination.</summary>
<remarks>Undefined[ 4 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.DateTimeOriginal">
<summary>Date/Time of original image taken. This value should not be modified by user program. Data format is "YYYY:MM:DD HH:MM:SS"+0x00, total 20bytes. If clock has not set or digicam doesn't have clock, the field may be filled with spaces. In the Exif standard, this tag is optional, but it is mandatory for DCF.</summary>
<remarks>STR[ 20 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.DateTimeDigitized">
<summary>Date/Time of image digitized. Usually, it contains the same value of DateTimeOriginal(0x9003). Data format is "YYYY:MM:DD HH:MM:SS"+0x00, total 20bytes. If clock has not set or digicam doesn't have clock, the field may be filled with spaces. In the Exif standard, this tag is optional, but it is mandatory for DCF.</summary>
<remarks>STR[ 20 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ComponentsConfiguration">
<summary>Shows the order of pixel data. Most of case '0x04,0x05,0x06,0x00' is used for RGB-format and '0x01,0x02,0x03,0x00' for YCbCr-format. 0x00:does not exist, 0x01:Y, 0x02:Cb, 0x03:Cr, 0x04:Red, 0x05:Green, 0x06:Blue.</summary>
<remarks>Undefined Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.CompressedBitsPerPixel">
<summary>The average compression ratio of JPEG (rough estimate).</summary>
<remarks>URational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ShutterSpeedValue">
<summary>Shutter speed by APEX value. To convert this value to ordinary 'Shutter Speed'; calculate this value's power of 2, then reciprocal. For example, if the ShutterSpeedValue is '4', shutter speed is 1/(24)=1/16 second.</summary>
<remarks>SRational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ApertureValue">
<summary>The actual aperture value of lens when the image was taken. Unit is APEX. To convert this value to ordinary F-number(F-stop), calculate this value's power of root 2 (=1.4142). For example, if the ApertureValue is '5', F-number is Pow(1.4142,5) = F5.6.</summary>
<remarks>URational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.BrightnessValue">
<summary>Brightness of taken subject, unit is APEX. To calculate Exposure(Ev) from BrigtnessValue(Bv), you must add SensitivityValue(Sv). Ev=Bv+Sv Sv=log2(ISOSpeedRating/3.125), ISO100:Sv=5, ISO200:Sv=6, ISO400:Sv=7, ISO125:Sv=5.32.</summary>
<remarks>SRational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ExposureBiasValue">
<summary>Exposure bias(compensation) value of taking picture. Unit is APEX(EV).</summary>
<remarks>SRational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.MaxApertureValue">
<summary>Maximum aperture value of lens. You can convert to F-number by calculating power of root 2 (same process of ApertureValue:0x9202).</summary>
<remarks>URational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.SubjectDistance">
<summary>Distance to focus point, unit is meter.</summary>
<remarks>SRational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.MeteringMode">
<summary>Exposure metering method. '0' means unknown, '1' average, '2' center weighted average, '3' spot, '4' multi-spot, '5' multi-segment, '6' partial, '255' other.</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.LightSource">
<summary>Light source, actually this means white balance setting. '0' means unknown, '1' daylight, '2' fluorescent, '3' tungsten, '10' flash, '17' standard light A, '18' standard light B, '19' standard light C, '20' D55, '21' D65, '22' D75, '255' other.</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.Flash">
<summary>'0' means flash did not fire, '1' flash fired, '5' flash fired but strobe return light not detected, '7' flash fired and strobe return light detected.</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.FocalLength">
<summary>Focal length of lens used to take image. Unit is millimeter.</summary>
<remarks>URational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.MakerNote">
<summary>Maker dependent internal data. Some of maker such as Olympus/Nikon/Sanyo etc. uses IFD format for this area.</summary>
<remarks>Undefined Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.UserComment">
<summary>Stores user comment. This tag allows to use two-byte character code or unicode. First 8 bytes describe the character code. 'JIS' is a Japanese character code (known as Kanji).
'0x41,0x53,0x43,0x49,0x49,0x00,0x00,0x00':ASCII
'0x4a,0x49,0x53,0x00,0x00,0x00,0x00,0x00':JIS
'0x55,0x4e,0x49,0x43,0x4f,0x44,0x45,0x00':Unicode
'0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00':Undefined.</summary>
<remarks>Undefined Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.SubsecTime">
<summary>Some of digicam can take 2~30 pictures per second, but DateTime/DateTimeOriginal/DateTimeDigitized tag can't record the sub-second time. SubsecTime tag is used to record it.
For example, DateTimeOriginal = "1996:09:01 09:15:30", SubSecTimeOriginal = "130", Combined original time is "1996:09:01 09:15:30.130".</summary>
<remarks>STR Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.SubsecTimeOriginal">
<summary>See SubsecTime</summary>
<remarks>STR Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.SubsecTimeDigitized">
<summary>See SubsecTime.</summary>
<remarks>STR Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.FlashPixVersion">
<summary>Stores FlashPix version. If the image data is based on FlashPix formar Ver.1.0, value is "0100". Since the type is 'undefined', there is no NULL(0x00) for termination.</summary>
<remarks>Undefined[ 4 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ColorSpace">
<summary>Defines Color Space. DCF image must use sRGB color space so value is always '1'. If the picture uses the other color space, value is '65535':Uncalibrated.</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ExifImageWidth">
<summary>Size of main image.</summary>
<remarks>U16 or U32[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ExifImageHeight">
<summary>Size of main image.</summary>
<remarks>U16 or U32[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.RelatedSoundFile">
<summary>If this digicam can record audio data with image, shows name of audio data.</summary>
<remarks>STR Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ExifInteroperabilityOffset">
<summary>Extension of "ExifR98", detail is unknown. This value is offset to IFD format data. Currently there are 2 directory entries, first one is Tag0x0001, value is "R98", next is Tag0x0002, value is "0100".</summary>
<remarks>U32[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.FocalPlaneXResolution">
<summary>Pixel density at CCD's position. If you have MegaPixel digicam and take a picture by lower resolution(e.g.VGA mode), this value is re-sampled by picture resolution. In such case, FocalPlaneResolution is not same as CCD's actual resolution.</summary>
<remarks>URational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.FocalPlaneYResolution">
<summary>See FocalPlaneXResolution.</summary>
<remarks>URational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.FocalPlaneResolutionUnit">
<summary>Unit of FocalPlaneXResoluton/FocalPlaneYResolution. '1' means no-unit, '2' inch, '3' centimeter.
Note:Some of Fujifilm's digicam(e.g.FX2700,FX2900,Finepix4700Z/40i etc) uses value '3' so it must be 'centimeter', but it seems that they use a '8.3mm?'(1/3in.?) to their ResolutionUnit. Fuji's BUG? Finepix4900Z has been changed to use value '2' but it doesn't match to actual value also.</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ExposureIndex">
<summary>Same as ISOSpeedRatings(0x8827) but data type is unsigned rational. Only Kodak's digicam uses this tag instead of ISOSpeedRating, I don't know why(historical reason?).</summary>
<remarks>URational[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.SensingMethod">
<summary>Shows type of image sensor unit. '2' means 1 chip color area sensor, most of all digicam use this type.</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.FileSource">
<summary>Indicates the image source. Value '0x03' means the image source is digital still camera.</summary>
<remarks>Undefined[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.SceneType">
<summary>Indicates the type of scene. Value '0x01' means that the image was directly photographed.</summary>
<remarks>Undefined[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.CFAPattern">
<summary>Indicates the Color filter array(CFA) geometric pattern.
Length Type Meaning
2 short Horizontal repeat pixel unit = n
2 short Vertical repeat pixel unit = m
1 byte CFA value[0,0]
1 byte CFA value[n-1,0]
1 byte CFA value[0,1]
1 byte CFA value[n-1,m-1]
The relation of filter color to CFA value is shown below.
Red = 0 Green = 1 Blue = 2 Cyan = 3 Magenta = 4 Yellow = 5 White = 6.</summary>
<remarks>Undefined Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.InteroperabilityIndex">
<summary>If this IFD is main image's IFD and the file content is equivalent to ExifR98 v1.0, the value is "R98". If thumbnail image's, value is "THM".</summary>
<remarks>STR[ 4 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.InteroperabilityVersion">
<summary>Records the interoperability version. "0100" means version 1.00.</summary>
<remarks>Undefined[ 4 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.RelatedImageFileFormat">
<summary>Records the file format of image file. Value is ascii string (e.g. "Exif JPEG Ver. 2.1").</summary>
<remarks>STR Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.RelatedImageWidth">
<summary>Records the image size.</summary>
<remarks>U16 or U32[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.RelatedImageLength">
<summary>Records the image size.</summary>
<remarks>U16 or U32[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ImageWidth">
<summary>Shows size of thumbnail image.</summary>
<remarks>U16 or U32[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.ImageLength">
<summary>Shows size of thumbnail image.</summary>
<remarks>U16 or U32[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.BitsPerSample">
<summary>When image format is no compression, this value shows the number of bits per component for each pixel. Usually this value is '8,8,8'.</summary>
<remarks>U16[ 3 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.Compression">
<summary>Shows compression method. '1' means no compression, '6' means JPEG compression.</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.PhotometricInterpretation">
<summary>Shows the color space of the image data components. '1' means monochrome, '2' means RGB, '6' means YCbCr.</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.StripOffsets">
<summary>When image format is no compression, this value shows offset to image data. In some case image data is striped and this value is plural.</summary>
<remarks>U16 or U32 Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.SamplesPerPixel">
<summary>When image format is no compression, this value shows the number of components stored for each pixel. At color image, this value is '3'.</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.RowsPerStrip">
<summary>When image format is no compression and image has stored as strip, this value shows how many rows stored to each strip. If image has not striped, this value is the same as ImageLength(0x0101).</summary>
<remarks>U16 or U32[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.StripByteConunts">
<summary>When image format is no compression and stored as strip, this value shows how many bytes used for each strip and this value is plural. If image has not stripped, this value is single and means whole data size of image.</summary>
<remarks>U16 or U32 Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.PlanarConfiguration">
<summary>When image format is no compression YCbCr, this value shows byte aligns of YCbCr data. If value is '1', Y/Cb/Cr value is chunky format, contiguous for each subsampling pixel. If value is '2', Y/Cb/Cr value is separated and stored to Y plane/Cb plane/Cr plane format.</summary>
<remarks>U16[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.JpegIFOffset">
<summary>When image format is JPEG, this value show offset to JPEG data stored.</summary>
<remarks>U32[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.JpegIFByteCount">
<summary>When image format is JPEG, this value shows data size of JPEG image.</summary>
<remarks>U32[ 1 ] Data Type and Size.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFIDCodes.YCbCrSubSampling">
<summary>When image format is YCbCr and uses subsampling(cropping of chroma data, all the digicam do that), this value shows how many chroma data subsampled. First value shows horizontal, next value shows vertical subsample rate.</summary>
<remarks>U16[ 2 ] Data Type and Size.</remarks>
</member>
<member name="T:AlbumSurfer.EXIFTypes">
<summary>Image Exif Field Data Type Codes.</summary>
<remarks>This is a list of field codes data types possible in the image property collection.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFTypes.U8">
<summary>Data contains unsigned bytes</summary>
<remarks>An 8-bit unsigned integer.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFTypes.STR">
<summary>Data contains a string</summary>
<remarks>An 8-bit byte containing one 7-bit ASCII code. The final byte is terminated with NULL.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFTypes.U16">
<summary>Data contains unsigned 2-byte values</summary>
<remarks>A 16-bit(2-byte) unsigned integer.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFTypes.U32">
<summary>Data contains unsigned 4-byte values</summary>
<remarks>A 32-bit(4-byte) unsigned integer.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFTypes.URational">
<summary>Data is fractional: each item in the data is 8 bytes long. The first 4 bytes of each item in the data contain the numerator (unsigned int), the second 4 bytes the denominator (also unsigned int).</summary>
<remarks>Two U32s. The first U32 is the numerator and second U32 expresses the denominator.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFTypes.S8">
<summary>Data contains signed bytes </summary>
<remarks>An 8-bit signed byte. Not used in Exif 2.2</remarks>
</member>
<member name="F:AlbumSurfer.EXIFTypes.Undefined">
<summary>Data has arbitrary data type, tag specific</summary>
<remarks>AAn 8-bit byte that can take any value depending on field definition.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFTypes.S16">
<summary>Data contains signed 2-byte values</summary>
<remarks>A 16-bit(2-byte) signed integer. Not used in Exif 2.2.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFTypes.S32">
<summary>Data contains signed 4-byte values</summary>
<remarks>A 32-bit(4-byte) signed integer.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFTypes.SRational">
<summary>Data is fractional: each item in the data is 8 bytes long. The first 4 bytes of each item in the data contain the numerator (signed int), the second 4 bytes the denominator (also signed int).</summary>
<remarks>Two U32s. The first U32 is the numerator and second U32 expresses the denominator.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFTypes.SFP">
<summary>Data contains 4-byte floating point values</summary>
<remarks>Single Floating Point. Not used in Exif 2.2.</remarks>
</member>
<member name="F:AlbumSurfer.EXIFTypes.DFP">
<summary>Data contains 8-byte floating point values</summary>
<remarks>Double Floating Point. Not used in Exif 2.2.</remarks>
</member>
<member name="T:AlbumSurfer.ListViewItemComparer">
<summary>Listview Item Comparer Class.</summary>
<remarks>This class manages the sorting behavior of the items in the listview.</remarks>
</member>
<member name="F:AlbumSurfer.ListViewItemComparer.SortingFlagLength">
<summary>Constant value indicating the length of the sorting flag string.</summary>
<remarks>The sorting direction string is 2 characters big.</remarks>
</member>
<member name="F:AlbumSurfer.ListViewItemComparer.m_s32ColIX">
<summary>Storage variable for the column index of active column.</summary>
<remarks>.</remarks>
</member>
<member name="F:AlbumSurfer.ListViewItemComparer.m_sortOrder">
<summary>Storage variable for the active sort order.</summary>
<remarks>.</remarks>
</member>
<member name="M:AlbumSurfer.ListViewItemComparer.SortByColumn(System.Int32)">
<summary>Procedure that handles click of columns and manages sort order.</summary>
<param name='s32ColIX'>Column Index.</param>
<returns>int.</returns>
<remarks>Narrative.</remarks>
</member>
<member name="M:AlbumSurfer.ListViewItemComparer.Compare(System.Object,System.Object)">
<summary>Listview Item Compare Procedure.</summary>
<param name='litm1'>First object for comparison.</param>
<param name='litm2'>Second object for comparison.</param>
<returns>int.</returns>
<remarks>Returns whether the first or second object should come first, depending on sort order.</remarks>
</member>
<member name="E:AlbumSurfer.ListViewItemComparer.SortIndex_Remove">
<summary>Event Handler for removing the sorting flag when the sorting columns change.</summary>
<remarks>.</remarks>
</member>
<member name="P:AlbumSurfer.ListViewItemComparer.ColumnActivelySortingIX">
<summary>Class Property that returns active sort column index.</summary>
<remarks>.</remarks>
</member>
<member name="P:AlbumSurfer.ListViewItemComparer.SortingFlag_str">
<summary>Class Property that returns string indicating direction of sort.</summary>
<remarks>.</remarks>
</member>
<member name="T:AlbumSurfer.E_REGISTRY_HIVES">
<summary>Enum group for Registry Hives.</summary>
<remarks>CLASSES_ROOT and USERS are not included in the Hive options of this class.</remarks>
</member>
<member name="F:AlbumSurfer.E_REGISTRY_HIVES.CURRENT_USER">
<summary>Current User Registry Hive.</summary>
</member>
<member name="F:AlbumSurfer.E_REGISTRY_HIVES.LOCAL_MACHINE">
<summary>Local Machine Registry Hive (default).</summary>
</member>
<member name="T:AlbumSurfer.RegistryClass">
<summary>Class for the storage and retrieval of persistent application values to the Registry.</summary>
<remarks>This class if a wrapper for the standard dotNet interface to the Registry. It permits
the invocation of the registry with some very simple calls. It defaults, unless overridden by the user
the registry path to values obtained from the Application Assembly in the form of
<para> REGISTRY_HIVE "SOFTWARE/Application.CompanyName/Application.ProductName/CONFIG".</para></remarks>
</member>
<member name="F:AlbumSurfer.RegistryClass.m_lngHiveID">
<summary>Class storage location for selected Registry HiveID.</summary>
<remarks>When access to read or write any value is initiated this is the registry Hive to access.</remarks>
</member>
<member name="F:AlbumSurfer.RegistryClass.m_strRoot">
<summary>Class storage location for selected Registry Root string.</summary>
<remarks>Defaulted to "Software". The full registry key path is constructed of "Root/Shop/AppName/Section".</remarks>
</member>
<member name="F:AlbumSurfer.RegistryClass.m_strShop">
<summary>Class storage location for selected Registry Shop string.</summary>
<remarks>Defaulted to App.CompanyName. The full registry key path is constructed of "Root/Shop/AppName/Section".</remarks>
</member>
<member name="F:AlbumSurfer.RegistryClass.m_strAppName">
<summary>Class storage location for selected Registry Application string.</summary>
<remarks>Defaulted to App.ProductName;. The full registry key path is constructed of "Root/Shop/AppName/Section".</remarks>
</member>
<member name="F:AlbumSurfer.RegistryClass.m_strSection">
<summary>Class storage location for selected Registry Section string.</summary>
<remarks>Defaulted to "Config". The full registry key path is constructed of "Root/Shop/AppName/Section".</remarks>
</member>
<member name="F:AlbumSurfer.RegistryClass.m_strFullPath">
<summary>Class storage location for the selected full Registry Key path string.</summary>
<remarks>The full registry key path is constructed of "Root/Shop/AppName/Section".</remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.#ctor">
<overloads>This method has three overloads.</overloads>
<summary>Constructor invoking a registry path using all defaults.</summary>
<remarks>The registry key path is in the form of "Software/CompanyName/AppName/Section". This
invocation takes all these defaults.</remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.#ctor(System.String)">
<summary>Constructor with Application Name option.</summary>
<param name='strAppName'>Application Name string to be used for registry key path.</param>
<remarks>The registry key path is in the form of "Software/CompanyName/AppName/Section". This
invocation takes all the defaults but the Application Name.</remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.#ctor(System.String,System.String)">
<summary>Constructor with Application Name and Section option.</summary>
<param name='strAppName'>Application Name string to be used for registry key path.</param>
<param name='strSection'>Section Name string to be used for registry key path.</param>
<remarks>The registry key path is in the form of "Software/CompanyName/AppName/Section". This
invocation takes all the defaults but the Application Name and Section.</remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.RegValGet_obj(System.String,System.Object)">
<summary>Private procedure to get a value from the registry.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='objValDefault'>Default object if key does not exist.</param>
<returns>object.</returns>
<remarks>The dot net interface to the registry uses the object type as the
data type qualifier. This routine is called by each of the data types.</remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.RegValSet(System.String,System.Object)">
<summary>Private procedure to write a value to the registry.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='objValDefault'>Value to store.</param>
<returns>void.</returns>
<remarks>The dot net interface to the registry uses the object type as the
data type qualifier. This routine is called by each of the write data types.</remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.LongGet_lng(System.String,System.Object)">
<summary>Returns a long value, or the default if none exists, from the registry key referenced.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='pobjDefault'>Reference to a default object if no registry value exists.</param>
<returns>Int32.
<para> If no value exists and the pobjDefault is null, returns null.</para></returns>
<remarks>This procedure returns a long data value from the registry at the key referenced.
<para>Long is actually a misnomer, in .NET a long is an Int64 and if you present that to
the Net Registry utilities as a value it knows it will not fit in a Int32(DW),
hence it promotes it to a string to prevent a loss of data.</para>
</remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.StringGet_str(System.String,System.String)">
<summary>Returns a string value, or the default if none exists, from the registry key referenced.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='pstrDefault'>Reference to a default object if no registry value exists.</param>
<returns>string.
<para> If no value exists and the pstrDefault is null, returns null.</para></returns>
<remarks>This procedure returns a string from the registry at the key referenced.</remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.BinaryGet_arr(System.String,System.Array)">
<summary>Returns a byte array value, or the default if none exists, from the registry key referenced.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='pabytDefault'>Reference to a default object if no registry value exists.</param>
<returns>byte[]
<para>If no value exists and the pabytDefault is null, returns null.</para></returns>
<remarks>This procedure returns a byte array of data from the registry at the key referenced.</remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.LongSet(System.String,System.Object)">
<summary>Writes a long value to the registry key referenced.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='pobjValue'>Reference to object value to be written.</param>
<returns>void.</returns>
<remarks>This procedure stores a long (UInt32) in the registry at the key referenced.
<para>Long is actually a misnomer, in .NET a long is an Int64 and if you present
that to the Net Registry utilities as a value it knows it will not fit
in a Int32(DW), hence it promotes it to a string to prevent a loss of data.</para>
<para>If the registry key does not exist it is created.</para></remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.StringSet(System.String,System.String)">
<summary>Writes a string value to the registry key referenced.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='pstrValue'>Reference to object value to be written.</param>
<returns>void.</returns>
<remarks>This procedure stores a string in the registry at the key referenced.
<para>If the registry key does not exist it is created.</para></remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.BinarySet(System.String,System.Array)">
<summary>Writes a byte array value to the registry key referenced.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='pabytVal'>Reference to object value to be written.</param>
<returns>void.</returns>
<remarks>This procedure stores a byte array of data in the registry at the key referenced.
<para>If the registry key does not exist it is created.</para></remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.DeleteKey(System.String)">
<summary>Deletes a registry key value.</summary>
<param name='pstrKey'>Reference to key string.</param>
<returns>void.</returns>
<remarks>This procedure results in a registry key being deleted.</remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.DeleteValue(System.String)">
<summary>Deletes a registry key value.</summary>
<param name='pstrKey'>Reference to key string.</param>
<returns>void.</returns>
<remarks>This procedure results in a value at the registry key location to become undefined.</remarks>
</member>
<member name="M:AlbumSurfer.RegistryClass.MakeFullPath">
<summary>Contructs a full registry key path string from the parts the user defined.</summary>
<returns>void.</returns>
<remarks>The full registry path string is constructed from "Software/CompanyName/AppName/Section".
<para> If the user defines any one of the individual parts to be null it is left out of the string.</para>
</remarks>
</member>
<member name="P:AlbumSurfer.RegistryClass.strApp">
<summary>App portion of the registry key path.</summary>
<value>string.</value>
<remarks>The full registry path string is constructed from "Software/CompanyName/AppName/Section". strApp is the AppName portion.</remarks>
</member>
<member name="P:AlbumSurfer.RegistryClass.strRoot">
<summary>Root portion of the registry key path.</summary>
<value>string.</value>
<remarks>The full registry path string is constructed from "Software/CompanyName/AppName/Section". strRoot is the Software portion.</remarks>
</member>
<member name="P:AlbumSurfer.RegistryClass.strSection">
<summary>Section portion of the registry key path.</summary>
<value>string.</value>
<remarks>The full registry path string is constructed from "Software/CompanyName/AppName/Section". strSection is the Section portion.</remarks>
</member>
<member name="P:AlbumSurfer.RegistryClass.strShop">
<summary>Shop portion of the registry key path.</summary>
<value>string.</value>
<remarks>The full registry path string is constructed from "Software/CompanyName/AppName/Section". strShop is the CompanyName portion.</remarks>
</member>
<member name="P:AlbumSurfer.RegistryClass.HiveID">
<summary>Hive portion of the registry key path.</summary>
<value>Registry Hive enum.</value>
<remarks>The Registry Hive that is accessed when a read or write is requested.</remarks>
</member>
<member name="T:AlbumSurfer.RegXmlClass">
<summary> Class for the storage and retrieval of Application persistent data values to a local XML data file.</summary>
<remarks> This module is meant to be a transparent substitute for the Registry Class
and provides all the function calls that module provided. This difference is that
this module stores the persistent data in a local XML file instead of the registry.</remarks>
</member>
<member name="F:AlbumSurfer.RegXmlClass.STR_TBL_NAME">
<summary>Default XML dataset table name.</summary>
<remarks>The table name defaults to "tblValues".</remarks>
</member>
<member name="F:AlbumSurfer.RegXmlClass.m_strPathFile">
<summary>Class storage location for XML data path file string.</summary>
<remarks>This is the location of the XML file.</remarks>
</member>
<member name="F:AlbumSurfer.RegXmlClass.m_dset">
<summary>Class storage of the dataset that represents the stored data in the XML file.</summary>
<remarks>This dataset get loaded at initialization time and saved with every write of the class.</remarks>
</member>
<member name="F:AlbumSurfer.RegXmlClass.m_strRoot">
<summary>Class storage location for selected Registry Root string.</summary>
<remarks>Provided to maintain compatibility with the Registry version of the class.</remarks>
</member>
<member name="F:AlbumSurfer.RegXmlClass.m_strShop">
<summary>Class storage location for selected Registry Shop string.</summary>
<remarks>Provided to maintain compatibility with the Registry version of the class.</remarks>
</member>
<member name="F:AlbumSurfer.RegXmlClass.m_strAppName">
<summary>Class storage location for selected Registry Application string.</summary>
<remarks>Provided to maintain compatibility with the Registry version of the class.</remarks>
</member>
<member name="F:AlbumSurfer.RegXmlClass.m_strSection">
<summary>Class storage location for selected Registry Section string.</summary>
<remarks>Provided to maintain compatibility with the Registry version of the class.</remarks>
</member>
<member name="F:AlbumSurfer.RegXmlClass.m_strXmlFilename">
<summary>Class storage location for the XML filename string.</summary>
<remarks>This defaults to "AppConfig.xml".</remarks>
</member>
<member name="M:AlbumSurfer.RegXmlClass.#ctor">
<overloads>This method has three overloads.</overloads>
<summary>Constructor to maintain compatibility with the Registry version.</summary>
<remarks>In the registry registry version this invocation takes all the defaults.</remarks>
</member>
<member name="M:AlbumSurfer.RegXmlClass.#ctor(System.String)">
<summary>Constructor to maintain compatibility with the Registry version.</summary>
<param name='strAppName'>Application Name string to be used for registry key path.</param>
<remarks>In the registry registry version this invocation provides for a Application Name argument.</remarks>
</member>
<member name="M:AlbumSurfer.RegXmlClass.#ctor(System.String,System.String)">
<summary>Constructor to maintain compatibility with the Registry version.</summary>
<param name='strAppName'>Application Name string to be used for registry key path.</param>
<param name='strSection'>Section Name string to be used for registry key path.</param>
<remarks>In the registry registry version this invocation provides for two arguments.</remarks>
</member>
<member name="M:AlbumSurfer.RegXmlClass.LongGet_lng(System.String,System.Object)">
<summary>Returns a long value, or the default if none exists, from the persistent storage.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='pobjDefault'>Reference to a default object if no registry value exists.</param>
<returns>Int32.
<para> If no value exists and the pobjDefault is null, returns null.</para></returns>
<remarks>This procedure returns a long data value from the registry at the key referenced.
<para>Long is actually a misnomer, in .NET a long is an Int64 and if you present that to
the Net Registry utilities as a value it knows it will not fit in a Int32(DW),
hence it promotes it to a string to prevent a loss of data.</para>
</remarks>
</member>
<member name="M:AlbumSurfer.RegXmlClass.StringGet_str(System.String,System.String)">
<summary>Returns a string value, or the default if none exists, from the persistent storage.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='pstrDefault'>Reference to a default object if no registry value exists.</param>
<returns>string.
<para> If no value exists and the pstrDefault is null, returns null.</para></returns>
<remarks>This procedure returns a string from the registry at the key referenced.</remarks>
</member>
<member name="M:AlbumSurfer.RegXmlClass.BinaryGet_arr(System.String,System.Byte[])">
<summary>Returns a byte array value, or the default if none exists, from the persistent storage.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='pau8Default'>Reference to a default object if no registry value exists.</param>
<returns>byte[].
<para>If no value exists and the pabytDefault is null, returns null.</para></returns>
<remarks>This procedure returns a byte array of data from the registry at the key referenced.</remarks>
</member>
<member name="M:AlbumSurfer.RegXmlClass.LongSet(System.String,System.Object)">
<summary>Writes a long value to the registry key referenced.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='pobjValue'>Reference to object value to be written.</param>
<returns>void.</returns>
<remarks>This procedure stores a long (UInt32) in the registry at the key referenced.
<para>Long is actually a misnomer, in .NET a long is an Int64 and if you present
that to the Net Registry utilities as a value it knows it will not fit
in a Int32(DW), hence it promotes it to a string to prevent a loss of data.</para>
<para>If the registry key does not exist it is created.</para></remarks>
</member>
<member name="M:AlbumSurfer.RegXmlClass.StringSet(System.String,System.String)">
<summary>Writes a string value to the registry key referenced.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='pstrValue'>Reference to object value to be written.</param>
<returns>void.</returns>
<remarks>This procedure stores a string in the registry at the key referenced.
<para>If the registry key does not exist it is created.</para></remarks>
</member>
<member name="M:AlbumSurfer.RegXmlClass.BinarySet(System.String,System.Byte[])">
<summary>Writes a byte array value to the registry key referenced.</summary>
<param name='pstrKey'>Reference to key string.</param>
<param name='pau8Val'>Reference to object value to be written.</param>
<returns>void.</returns>
<remarks>This procedure stores a byte array of data in the registry at the key referenced.
<para>If the registry key does not exist it is created.</para></remarks>
</member>
<member name="M:AlbumSurfer.RegXmlClass.DeleteKey(System.String)">
<summary>To handle the ? message reply construction.</summary>
<param name='pstrKey'>Arg1Purpose.</param>
<returns>void.</returns>
<remarks>Provided to maintain compatibility with the Registry version of the class.</remarks>
</member>
<member name="M:AlbumSurfer.RegXmlClass.DeleteValue(System.String)">
<summary>Deletes a registry key value.</summary>
<param name='pstrKey'>Reference to key string.</param>
<returns>void.</returns>
<remarks>Provided to maintain compatibility with the Registry version of the class.</remarks>
</member>
<member name="M:AlbumSurfer.RegXmlClass.DoesDBExist">
<summary>Loads the XML data file if it exists.</summary>
<returns>void.</returns>
<remarks>If the XML data file exists this routine loads the XML dataset with its contents</remarks>
</member>
<member name="P:AlbumSurfer.RegXmlClass.strApp">
<summary>App portion of the registry key path.</summary>
<value>string.</value>
<remarks>Provided to maintain compatibility with the Registry version of the class.</remarks>
</member>
<member name="P:AlbumSurfer.RegXmlClass.strRoot">
<summary>Root portion of the registry key path.</summary>
<value>string.</value>
<remarks>Provided to maintain compatibility with the Registry version of the class.</remarks>
</member>
<member name="P:AlbumSurfer.RegXmlClass.strSection">
<summary>Section portion of the registry key path.</summary>
<value>string.</value>
<remarks>Provided to maintain compatibility with the Registry version of the class.</remarks>
</member>
<member name="P:AlbumSurfer.RegXmlClass.strShop">
<summary>Shop portion of the registry key path.</summary>
<value>string.</value>
<remarks>Provided to maintain compatibility with the Registry version of the class.</remarks>
</member>
<member name="P:AlbumSurfer.RegXmlClass.strFilename">
<summary>XML filename use for data storage.</summary>
<value>string.</value>
<remarks>This file contains the persistence data storage XML dataset.</remarks>
</member>
<member name="T:AlbumSurfer.E_SPLASH_STATE">
<summary>Enum that describes the opacity state of the splash window.</summary>
</member>
<member name="F:AlbumSurfer.E_SPLASH_STATE.BECOMING_OPAQUE">
<summary>Its in the process of becoming opaque.</summary>
</member>
<member name="F:AlbumSurfer.E_SPLASH_STATE.SHOWING">
<summary>Its opaque and is waiting to go away.</summary>
</member>
<member name="F:AlbumSurfer.E_SPLASH_STATE.BECOMING_TRANSPARENT">
<summary>Its fading away.</summary>
</member>
<member name="F:AlbumSurfer.E_SPLASH_STATE.DONE">
<summary>Its the mode that waits for a click or parent GoAway to disappear.</summary>
</member>
<member name="F:AlbumSurfer.E_SPLASH_STATE.OPAQUE">
<summary>Its was in STAY mode and became fully opaque.</summary>
</member>
<member name="F:AlbumSurfer.E_SPLASH_STATE.CLOSED">
<summary>Its disappeared and deallocated.</summary>
</member>
<member name="T:AlbumSurfer.E_SPLASH_MODE">
<summary>Enum that configures the splash window display mode.</summary>
</member>
<member name="F:AlbumSurfer.E_SPLASH_MODE.STAY">
<summary>To make it disappear the parent either closes or the user clicks.</summary>
</member>
<member name="F:AlbumSurfer.E_SPLASH_MODE.GOAWAY">
<summary>After a few seconds it just fades away.</summary>
</member>
<member name="T:AlbumSurfer.SplashForm">
<summary>Definition of Splash Form.</summary>
<remarks> A typical invocation of this module would do the following:
<code>
static void Main()
{
g_reg = new RegistryClass( );
// get the last window placement and size from persistent storage
g_strWinPlacement = g_reg.StringGet_str( "MainWinDetails", "10,10,331,262" );
SplashForm.ShowIt( true, E_SPLASH_MODE.STAY, g_strWinPlacement );
Application.DoEvents(); // this must be here to allow the splash thread to do its init
SplashForm.SetStatus("Loading module 1", 10 );
System.Threading.Thread.Sleep( 500 );
SplashForm.SetStatus("Loading module 2", 30 );
System.Threading.Thread.Sleep( 300 );
SplashForm.SetStatus("Loading module 3", 60 );
frmMain = new MainForm();
Application.Run( frmMain );
}</code>
If the form is not set to GOAWAY then somewhere a CloseForm is invoked.
<code>
SplashForm.GoAway();</code>
</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.INCREMENT">
<summary>Up increment for timer opacity changes.</summary>
<remarks>The Splash form appears more slowly than it disappears. ( .05 ).</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.DECREMENT">
<summary>Down increment for timer opacity changes.</summary>
<remarks>The Splash form disappears more quickly than it appears. ( .08 ).</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.TIMER_INTERVAL">
<summary>The value of the interval used for the form timer, milliseconds between timer ticks.</summary>
<remarks>The timer interval is 56 milliseconds of 1 / 18 of a second. This is the minimum resolution of the timer.</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.ms_frmSplash">
<summary>Instantiation reference of SplashForm.</summary>
<remarks>Mechanism to access instantiation from other static functions.</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.ms_thrdSplash">
<summary>Instantiation reference of Splash Form thread object.</summary>
<remarks>.</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.ms_eMode">
<summary>Determines whether splash form remains until the user clicks it, parent window closes it, or fades away.</summary>
<remarks>Enum storage location for Splash form mode.</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.ms_strWinPlacement">
<summary>"Top,Left,Width,Height" string obtained from persistence storage used to center Splash window over parent.</summary>
<remarks>If value is an empty string then the Splash window is centered on the screen.</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.ms_ynPercentBar">
<summary>A Boolean that indicates whether the instantiated Splash window should display a progress bar.</summary>
<remarks>If false no progress bar is displayed.</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.m_strAppPath">
<summary>The directory path to where our application was started. It locates application data and bitmaps.</summary>
<remarks>When in the development mode this directory path points to the source code to find data files.</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.m_eState">
<summary>The opacity state the form is in. Used in enabling operations.</summary>
<remarks>When a timer tick event occurs the procedure needs to know what to do next and it does this
by knowing the present state it is and what mode we are in.</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.m_s32ShowTime">
<summary>The amount of time in timer intervals to show opaque from if mode is GOAWAY.</summary>
<remarks>The timer runs on 56 millisecond intervals, 18 = 1 second. This is a count of timer
intervals for the fully opaque form to show before it starts to disappear if the mode is GOAWAY ( 5 * 18 ).</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.m_lblStatus">
<summary>Form label for displaying the latest status.</summary>
<remarks>A Form label object for displaying the status the user has requested to be shown.</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.m_timer1">
<summary>Forms Timer for causing opacity modifications and show interval counting.</summary>
<remarks>the tick event of this timer is used in conjunction with the form Mode and State to determine
what to do next. A tick event can cause the from to become more or less transparent or be used to determine
how long it will show in the full opaque mode.</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.m_lblProductVersion">
<summary>Form label for displaying the Product Version.</summary>
<remarks>Value obtained from the Application object "Version" property which itself comes from the Assembly "Version" attribute.</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.m_pic1">
<summary>A Form PictureBox object for displaying our Company logo bitmap.</summary>
<remarks>In an effort to make the company logo work like an icon we copy from the source bitmap to the
PictureBox replacing all white pixels with the controls background pixel. (Wa La transparency).</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.m_lblCompanyName">
<summary>Form label for displaying the Company Name.</summary>
<remarks>Value obtained from the Application object "CompanyName" property which itself comes from the Assembly "Company" attribute.
<para>In the first version of this module the timer was stopped if it was a "STAY" mode but when it is Stopped ( disabled )
it is a candidate for garbage collection, and if there is a long interval, it goes away. Now we just keep it running and ignore
the ticks in the "STAY" mode.</para></remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.m_pbar1">
<summary>Form progress bar available to user for completion display.</summary>
<remarks>Progress bar percentage ranges between 0 and 100.</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.m_lblAssemblyTitle">
<summary>Form label for displaying the Assembly Title.</summary>
<remarks>Value obtained from the Assembly "Title" attribute.</remarks>
</member>
<member name="F:AlbumSurfer.SplashForm.components">
<summary>Component container for all the forms m_components.</summary>
<remarks>.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.#ctor">
<summary>Constructor.</summary>
<remarks>Instantiates all objects defined on the form and initializes them. Set the timer interval and start it.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.Dispose(System.Boolean)">
<summary>Form Destructor.</summary>
<remarks>Disposes of all objects owned by the form.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.InitializeComponent">
<summary>
Required method for Designer support - do not modify
the contents of this method with the code editor.
</summary>
</member>
<member name="M:AlbumSurfer.SplashForm.RunSplash">
<summary>Method for the thread to execute on</summary>
<returns>void</returns>
<remarks>Instantiates a new SplashForm and attaches it to the application.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.ShowIt">
<summary>A static method to use defaults and show the SplashForm.</summary>
<returns>void</returns>
<remarks>Window placement is on center of screen, mode is GOAWAY and no progress bar.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.ShowIt(System.Boolean)">
<summary>A static method to select progress bar visibility and show the SplashForm.</summary>
<param name='ynPercentBar'>Visibility of progress bar.</param>
<returns>void</returns>
<remarks>Window placement is on center of screen, mode is GOAWAY.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.ShowIt(System.Boolean,AlbumSurfer.E_SPLASH_MODE)">
<summary>A static method to select progress bar visibility, display mode and show the SplashForm.</summary>
<param name='ynPercentBar'>Visibility of progress bar.</param>
<param name='emode'>Display mode option.</param>
<returns>void</returns>
<remarks>Window placement is on center of screen.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.ShowIt(System.Boolean,AlbumSurfer.E_SPLASH_MODE,System.String)">
<summary>A static method to select progress bar visibility, display mode, window placement, and show the SplashForm.</summary>
<param name='ynPercentBar'>Visibility of progress bar.</param>
<param name='emode'>Display mode option.</param>
<param name='strWinPlacement'>Window placement string "Top,Left,Width,Height".</param>
<returns>void</returns>
<remarks>User selects progress bar visibility, display mode and window placement.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.SplashThreadStart">
<summary>A static method to create the thread and start it.</summary>
<returns>void.</returns>
<remarks>Creates and spawns a new thread for the Splash form and its timer to run.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.GoAway">
<summary>A static method to make the SplashForm go away.</summary>
<returns>void.</returns>
<remarks>A procedure which initiates a disappearing sequence for the Splash form. Generally this only needs
to be called if the form was instantiated in the "STAY" mode. </remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.m_timer1_Tick(System.Object,System.EventArgs)">
<summary>Handle the timer tick event.</summary>
<param name='sender'>Timer object sending the event.</param>
<param name='e'>Timer Tick Event arguments.</param>
<returns>void.</returns>
<remarks>On a timer tick we use the state indicator to determine whether
we are becoming opaque, becoming transparent, or showing for a predetermined
period of time. If our mode is GOAWAY then after the showing interval has ended
we set the state to becoming transparent to disappear and exit.
<para>If the form is defined as a GOAWAY form then the sequence the timer will got through is</para>
<para>BECOMING_OPAQUE -- SHOWING(ShowTime) -- BECOMING_TRANSPARENT</para>
<para>If the form is defined as a STAY form then the sequence is</para>
<para>BECOMING_OPAQUE -- OPAQUE( until a GoAway request ) -- BECOMING_TRANSPARENT</para>
</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.SetStatus(System.String)">
<summary> A static method to set the status string.</summary>
<param name='strStatus'>Status string to be displayed to the user.</param>
<returns>void.</returns>
<remarks>Procedure to change the status string displayed to the user.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.SetStatus(System.String,System.Int32)">
<summary>A static method to set the status and to update the progress bar.</summary>
<param name='strStatus'>Status string to be displayed to the user.</param>
<param name='s32Percent'>Int32 value ranging between 0 and 100 to be displayed by progress bar.</param>
<returns>void.</returns>
<remarks>Procedure to change the status string displayed to the user and to update the progress
bar percentage.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.SetPercent(System.Int32)">
<summary>A static method to update the progress bar output.</summary>
<param name='s32Percent'>Int32 value ranging between 0 and 100.</param>
<returns>void.</returns>
<remarks>Procedure to update the progress bar percentage.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.SplashForm_Load(System.Object,System.EventArgs)">
<summary>Handles the form load event.</summary>
<param name='sender'>Form object sending the event.</param>
<param name='e'>Event arguments for a form load.</param>
<returns>void.</returns>
<remarks>This procedure attempts to center the splash form over top its
parent window, the thing is it can be called before the parent window
is instantiated therefore we provide the Window Placement string and
perform the calculations for its screen placement. If the Window Placement
string supplied is empty we use the form's center on screen default option.
</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.SetPercentageOnForm(System.Int32)">
<summary>Form context procedure to adjust the percentage of the progress bar.</summary>
<param name='s32Percent'>Int32 value to range between 0 and 100.</param>
<returns>void.</returns>
<remarks>This procedure passes the percentage value to the progress bar object.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.SetStatusOnForm(System.String)">
<summary>Procedure to effect a status string change.</summary>
<returns>void.</returns>
<remarks>Form context procedure to update the status label string.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.AssemblyInfoGet">
<summary>Procedure to obtain information from the assembly attributes
which is not part of the Application object.</summary>
<returns>void.</returns>
<remarks>The Application object provides us with most of the assembly data, but not all
of it. This procedure adjusts the start up directory to be the source directory regardless
of whether we were in release or debug mode, so that data files local to the application
can be found.
<para>The Assembly Title string is also obtained for our window top label.</para>
</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.SplashForm_Click(System.Object,System.EventArgs)">
<summary>Handles effectively any click on the Splash form.</summary>
<param name='sender'>Object sending the event.</param>
<param name='e'>Event Argument Object.</param>
<returns>void.</returns>
<remarks>All objects on the Splash form have their click event come
here, that provides a mechanism to start a disappearing act if the
window is defined in the STAY mode. The click to disappear will no work
until the form has become completely opaque.</remarks>
</member>
<member name="M:AlbumSurfer.SplashForm.m_pic1_Paint(System.Object,System.Windows.Forms.PaintEventArgs)">
<summary>Handles the m_pic1 paint event.</summary>
<param name='sender'>The picture box object sending the event.</param>
<param name='ePaintArgs'>Paint Arguments Object.</param>
<returns>void.</returns>
<remarks>When a Invalidation or exposure event occurs this procedure is
called to repaint the supplier bitmap. This procedure walks through the
complete bitmap looking for white pixels and replacing them with the
control background pixels. This effective makes WHITE the transparency
color.</remarks>
</member>
<member name="P:AlbumSurfer.SplashForm.frmSplash">
<summary>A static method to obtain the SplashForm instantiation reference.</summary>
</member>
</members>
</doc>
Submit an article or tip