Workbook.CheckIn Method

  • Article
Excel Developer Reference

Returns a workbook from a local computer to a server, and sets the local workbook to read-only so that it cannot be edited locally. Calling this method will also close the workbook.

Syntax

expression.CheckIn(SaveChanges, Comments, MakePublic)

expression   A variable that represents a Workbook object.

Parameters

Name Required/Optional Data Type Description
SaveChanges Optional Variant True saves changes and checks in the document. False returns the document to a checked-in status without saving revision.
Comments Optional Variant Allows the user to enter check-in comments for the revision of the workbook being checked in (applies only if SaveChanges equals True).
MakePublic Optional Variant True allows the user to publish the workbook after it has been checked in. This submits the workbook for the approval process, which can eventually result in a version of the workbook being published to users with read-only rights to the workbook (applies only if SaveChanges equals True).

Example

This example checks the server to see if the specified workbook can be checked in. If it can, the code saves and closes the workbook and checks it back in to the server.

Visual Basic for Applications 
  Sub CheckInOut(strWkbCheckIn As String)

' Determine if workbook can be checked in.
If Workbooks(strWkbCheckIn).CanCheckIn = True Then
    Workbooks(strWkbCheckIn).<strong>CheckIn</strong>
    MsgBox strWkbCheckIn &amp; " has been checked in."
Else
    MsgBox "This file cannot be checked in " &amp; _
        "at this time.  Please try again later."
End If



End Sub

See Also